github.com/shogo82148/std@v1.22.1-0.20240327122250-4e474527810c/cmd/doc/main.go (about)

     1  // Copyright 2015 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  // Doc (通常は go doc として実行される) は 0 個、1 個、または 2 個の引数を受け付けます。
     6  //
     7  // 0 個の引数:
     8  //
     9  //	go doc
    10  //
    11  // 現在のディレクトリに含まれるパッケージのドキュメントを表示します。
    12  //
    13  // 1 個の引数:
    14  //
    15  //	go doc <pkg>
    16  //	go doc <sym>[.<methodOrField>]
    17  //	go doc [<pkg>.]<sym>[.<methodOrField>]
    18  //	go doc [<pkg>.][<sym>.]<methodOrField>
    19  //
    20  // 成功する最初の項目のドキュメントが表示されます。シンボルが指定されているがパッケージが指定されていない場合、現在のディレクトリのパッケージが選択されます。ただし、引数が大文字で始まる場合は常に現在のディレクトリのシンボルと見なされます。
    21  //
    22  // 2 個の引数:
    23  //
    24  //	go doc <pkg> <sym>[.<methodOrField>]
    25  //
    26  // パッケージ、シンボル、およびメソッドまたはフィールドのドキュメントを表示します。最初の引数は完全なパッケージパスである必要があります。これは godoc コマンドのコマンドライン使用法と似ています。
    27  //
    28  // コマンドの場合、-cmd フラグが存在しない限り、"go doc コマンド" はパッケージレベルのドキュメントのみ表示します。
    29  //
    30  // -src フラグを指定すると、doc は構造体、関数、またはメソッドの本体などのシンボルの全ソースコードを表示します。
    31  //
    32  // -all フラグを指定すると、doc はパッケージとその可視なシンボルのすべてのドキュメントを表示します。引数はパッケージを識別する必要があります。
    33  //
    34  // 完全なドキュメントについては、「go help doc」を実行してください。
    35  package main