Unixでは、オンラインドキュメントの主要な形式はマニュアルページまたはmanページでした。GNUオペレーティングシステムでは、manページを、Infoで閲覧できるより体系的に整理されたマニュアルに置き換えることを目指しています(その他のヘルプコマンドを参照)。このプロセスはまだ完了していないため、引き続きマニュアルページを読むことは有用です。
M-x man
コマンドを使用すると、オペレーティングシステムのコマンド、ライブラリ関数、またはシステムコールの man
ページを読むことができます。このコマンドはトピックの入力を促し、補完機能(Completion を参照)を備えており、man プログラムを実行して対応する man
ページをフォーマットします。システムが許可している場合は、man
を非同期で実行するため、ページのフォーマット中も編集を続けることができます。結果は *Man topic*
という名前のバッファに格納されます。これらのバッファでは、スクロールや他のマニュアルページへのジャンプを容易にする特別なメジャーモード「Man
モード」が使用されます。詳細については、Man モードのバッファ内で C-h m と入力してください。
各manページは、10個以上のセクションのいずれかに属しており、各セクションは数字、または数字と英字で命名されています。異なるセクションに同じ名前のmanページが存在することもあります。特定のセクションのmanページを読むには、M-x manがトピックの入力を求めた際に、‘topic(section)’または‘section topic’と入力してください。例えば、Cライブラリ関数chmodのmanページはセクション2にありますが、同名のシェルコマンドもあり、そのmanページはセクション1にあります。前者を表示するには、M-x man RET chmod(2) RETと入力してください。
セクションを指定しない場合、M-x man は通常、最初に見つかった man
ページのみを表示します。一部のシステムでは、man プログラムがコマンドラインオプション
‘-a’ を受け付け、これにより指定したトピックに関するすべての man
ページを表示するように指示できます。これを利用するには、変数 Man-switches の値を
‘"-a"’ に変更してください。その後、Man
モードバッファで M-n と M-p
を入力することで、異なるセクションの man ページを切り替えることができます。モードラインには、利用可能なマニュアルページの数が表示されます。
デフォルトでは、M-x man は man
プログラムを非同期に呼び出します。Man-prefer-synchronous-call を
nil 以外の値にカスタマイズすることで、呼び出しを同期的に強制できます。
ユーザーオプション Man-support-remote-systems が nil 以外であり、かつ default-directory
がリモートシステムを示す場合(リモートファイル
を参照)、man ページはリモートシステムから取得されます。C-u M-x man
のようなプレフィックスを付けて man コマンドを呼び出すと、その呼び出しにおける Man-support-remote-systems の値が元に戻ります。
マニュアルページを読み込む別の方法として、M-x womanコマンドがあります。M-x
manとは異なり、マニュアルページの書式設定や表示のために外部プログラムを実行することはありません。書式設定はEmacsが行うため、manプログラムが利用できない可能性のあるMS-Windowsなどのシステムでも動作します。このコマンドはマニュアルページの指定を促し、それを*WoMan section topicという名前のバッファに表示します。
M-x woman は、コマンドを初めて実行した際に man ページの補完リストを算出します。数値引数を指定すると、このリストを再計算します。これは、man ページを追加または削除した場合に便利です。
マニュアルページ名を入力し、M-x woman が同じ名前のマニュアルページが異なるセクションに複数存在することを発見した場合、候補となるページの一覧ウィンドウが表示され、その中から1つを選択するよう求められます。
なお、M-x woman は最新の man ページの機能にまだ対応していないため、システムで利用可能な場合は M-x man の使用を推奨します。
M-x womanの設定と使用方法の詳細については、Emacsに同梱されているWoMan Infoマニュアルを参照してください。