godocの代わりに`go doc`を推奨された件について
|
godocはGoの各プログラムのドキュメントをGUIとCLI上で展開してくれるパッケージだったのですが、使用してみたところ下記のようなメッセージが表示されました。
godoc -http=localhost:6060 fmt
Unexpected arguments. Use "go doc" for command-line help output instead. For example, "go doc fmt.Printf".godocのCLIモードはサポート終了
調べてみたところバージョン1.12からCLIのサポートは終了、代わりにgo docを使って欲しいと言及されていました。
I propose we delete x/tools/cmd/godoc’s CLI support and keep it being a web-only tool. Users who want CLI support can use “go doc”. Both are shipped with Go releases.
https://github.com/golang/go/issues/25443
godocのバリデーションが多く、ドキュメントの整理が大変なのが理由のようです。
そして最終的に、godocのCLIモードは1.11でサポート終了となりました。
Decision: we’ll document in the Go 1.11 release notes that the Go 1.11 release will be the last to support CLI mode
https://github.com/golang/go/issues/25443godoc(no space). In Go 1.12, users (and any IDEs?) will need to usego docfor the CLI mode.
まとめ
バージョン1.11がベースになっている参考書などはgodocになっている場合があるかも知れませんが、CLIでのサポートは終了したので、ターミナルではgo docを使います。
GUIでのサポートは継続しているので、ブラウザなどでパッケージの詳細を調べたいときはgodocが使えます。