私は情報ページのファンではありません。私は良い古いUnixのmanページを好んでおり、それらを書くのはとても簡単です。エディタでマニュアルページを開くだけで、ソースを見て、必要に応じてコピーすることができます。
ほとんどのシステムでは、マニュアルページは/usr/share/man/{man1,man2,man3,man4,man5,man6,man7,man8}/
のようなディレクトリにあり、man
コマンドの-w
オプションを使用して、マニュアルページの場所を確認して開くことができます。たとえば、
$ man -w ls
/usr/share/man/man1/ls.1.gz
$ vim /usr/share/man/man1/ls.1.gz
あなたはそれがどのように書かれているか分かり、あなた自身のマニュアルページを書くことができます。誰かがあなたが書いたマニュアルページを読むことができるようにするには、manページがmanページを探すディレクトリの一つにmanページをインストールしなければなりません。 Linuxでは、通常manpath
コマンドを実行することでこのディレクトリの一覧を見ることができます(他のシステムでは異なる可能性があり、man
コマンド自体のマニュアルページを参照する必要があります)。これらのディレクトリの1つにマニュアルページを格納する場合は、man
ユーティリティを使用してマニュアルページを読むことができます。
man
ユーティリティは、環境変数MANPATH
を尊重し、あなたが標準以外の場所であなたのmanページを保存する場合man
はそれを見ることができるように、あなたは、MANPATH変数を設定することができます。POSIX
を1としてまた、/etc/man.conf
ファイルを変更して、マニュアルページディレクトリを検索パスman
に追加することもできます。
ここで、マニュアルページはマークアップを行うためにマクロ言語を使用しています。手動here
を見ることができるため、Linuxシステムは、オペレーティング・システムのBSDファミリーで広く使用されているmdoc(7)
と呼ばれるmanページを書くための別の現代のマクロセットは、あり、man(7)
マクロ構文を使用する傾向があります。あなたはそのマニュアルを見ることができますhere