ナビゲーションリンクをスキップ | |
印刷ビューの終了 | |
マニュアルページセクション 1M: システム管理コマンド Oracle Solaris 11 Information Library (日本語) |
- リファレンスマニュアル用の書式付きファイルの作成
/usr/bin/catman [-c] [-n] [-p] [-t] [-w] [-M directory] [-T macro-package] [sections]
/usr/bin/catman [-M directory] -w
catman ユーティリティーは、nroff(1) または sgml(5) の入力ファイルからオンラインマニュアルの事前整形されたバージョンを作成します。事前整形されたマニュアルページのディレクトリは、自己完結的にかつ書式なしエントリから独立して作成されるので、一群のマシンの間でそれらのマニュアルページを容易に配布できます。
また、-w オプションを使用すると、catman は MANPATH または -M オプションで指定されたディレクトリにインデックスファイルを作成します。MANPATH または -M オプションが指定されていない場合、-n を指定しなければ、catman はデフォルトで /usr/share/man/ および /usr/gnu/share/man/ ディレクトリにインデックスファイルを作成します。指定されたディレクトリまたはデフォルトのディレクトリが読み取り専用の場合、catman は失敗し、そのディレクトリへの書き込みが許可されていないことを示すエラーメッセージを標準エラー出力に表示します。
各マニュアルページが検査され、事前整形されたバージョンが見つからないもの、または最新ではないものについては再作成されます。なんらかの変更が行われた場合、catman はインデックスファイルを再作成します。
マニュアルページが shadow (シャドウ) ページである場合、つまりその内容が書かれた別のマニュアルページをソースとしている場合、該当する事前整形されたマニュアルページへのシンボリックリンクが catx または fmtx ディレクトリに作成されます。
書式なし nroff のソースファイルにあるシャドウファイルは、最初の行に .so manx/yyy.x という形式の行があることで識別できます。
SGML のソースファイルにあるシャドウファイルは、文字列 SHADOW_PAGE があることで識別できます。シャドウファイルで宣言されたファイルの実体は、ソースとなるファイルを示しています。
次のオプションがサポートされています。
SGML のソースファイルから、書式なし nroff のソースファイルを適切な man サブディレクトリに作成します。このオプションは SGML ファイルと同じ名前で man ディレクトリにある既存のファイルをすべて上書きします。
インデックスファイルを作成 (再作成) しません。-n オプションを指定した場合、インデックスファイルは作成されず、apropos(1) および whatis(1) コマンドの実行速度が、それ以外の場合よりも低下する可能性があります。
予行演習オプション。つまり、実行するのではなく何が行われるのかを表示します。
cat サブディレクトリへの nroff を行う代わりに、該当する fmt サブディレクトリ内に troff 処理後のエントリを作成します。
apropos(1)、whatis(1)、および man(1) の -f、-k、および -K オプションで使用されるインデックスファイルを、MANPATH 環境変数または -M オプションで指定されるディレクトリに作成します。MANPATH または -M オプションを指定しない場合、インデックスファイルはデフォルトで /usr/share/man/ および /usr/gnu/share/man/ ディレクトリに作成されます。マニュアルの再整形は実行されません。
引数に指定したディレクトリ (デフォルトは /usr/share/man) 中にあるマニュアルページを更新します。コンマは、マニュアルセクションの番号を示すために使用されているので、-M オプションの引数として指定するディレクトリ名には `,' (コンマ) が含まれないようにしてください。man(1) を参照してください。
標準のマニュアルページマクロの代わりに、 macro-package 引数で指定したマクロパッケージを使用します (デフォルトは man(5))。
次のオペランドがサポートされています。
先頭文字が `–' でないパラメータは、catman によって処理されるマニュアルセクションと見なします。各セクションはスペースで区切ります。このオペランドが指定されると、指定するマニュアルセクションだけが処理されます。たとえば、次のように指定します。
catman 1 2 3
前述のコマンドは、セクション 1、2、3 だけを更新します。セクションが指定されない場合、環境変数 MANPATH に指定された man ディレクトリにあるすべてのセクションが処理されます。
-t オプションが指定された場合に用いるフォーマッタの名前。この環境変数が設定されていない場合は、troff(1) が使用されます。
catman と man(1) で処理されるディレクトリの、コロンで区切られたリスト。各ディレクトリは、コンマで区切られたセクションのリストの後に続いて指定できます。この環境変数に値を設定すると、デフォルトのディレクトリ検索パスである /usr/share/man と、デフォルトのセクション検索パスである man.cf を無効にします。-M および -s フラグはそれぞれこれらの値を無効にします。
例 1 インデックスファイルの作成
次のコマンドは、インデックスファイルを /usr/local/share/man ディレクトリに作成します。
# catman -M /usr/local/share/man -w
マニュアルページのデフォルトのディレクトリ
nroff 入力ファイル (未処理)
SGML 入力ファイル (未処理)
事前整形された nroff 処理後のマニュアルページ
事前整形された troff 処理後のマニュアルページ
デフォルトのマクロパッケージ
-K クエリー用のインデックスファイル
次の属性については、attributes(5) を参照してください。
|
apropos(1), man(1), nroff(1), rm(1), troff(1), whatis(1), attributes(5), man(5), sgml(5)
メッセージの冒頭に示されたファイルは、カッコ内のファイルが参照しようとしたが、存在しませんでした。
catman では、ディレクトリ /usr/man からの相対パスで示したファイル名のみを参照できます。
catman が通常検索するディレクトリのうちの 1 つが見つかりません (軽度の警告メッセージ)。
catman によって、 中身が空のディレクトリが見つかりました (軽度の警告メッセージ)。
以前に catman を実行して cat* ディレクトリがすでにインストールされている場合に、オペレーティングシステムをアップグレードした場合は、catman を実行する前に cat* ディレクトリ構造全体を削除してください (rm(1) を参照)。
すべての man* ディレクトリがそろっていない場合は、インデックスファイルを再作成するために catman を再度実行しないでください。catman は、man* ディレクトリに基づいてインデックスファイルを作成します。
windex データベースはインデックスファイルに置き換えられました。windex を使用した場合と異なり、インデックスファイルの生成では、インデックスを作成できる対象について特定の制限や前提条件は課せられません。