MAN ファイル

拡張子.manを持つファイルには、roffソースマークアップで記述されたUnixユーザーマニュアルが含まれています。マニュアルページ（manページ）は、manコマンドに続けてプログラム、関数、またはトピックの名前を入力することでアクセスできます。ソースは*man*マクロパッケージを使用します。これはドットで始まるディレクティブ（.TH、.SH、.B、.TP）のセットで、manがgroffまたはmandocを介してオンデマンドでレンダリングします。テキストエディタで.manファイルを開くと、整形されたページではなく、これらの生のマークアップが表示されます。.manファイルは、太字、斜体、インデント、表のレイアウトを制御するための表示フォーマットマクロをサポートしています。

.manはプレーンテキストファイルであり、任意のテキストエディタで開くことができますが、ユーザーマニュアルは通常、コマンドラインから呼び出されるシステムツールmanを使用してアクセスされます。多くのグラフィカルなシステム環境では、manドキュメントを表示するためのさまざまなツールが提供されています。マニュアルページは以下のセクションに分かれています：

• NAME - プログラム、ツール、ライブラリ、または関数の名前と、それに続く短い説明
• SYNOPSIS - コマンドのパラメータとオプション、およびオプションでC関数のシグネチャ
• DESCRIPTION - コマンドとその機能の詳細な説明
• EXAMPLES - コマンドの使用例
• SEE ALSO - 関連する関数やコマンドのリスト

Unix/Linuxのユーザーマニュアルは、通常ディスク上に.manファイルとして保存されることは一般的ではありません。通常、マニュアルはファイルが属するマニュアルのセクションを示すサフィックス（例：ls.1やprintf.3）を付けて保存され、インストールされたページは通常name.section.gzとしてgzip圧縮されており、manによって透過的に解凍されます。マニュアルページは通常英語ですが、一部のマニュアルはさまざまなディストリビューションでローカライズされています。

マニュアルドキュメントは番号付きのセクションに分かれています。manコマンドはデフォルトで、Unix System Vでは7つ、Linux/BSDでは8つあるセクションのうち、最初に一致したエントリを表示します：

• 一般コマンド
• システムコール
• Cライブラリ関数
• 特殊ファイルとデバイスドライバ
• ファイル形式と設定ファイル
• ゲームとスクリーンセーバー
• その他 / 概要ページ
• システム管理とデーモン (Linux/BSDのみ)

特定のセクションにアクセスするには、man セクション番号 名前（例：man 5 passwd）を実行する必要があります。マニュアルの出力は、読みやすくするためにcatやlessなどの別のアプリケーションにリダイレクトできます。