go - 记录 Golang 程序的惯用方式，由一个 main.go 文件组成

Question

我编写了一个 Go 工具，它可以读取文件并根据输入生成输出。它由一个 main.go 文件组成。为了使用 godoc（或者只是习惯用法），我在哪里记录该工具的功能？

// Should I explain it here?
package main

// Or here?
func main() {
    // code!
}

// Or somewhere else?

Answer 1

要记录 godoc 或 pkg.go.dev 的命令，请在包注释中编写命令文档。

// Command foo does bar.
package main

func main() {
   // code!
}

有关示例，请参见stringer.go 中的注释和stringer 文档。

默认情况下，godoc 和 pkg.go.dev 将所有其他文档注释隐藏在名为“main”的包中。