catman - リファレンスマニュアル用の書式付きファイルの作成
/usr/bin/catman [-c] [-n ] [-p] [-t] [-w] [ -M directory] [-T macro-package] [ sections]
/usr/bin/catman [-M directory] -w
catman ユーティリティーは、groff(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/ ディレクトリに作成されます。マニュアルの再整形は実行されません。
指定された directory (デフォルトでは /usr/share/man) にあるマニュアルページを更新します。コンマは、マニュアルセクションの番号を示すために使用されているので、–M オプションの引数として指定するディレクトリ名には `,' (コンマ) が含まれないようにしてください。man(1) を参照してください。
標準のマニュアルページマクロの代わりに macro-package を使用します。
次のオペランドを指定できます。
先頭文字が `–' でないパラメータは、catman によって処理されるマニュアルセクションと見なします。各セクションはスペースで区切ります。このオペランドが指定されると、指定するマニュアルセクションだけが処理されます。たとえば、
catman 1 2 3
前述のコマンドは、セクション 1、2、3 だけを更新します。特定のセクションが示されていない場合は、環境変数 MANPATH で指定された man ディレクトリ内のすべてのセクションが処理されます。
–t オプションが指定された場合に用いるフォーマッタの名前。
catman および man(1) で処理されるディレクトリのコロンで区切られたリスト。各ディレクトリは、コンマで区切られたセクションのリストの後に続いて指定できます。この環境変数に値を設定すると、デフォルトのディレクトリ検索パスである /usr/share/man と、デフォルトのセクション検索パスである man.cf を無効にします。–M および –s フラグはそれぞれこれらの値を無効にします。
次のコマンドは、/usr/local/share/man ディレクトリ内にインデックスファイルを作成します。
# catman -M /usr/local/share/man -w
マニュアルページのデフォルトのディレクトリ
nroff 入力ファイル (未処理)
SGML 入力ファイル (未処理)
事前整形された nroff 処理後のマニュアルページ
groff のデフォルトのマクロパッケージ
事前整形された troff 処理後のマニュアルページ
–K クエリー用のインデックスファイル
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
apropos(1)、man(1)、groff(1)、rm(1)、gtroff(1)、whatis(1)、attributes(5)、sgml(5)
メッセージの冒頭に示されたファイルは、カッコ内のファイルが参照しようとしたが、存在しませんでした。
catman では、パターン .so man?/xxx.? を使用してディレクトリ /path/to/man からの相対ファイル名を参照するか、短いパターン .so in xxx.? を使用して同じサブディレクトリ内のファイル名を参照することだけが可能です。
catman が通常検索するディレクトリのいずれかが見つからないことを示す軽度の警告メッセージ。
catman によって、 中身が空のディレクトリが見つかりました (軽度の警告メッセージ)。
以前に catman を実行して cat* ディレクトリがすでにインストールされている場合に、オペレーティングシステムをアップグレードした場合は、catman を実行する前に cat* ディレクトリ構造全体を削除してください rm(1) を参照してください。
すべての man* ディレクトリがそろっていない場合は、インデックスファイルを再作成するために catman を再度実行しないでください。catman は、man* ディレクトリに基づいてインデックスファイルを作成します。
windex データベースはインデックスファイルに置き換えられました。windex を使用した場合と異なり、インデックスファイルの生成では、インデックスを作成できる対象について特定の制限や前提条件は課せられません。
SGML フォーマットのマニュアルページは Oracle Solaris の将来のリリースではサポートされなくなります。