.\" Copyright (c) 2002 John Rochester
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" %FreeBSD: src/usr.bin/catman/catman.1,v 1.3.6.1 2005/01/12 15:28:42 ru Exp %
.\"
.\" $FreeBSD$
.Dd December 22, 2004
.Dt CATMAN 1
.Os
.Sh 名称
.Nm catman
.Nd オンラインマニュアルを事前にフォーマットする
.Sh 書式
.Nm
.Op Fl fLnrv
.Op Ar directories ...
.Sh 解説
.Nm
ユーティリティは、
.Ar directories
の全てのマニュアルページを
.Nm nroff Fl man
コマンドを使用して、事前にフォーマットします。
ディレクトリはスペースの代りにコロンで区切ることもできます。
.Ar directories
が指定されなかった場合、
.Ev MANPATH
環境変数の内容が使われるか、
これが設定されていない場合にはデフォルトディレクトリ
.Pa /usr/share/man
が処理されます。
.Pp
オプションは次の通りです:
.Bl -tag -width indent
.It Fl f
cat ページの方が新しくても、全ての man ページを再フォーマットします。
.It Fl L
標準の環境変数で指定されたロケールに対応するローカライズサブディレクトリ
のみ処理します。
.It Fl n
実際のフォーマットを実行する代りに、なにが行われるかだけを表示します。
.It Fl r
.Dq ゴミ
ファイル、
すなわち man ページでもこれをフォーマットした cat ページでもないものを
探して削除します。
.It Fl v
.Nm
が何を行っているかに関して更に冗長になります。
.El
.Sh 環境変数
.Bl -tag -width ".Ev MANPATH"
.It Ev LC_ALL , LC_CTYPE , LANG
これらの変数は、
.Fl L
オプション使用時に処理するサブディレクトリを制御します。
.It Ev MACHINE
設定された場合、マシン固有サブディレクトリを検索する時に、
この値で現在のマシンタイプを上書きします。
.It Ev MANPATH
コマンドラインにディレクトリが指定されない場合に
どのディレクトリを処理するかを決定します。
.El
.Sh 関連ファイル
.Bl -tag -width ".Pa /usr/share/man" -compact
.It Pa /usr/share/man
.Ev MANPATH
環境変数が設定されていない場合に処理されるデフォルトディレクトリ。
.El
.Sh 診断
.Ex -std
.Sh 関連項目
.Xr makewhatis 1 ,
.Xr man 1 ,
.Xr nroff 1
.Sh 歴史
以前のバージョンの
.Nm
コマンドは
.Fx 2.1
に登場しました。
.Sh 作者
.An John Rochester