tail head cat sleep
QR code linking to this page

manページ  — JCATMAN

名称

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>

JCATMAN (1) June 11, 2001

tail head cat sleep
QR code linking to this page


このマニュアルページサービスについてのご意見は Ben Bullock にお知らせください。 Privacy policy.

If you have an emergency I'm great at running around and flailing my arms
— Artur Bagyants