JCATMAN(1)

名称
jcatman - 日本語マニュアルページを含めたマニュアルページをあらかじめフォーマットしておく

書式
jcatman [-f | -force] [-h | -help] [-p | -print] [-r | -remove] [-v | -verbose] [directories ...]

解説
jcatman は日本語および英文オリジナルのマニュアルページを ASCII/EUC テキストにフォーマットします。 これは directories にある全ての日本語およびオリジナルのマニュアルページに対して ‘man program’ とタイプするのと似ています。 directories は日本語およびオリジナルのマニュアルディレクトリ/サブディレクトリのリストであり、 空白もしくはコロンで区切ります。 directories に日本語マニュアルのディレクトリを含めるときには、環境変数 LC_CTYPE か LANG を ja_JP.EUC に設定しておく必要があります。 directories が指定されない場合には /usr/share/man/ja_JP.EUC, /usr/share/man/ja_JP, /usr/share/man/ja のうち存在するディレクトリ(LC_CTYPE か LANG を ja_JP.EUC に設定した場合)、もしくは /usr/share/man (それ以外) を対象とします。

オプション

-f, -force
    強制的に古いフォーマット済ページを上書きします。 このオプションを指定しない場合は、最新ではないページのみをフォーマットします。 このオプションを使用すると大量の時間、CPU、メモリを消費します。

-h, -help
    使用可能なオプションを表示し、終了します。

-p, -print
    実際にはマニュアルページのフォーマットを行いません。 どのような動作を行うのかを表示します。

-r, -remove
    ゴミを消去します。すなわち、マニュアルページが無いフォーマット済ページ、 圧縮されたフォーマット済ページがある圧縮されていないフォーマット済ページ、 非英数字から成る名前のファイル、 圧縮されたマニュアルページがある圧縮されていないマニュアルページを消去します。

-v, -verbose
    警告を多く表示します。

使用例

    $ jcatman

/usr/share/man/ja_JP.EUC, /usr/share/man/ja_JP, /usr/share/man/ja のうち存在するディレクトリの中のフォーマットの必要なマニュアルページをフォーマットします。

    $ jcatman $MANPATH

ユーザのマニュアルページでフォーマットの必要なものを 全てフォーマットします。

    $ jcatman -f /usr/share/man/ja/man1 /usr/share/man/ja/manl

強制的に /usr/share/man/ja/man1 および /usr/share/man/ja/manl にあるマニュアルページを再フォーマットします。

    $ jcatman -p /usr/X11R6/man/ja

どのような動作を行うかだけを表示します。

特徴
全ての日本語マニュアルページがフォーマット済の場合は非常に高速です。 他のシステムでサポートしている -w オプションはサポートしません。 jmakewhatis(1) を使用して、 ‘whatis’ データベースを再構築して下さい。

バグ
jman(1) は setuid プログラムです。 ユーザ ‘man’ が日本語のフォーマット済マニュアルを格納する ディレクトリに書き込み権限を持つようにして下さい。 jcatman は日本語マニュアルページソース中の ‘.so’ をチェックしません。ハードリンクもしくはシンボリックリンクを使用し、 冗長に日本語マニュアルページがフォーマットされないようにして下さい。

環境変数

LC_CTYPE

LANG
    オリジナルのマニュアルページの他に扱うことのできるマニュアルページの言語を 決定します。 日本語マニュアルページを扱うためには LC_CTYPE または LANG が ja_JP.EUC にセットされている必要があります。

関連項目
jman(1), jmanpath(1), jmakewhatis(1).

歴史
このバージョンのオリジナルの catman コマンドは FreeBSD 2.1 から登場しました。 日本語版の jcatman コマンドは FreeBSD 2.2 から ports/packages として登場しました。

作者
Wolfram Schneider <wosch@FreeBSD.org>, Berlin.

日本語対応
熊野 正 <kumano@jp.freebsd.org>