マニュアルページに例がないのはなぜですか？

Question

マニュアルページによって異なります。伝統的に持つ例を含むセクションが含まれています。ただし、何らかの理由でLinuxのマニュアルページにはそのセクションがないことがよくあります。（他のコマンドは現在ほとんどのGNUコマンドを使用していると仮定しています。）一方、たとえばSolarisでは、ほとんどすべてのマニュアルページに「例」セクションが含まれており、多くの例が含まれています。

推測すると、FSF / GNUは長い間manページの使用を抑制し、ユーザーが情報を文書として使用することを好みました。infoページはマニュアルページよりも包括的な傾向があり、一般的にする例を含めてください。 infoページはさらに「トピック」です。つまり、関連するコマンド（ファイルの検索に使用されるコマンドなど）を一緒に見つけることができることがよくあります。

もう1つの理由は、GNUとそのページが異なるさまざまなオペレーティングシステムで使用されるためですman（最終的にLinuxディストリビューションには多くの違いがあります）。出版社の意図は、おそらく特定のオペレーティングシステム/ディストリビューションに関連する例を追加することでしたが、これはほとんど行われていないようです。

manまた、このページは「初心者を教える」ことが決してないことを付け加えたいと思います。 UNIXは、コンピュータの専門家（以前の用語「ハッカー」）がコンピュータの専門家が使用できるように開発されました。したがって、マニュアルページは初心者を教えるためではなく、あいまいなオプションや奇妙なファイル形式を思い出させる必要があるコンピュータの専門家にすばやく助けるためのものです。これは、マニュアルページを分割する方法に反映されます。

man-ページは、次のように意図されます。

記憶を更新するためのクイックリファレンスは、コマンドの呼び出し方法を示し、利用可能なオプションをリストします。
深く徹底した（しばしば非常に技術的）説明みんなコマンドのすべての側面。コンピュータの専門家が他のコンピュータの専門家のために書いた。
コマンドで使用される環境変数とファイル（構成ファイルなど）のリスト。
他の文書（本など）や他のmanページへの参照 - 例：構成ファイルと関連/類似コマンドの形式。

つまり、manマニュアルページ自体を調べるよりも使い方をよく説明するため、ページに例があるはずだということには全く同意します。残念ながら、man一般的にLinuxページには例はありません...

Solaris のマニュアルページの例セクションの例 - zfs(1M):

(...)
はい
     例1 ZFSファイルシステム階層の作成

     次のコマンドは pool/home というファイルシステムを生成します。
     そしてpool / home / bobというファイルシステムがあります。マウントポイント
     /export/home は親ファイルシステムに設定されます。
     サブファイルシステムから自動的に継承されます。

       # zfs はプール/ホームを作成します。
       # zfs set mountpoint=/export/home プール/ホーム
       # zfs は /home/bob プールを生成します。

     例2 ZFSスナップショットの作成

     次のコマンドは、昨日という名前のスナップショットを作成します。
     このスナップショットは、要求に応じて.zfs / snapshotにインストールされます。
     pool/home/bob ファイルシステムのルートディレクトリ。

       #zfsスナッププール/home/bob@yesterday

     例3複数のスナップショットの作成と削除

     次のコマンドは、昨日と呼ばれるスナップショットを作成します。
     pool / homeとすべてのサブファイルシステム。各
     スナップショットは、要求に応じて.zfs / snapshotディレクトリにマウントされます。
     ファイルシステムのルートにあります。 2番目の命令は破壊することです。
     新しく作成されたスナップショット。

       #zfs snapshot -r pool/home@yesterday
       # zfs destroy -r pool/home@yesterday

SunOS 5.11 最終変更日: 2012 年 7 月 23 日 51

システム管理コマンド zfs(1M)

     例 4 ファイルシステム圧縮の無効化と有効化

     次のコマンドは圧縮属性を無効にします。
(...)

この特定のマニュアルページには、これらの例の16（！）が含まれています... Solarisに賛辞を送ります！
（私はこのコマンドの完全なマニュアルページを読むのではなく、この例に直接従ったことを認めています...）

Answer 1