catman.8j

[nakano@xxxxxxxxxxxxxxxx]

.\" Man page for catman
.\"
.\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.)
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file COPYING that comes with the
.\" man_db distribution.
.\"
.\" Sat Dec 10 14:17:29 GMT 1994  Wilf. (G.Wilford@xxxxxxxxxxxxxxx) 
.\" 
.\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
.\" Translated Fri 25 Sep 1998 by NAKANO Takeo <nakano@xxxxxxxxxxxxxxxx>
.\"
.\"WORD:	hierarchy	系列
.\"
.TH catman 8 "July 12th, 1995" "2.3.10" "Manual pager utils"
.\"O .SH NAME
.\"O catman \- create or update the pre-formatted manual pages
.SH 名前
catman \- フォーマットされたマニュアルページを生成・更新する
.\"O .SH SYNOPSIS
.SH 書式
.B catman 
.RB [\| \-dhV \|] 
.RB [\| \-M 
.IR path \|] 
.RI [\| section \|]
\&.\|.\|.
.\"O .SH DESCRIPTION
.SH 説明
.\"O .B catman
.\"O is used to create an up to date set of pre-formatted manual pages known as
.\"O cat pages. 
.\"O Cat pages are generally much faster to display than the original
.\"O manual pages, but require extra storage space. The decision to
.\"O support cat pages is that of the local administrator, who must provide
.\"O suitable directories to contain them.
.B catman
は、フォーマット済みマニュアルページ (cat ページと呼ばれる) の最新の
セットを生成するために用いられる。
通常 cat ページはオリジナルの man ページよりもずっと速く表示できるが、
余分な保存領域が必要とされる。 cat ページをサポートするかどうかは、
ローカルな管理者 (cat ページを保存するディレクトリに関する権限を持って
いる人) の判断による。

.\"O The options available to
.\"O .B catman
.\"O are the manual page hierarchies and sections to pre-format. The
.\"O default hierarchies are those specified as `global' in the man_db 
.\"O configuration file and the default sections are either 
.\"O the colon delimited contents of the environment variable
.\"O .RB $ MANSECT
.\"O or the standard set compiled into 
.\"O .B man
.\"O if 
.\"O .RB $ MANSECT
.\"O is undefined. Supplying
.\"O .B catman
.\"O with a set of whitespace delimited section names will override both of
.\"O the above.
.B catman
に与えることのできるオプションは、フォーマットを行うマニュアルページの
系列 (hierarchy) とセクションである。デフォルトの系列は、 man_db の設
定ファイルで 
`global' 指定されているものである。デフォルトのセクションは、環境変数
.RB $ MANSECT
が与えられていれば、その内容をコロン区切りとみなしたものになり、与えら
れていなければ
.B man
のコンパイル時に指定されている標準的なセットとなる。
.B catman
の実行時にセクションの名前をスペースで区切って与えれば、
これらの両方を上書きする。

.\"O .B catman
.\"O makes use of the
.\"O .B index
.\"O database cache associated with each hierarchy to determine which files 
.\"O need to be formatted.
.B catman
はそれぞれの系列における
.B index
データベースキャッシュを利用して、どのファイルをフォーマットすべきかを
決定する。
.\"O .SH OPTIONS
.SH オプション
.TP
.B \-d, \-\-debug
.\"O Print debugging information.
デバッグ情報を表示する。
.TP
.BI \-M\  path ,\ \-\-manpath= path
.\"O Specify an alternate colon delimited manual page hierarchy search path. 
.\"O By default, this is all paths indicated as `global'
.\"O in the man_db configuration file.
マニュアルページ系列のサーチパスとして用いるコロン区切りのリストを指定する。
デフォルトでは、 man_db 設定ファイルで `global' 指定されているすべてのパ
スを対象とする。
.TP
.B \-h, \-\-help
.\"O Print a help message and exit.
ヘルプメッセージを表示して終了する。
.TP
.B \-V, \-\-version
.\"O Display version and author information.
バージョンと著者に関する情報を表示する。
.\"O .SH ENVIRONMENT
.SH 環境変数
.TP
.B MANSECT
.\"O If
.\"O .RB $ MANSECT
.\"O is set, its value is a colon delimited list of sections and it is used to
.\"O determine which manual sections to search and in what order.
.RB $ MANSECT
が設定されていると、その値はセクションのリスト (コロン区切り) として扱われ、
マニュアルのどのセクションを検索するかを決定する際に用いられる。セクショ
ンは指定された順序で検索される。
.TP
.B MANPATH
.\"O If
.\"O .RB $ MANPATH
.\"O is set, its value is interpreted as the colon delimited, manual page
.\"O hierarchy search path to use.
.RB $ MANPATH
が設定されていると、その内容は検索対象とするマニュアルの系列を
コロンで区切ったリストとみなされる。
.\"O .SH FILES
.SH ファイル
.TP
.I /etc/manpath.config
.\"O man_db configuration file.
man_db の設定ファイル。
.TP
.I /usr/man/index.(bt|db|dir|pag)
.\"O A traditional global
.\"O .I index
.\"O database cache.
従来形式の、 global なデータベースキャッシュの
インデックス。
.TP
.I /var/catman/index.(bt|db|dir|pag)
.\"O An alternate or FSSTND
.\"O compliant global
.\"O .I index
.\"O database cache.
新しい (FSSTND 準拠の)、 global なデータベースキャッシュの
インデックス。
.\"O .SH "SEE ALSO"
.SH 関連項目
.BR man (1),
.BR manpath (5), 
.\"O .BR mandb (8).
.BR mandb (8)
.\"O .SH AUTHOR
.SH 著者
Wilf. (G.Wilford@xxxxxxxxxxxxxxx)