POSIXツールを参照するときは、マニュアルページのセクション番号を追加するのが良い習慣ですか? [閉鎖]

POSIXツールを参照するときは、マニュアルページのセクション番号を追加するのが良い習慣ですか? [閉鎖]

ls私は時々stackexchangeやCommentへのこの答えのように、マンページ自体がls(1)散文/テキスト(lsの場合)で行われているように、マンページセクション番号を括弧内に追加するなどのツールに言及している人を見ます。これは良い習慣ですか?この慣行のソースはありますか?大企業、メーリングリストなどのようにこれを行う評判の良い「団体」はありますか?

答え1

場合によっては、単一の名前が複数のマンページを参照するときにあいまいさを避けるのに役立ちます。

たとえば、unlinkマニュアルページは3つのセクションに分かれています。

  1. unlink(1) はユーザーレベルのコマンドを記述します。
  2. unlink(2) は、切断機能を実装するカーネルレベルのシステムコールを記述します。
  3. 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

関連情報