GIT を学び始めたばかりですが、ドキュメントの構文がわかりにくいです。「git-add[1]」や「git-commit[1]」などの使用例で [1] は何を意味しますか?
ドキュメントのいたるところにこの言葉が書かれています。ウェブサイトのページによっては括弧で囲まれて「git-init(1)」と表示されることもあります。
それは何を表していますか?
答え1
これはマニュアルのセクション番号です。この規則は一般的なもので、Gitに限定されるものではありません。man 1 man
:
[…] セクションが指定されている場合は、
man
マニュアルのそのセクションのみを検索するように指示します。デフォルトのアクションは、定義済みの順序に従って利用可能なすべてのセクションを検索し、ページが複数のセクションに存在する場合でも、見つかった最初のページのみを表示することです。以下の表は、マニュアルのセクション番号と、そのセクションに含まれるページの種類を示しています。
- 実行可能プログラムまたはシェルコマンド
- システムコール(カーネルが提供する関数)
- ライブラリ呼び出し(プログラムライブラリ内の関数)
- 特別なファイル(通常は にあります
/dev
)- ファイル形式と規則の例
/etc/passwd
- ゲーム
- その他(マクロパッケージや規約を含む)、例
man(7)
:groff(7)
- システム管理コマンド(通常はルートのみ)
- カーネルルーチン [非標準]
git-init(1)
したがって、のマニュアルを参照するコマンドは ですman 1 git-init
。この場合、単純なman git-init
コマンドで済みますが、必要なセクション番号を明示的に指定する必要がある場合もあります。たとえば、man(1)
と は前者を表示しますが、後者を参照するには が必要です。man(7)
man man
man 7 man