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.

What will happen when the 32-bit Unix date goes negative in mid-January 2038 does not bear thinking about.
— Henry Spencer