ゴードック



GoDocを使用して開発者がドキュメントを生成するヘルプ
参考文献https://golang.org/doc/effective_go
GoDocの生成はかなり簡単です.開発者は、パッケージの前にファイルの上にコメントを入れてから、自動的にDOCが生成されます.

コメント-ブロックコメント、およびラインコメントの2種類があります
1 .ブロックコメント/* */コメントのいくつかの行について
/*
Package regexp implements a simple library for regular expressions.

The syntax of the regular expressions accepted is:

    regexp:
        concatenation { '|' concatenation }
    concatenation:
        { closure }
    closure:
        term [ '*' | '+' | '?' ]
    term:
        '^'
        '$'
        '.'
        character
        '[' [ '^' ] character-ranges ']'
        '(' regexp ')'
*/
package regexp
簡単なコメントのためにラインコメント//の使用
// Package path implements utility routines for
// manipulating slash-separated filename paths.
マルチファイルパッケージでは、パッケージコメントは1つのファイルに存在する必要があります.

何がコメントにあるべきですか?
  • パッケージ導入
  • としての
  • パッケージ説明
    それ以外の機能、インターフェイスまたはタイプなどの上にコメントを追加することができます

    ローカルでGoDocを見る方法
    パッケージへのA . CD
    go doc
    
    これは端末のdoc
    あなたがローカルウェブ上でそれを見たいならば
    1 .ルートディレクトリのgo.modファイルを確認してください
    あなたがまだそれを持っていないならば
    go mod init example/path
    
    2実行
    godoc
    
    次にlocalhostで実行します.
    あなたが望むならば、あなたはあなた自身の港を指定することができます
    godoc -http=localhost:8080