MAN(1)

名称
man - オンラインマニュアルのフォーマット、表示を行なう

書式
man [-adfhktw] [-m system] [-p string] [-M path] [-P pager] [-S list] [section] name ...

解説
man はオンラインマニュアルをフォーマットし、表示します。 このバージョンでは、環境変数 MANPATH と PAGER を参照するので、 各ユーザが固有のオンラインマニュアルを持つ事や、画面で見る際のページャを 選ぶ事が可能です。 セクションを指定した場合、man はそのセクションのみを探します。 また、コマンドラインオプションや環境変数によって、 検索するセクションの順序や、ソースファイルを処理するプリプロセッサを 指定することもできます。 システム管理者の設定によっては、 ディスクスペースを節約するために、フォーマット済みのオンライン マニュアルを `/usr/bin/gzip -c' コマンドにより 圧縮し格納するようにすることも出来ます。

オプションを以下に示します:

-M path
    別の manpath を指定します。通常、man は manpath を使い、検索するパスを決めます。このオプションは環境変数 MANPATH よりも優先されます。

-P pager
    使用するページャを指定します。通常、man は、 more -s を使用します。 このオプションは環境変数 PAGER よりも優先されます。

-S list
    list はコロンで区切られた検索するマニュアルのセクションのリストです。 このオプションは環境変数 MANSECT よりも優先されます。

-a  通常、man は最初にみつかったマニュアルページを表示した後終了しますが、 このオプションを使用すると、最初にみつかったマニュアルページだけでなく、 name にマッチしたマニュアルページを全て表示します。

-d  マニュアルページは表示せず、デバッグ用の情報を表示します。

-f  whatis と同じです。

-h  一行のヘルプメッセージを表示して終了します。

-k  apropos と同じです。

-m system
    与えられたシステム名をもとに検索する別のマニュアルセットを指定します。

-p string
    nroff や troff を行う前に実行するプリプロセッサの順序を指定します。 全てのプリプロセッサがインストールされているとはかぎりません。 プリプロセッサとそれを指定するのに使われる文字は以下の通りです。 eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). このオプションは環境変数 MANROFFSEQ よりも優先されます。

-t  マニュアルページをフォーマットするのに /usr/bin/groff -man を使い、標準出力に出力します。 /usr/bin/groff -man の出力は表示する前に何らかのフィルターを通す必要があるでしょう。

-w  マニュアルページの表示は行わず、フォーマットや表示を行なうべきファイルの 場所を表示します。

環境変数
MANPATH
    MANPATH がセットされていれば、その値はマニュアルページを検索するパスとして使われます。
MANROFFSEQ
    MANROFFSEQ がセットされていれば、その値は nroff や troff を行う前に実行される プリプロセッサの順序を示すのに使われます。 デフォルトでは、nroff の前に tbl プリプロセッサが実行されます。
MANSEC
    MANSEC がセットされていれば、その値はどのマニュアルセクションを検索するのかを 決定するのに使われます。
PAGER
    PAGER がセットされていれば、その値はマニュアルページを表示するのに使われる プログラムの名前を指定するのに使われます。セットされていなければ、 more -s が使われます。

関連項目
apropos(1), whatis(1), manpath(1), more(1), groff(1)

バグ
-t オプションは troff ライクなプログラムがインストールされている場合のみ有効です。