apropos.1j

[nakano@xxxxxxxxxxxxxxxx]

.\" Man page for apropos
.\"
.\" 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 Oct 29 13:09:31 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	系列
.\"WORD:	description	要約行
.\"
.TH apropos 1 "July 12th, 1995" "2.3.10" "Manual pager utils"
.\"O .SH NAME
.\"O apropos \- search the manual page names and descriptions
.SH 名前
apropos \- マニュアルページの名前と内容を検索する
.\"O .SH SYNOPSIS
.SH 書式
.B apropos 
.RB [\| \-dhV  \|] 
.RB [\| \-r \||\| \-w\c
\|]
.RB [\| \-m
.IR system \|[\|,.\|.\|.\|]\|]
.RB [ \-M
.IR path \|]
.I keyword
\&.\|.\|.
.\"O .SH DESCRIPTION
.SH 説明
.\"O Each manual page has a short description available within
.\"O it. 
.\"O .B apropos
.\"O searches the descriptions for instances of
.\"O .IR keyword .
それぞれのマニュアルページには、内容を説明する要約行が含まれている。
.B apropos
は、この要約行を対象にして
.I keyword
を検索する。
.\"O .I keyword
.\"O may contain wildcards
.\"O .RB ( \-w )
.\"O or be a regular expression
.\"O .RB ( \-r ).
.I keyword
にはワイルドカード
.RB ( \-w )
や正規表現
.RB ( \-r )
を用いることもできる。
.\"O Using these options, 
.\"O it may be
.\"O necessary to quote the
.\"O .I keyword
.\"O or escape (\\) the special characters to stop the shell from interpreting them.
これらのオプションを用いるときには、シェルによる解釈を防ぐために、
.I keyword
を引用符で囲むか、特殊文字をエスケープする (\\) 必要があるかもしれない。
.\"O The standard matching rules allow matches to
.\"O be made against the page name and word boundaries in 
.\"O the description.
標準的なマッチングパターンを指定すれば、
要約中の単語の境界やページの名前もマッチの対象となる。
.\"O .SH OPTIONS
.SH オプション
.TP
.B \-d, \-\-debug
.\"O Print debugging information.
デバッグ情報を表示する。
.TP
.B \-r, \-\-regex
.\"O Interpret each keyword as a regular expression.
.\"O Each keyword will be matched against the page names and the descriptions
.\"O independently. It can match any part of either. The match is not limited to
.\"O word boundaries.
キーワードをそれぞれ正規表現として扱う。ページの名前と
要約行とが、それぞれ独立にキーワードマッチの対象になる。キーワードは
各々のあらゆる部分にマッチする。マッチは単語の境界に影響されない。
.TP
.B \-w, \-\-wildcard
.\"O Interpret each keyword as a pattern containing shell style wildcards.
.\"O Each keyword will be matched against the page names and the descriptions
.\"O independently. Only if an expanded keyword matches an entire description or
.\"O page name, will a match be found.
キーワードを、それぞれシェル形式のワイルドカードパターンが
含まれているものとして扱う。ページの名前と
要約行とが、それぞれ独立にキーワードマッチの対象になる。
展開されたキーワードがページまたは記述の全体にマッチする場合にのみ、
マッチしたと判定される。
.\"
.\" Due to the rather silly limit of 6 args per request in some `native'
.\" *roff compilers, we have do the following to get the two-line
.\" hanging tag on one line. .PP to begin a new paragraph, then the
.\" tag, then .RS (start relative indent), the text, finally .RE
.\" (end relative indent).
.\"
.PP
.B \-m 
.I system\c 
.RB \|[\|,.\|.\|.\|]\| ,
.BI \-\-systems= system\c 
\|[\|,.\|.\|.\|]
.RS
.\"O If this system has access to other operating system's manual page
.\"O descriptions, they can be searched using this option. 
.\"O To search NewOS's manual page descriptions, 
.\"O use the option
.\"O .B \-m
.\"O .BR NewOS .
現在のシステムから、他のオペレーティングシステムについてのマニュアルに
アクセスできる場合には、このオプションをつけるとそれらのマニュアルが
検索される。
NewOS のマニュアルページを検索する場合には、
.B \-m
.B NewOS
のようなオプションを指定する。

.\"O The 
.\"O .I system
.\"O specified can be a combination of comma delimited operating 
.\"O system names.
.\"O To include a search of the native operating system's 
.\"O .B whatis
.\"O descriptions, include the system name
.\"O .B man 
.\"O in the argument string.
.\"O This option will override the
.\"O .RB $ SYSTEM
.\"O environment variable.
.I system
には複数のオペレーティングシステムをコンマで区切った形式で指定できる。
ネイティブのオペレーティングシステムの
.B whatis
要約行を検索の対象に含めるためには、システム名
.B man
を引き数文字列に加える。
このオプションは
.RB $ SYSTEM
環境変数を上書きする。
.RE
.TP
.BI \-M\  path ,\ \-\-manpath= path
.\"O Specify an alternate set of colon delimited, manual page hierarchies to search.
検索対象にするマニュアルページの系列 (hierarchy) を変えたい場合、それ
らをコロンで区切った形式で指定する。
.\"O By default, 
.\"O .B apropos
.\"O uses the 
.\"O .RB $ MANPATH
.\"O environment variable unless it is empty or unset in which case it will 
.\"O determine an appropriate manpath based on your 
.\"O .RB $ PATH
.\"O environment variable.
デフォルトでは、
.B apropos
は環境変数
.RB $ MANPATH
を用いる。これが空だったり設定されていなかった場合には、
.RB $ PATH
環境変数に基づいて、適切な manpath を決めようと試みる。
.\"O This option overrides the contents of
.\"O .RB $ MANPATH .
このオプションは
.RB $ MANPATH
の内容を上書きする。
.TP
.B \-h, \-\-help
.\"O Print a help message and exit.
ヘルプメッセージを表示して終了する。
.TP
.B \-V, \-\-version
.\"O Display version and author information.
バージョンと著者に関する情報を表示する。
.\"O .SH "EXIT STATUS"
.SH 返り値
.TP
.B 0
.\"O Successful program execution.
プログラムの実行に成功した。
.TP
.B 1
.\"O Usage, syntax or configuration file error.
使用法、文法、設定ファイルのいずれかにエラーがある。
.TP
.B 2
.\"O Operational error.
実行時エラー。
.TP
.B 16
.\"O Nothing was found that matched the criteria specified.
指定したキーワードにマッチするものが見つからなかった。
.\"O .SH ENVIRONMENT
.SH 環境変数
.TP
.B SYSTEM
.\"O If
.\"O .RB $ SYSTEM
.\"O is set, it will have the same effect as if it had been specified as the
.\"O argument to the 
.\"O .B \-m
.\"O option.
.RB $ SYSTEM
環境変数が設定されている場合には、その内容が
.B \-m
オプションの引き数として指定された場合と同じ効力を持つ。
.TP
.B MANPATH
.\"O If
.\"O .RB $ MANPATH
.\"O is set, its value is interpreted as the colon delimited, manual page hierarchy
.\"O search path to use.
.RB $ MANPATH
が設定されている場合には、その内容は検索対象とするマニュアルの系列を
コロンで区切ったリストとみなされる。
.TP
.B POSIXLY_CORRECT
.\"O If 
.\"O .RB $ POSIXLY_CORRECT
.\"O is set, even to a null value, the default 
.\"O .B apropos 
.\"O search will be as an extended regex 
.\"O .RB ( \-r ).
.RB $ POSIXLY_CORRECT
が設定されていると (内容が空であっても)、デフォルトの
.B apropos
の検索は拡張正規表現形式
.RB ( \-r )
で行われる。
.\"O .SH FILES
.SH ファイル
.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 なデータベースキャッシュのインデックス。
.TP
.I /usr/man/\|.\|.\|.\|/whatis
.\"O A traditional 
.\"O .B whatis
.\"O text database.
従来形式の、
.B whatis
テキストデータベース。
.\"O .SH "SEE ALSO"
.SH 関連項目
.BR whatis (1),
.\"O .BR man (1).
.BR man (1)
.\"O .SH AUTHOR
.SH 著者
Wilf. (G.Wilford@xxxxxxxxxxxxxxx)