ls
私は時々stackexchangeやCommentへのこの答えのように、マンページ自体がls(1)
散文/テキスト(lsの場合)で行われているように、マンページセクション番号を括弧内に追加するなどのツールに言及している人を見ます。これは良い習慣ですか?この慣行のソースはありますか?大企業、メーリングリストなどのようにこれを行う評判の良い「団体」はありますか?
答え1
場合によっては、単一の名前が複数のマンページを参照するときにあいまいさを避けるのに役立ちます。
たとえば、unlink
マニュアルページは3つのセクションに分かれています。
- unlink(1) はユーザーレベルのコマンドを記述します。
- unlink(2) は、切断機能を実装するカーネルレベルのシステムコールを記述します。
- unlink(3p) は、システムコールをラップするライブラリ関数を記述します。このページはPOSIXプログラマーズマニュアルの一部です。
特定の状況で参照するセクションを明確にするには、セクション番号を指定することが役立ちます。
このコマンドは質問に記載されているため、このコマンドの2つのマンページ(ローカル実装とPOSIX定義)ls
があります。この場合、セクション番号を指定すると便利です。ls(1)
ls(1p)
明示的なマンページの場合、セクション番号は多くの値を追加しません。例:1)fstab
、5番目のセクションの下にページがあります。 2)cron
、8番目のセクションの下にページがあります。
上記のすべてのマンページはここにリストされています。https://www.man7.org/linux/man-pages/dir_all_alphabetic.html