.\" 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@ee.surrey.ac.uk) .\" .\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved. .\" Translated Fri 25 Sep 1998 by NAKANO Takeo .\" Modified Sun 6 Dec 1998 by NAKANO Takeo .\" .\"WORD: hierarchy 階層 .\"WORD: description 要約(文) .\" .TH apropos 1 "July 12th, 1995" "2.3.10" "Manual pager utils" .SH 名前 apropos \- マニュアルページの名前と内容を検索する .SH 書式 .B apropos .RB [\| \-dhV \|] .RB [\| \-r \||\| \-w\c \|] .RB [\| \-m .IR system \|[\|,.\|.\|.\|]\|] .RB [ \-M .IR path \|] .I keyword \&.\|.\|. .SH 説明 それぞれのマニュアルページには、内容を説明する要約文が含まれている。 .B apropos は、この要約文を対象にして .I keyword を検索する。 .I keyword にはワイルドカード .RB ( \-w ) や正規表現 .RB ( \-r ) を用いることもできる。 これらのオプションを用いるときには、シェルによる解釈を防ぐために、 .I keyword を引用符で囲むか、特殊文字をエスケープする (\\) 必要があるかもしれない。 標準的なマッチングパターンを指定すれば、 要約文中の単語の境界やページの名前もマッチの対象となる。 .SH オプション .TP .B \-d, \-\-debug デバッグ情報を表示する。 .TP .B \-r, \-\-regex キーワードをそれぞれ正規表現として扱う。ページの名前と 要約文とが、それぞれ独立にキーワードマッチの対象になる。キーワードは 各々のあらゆる部分にマッチする。マッチは単語の境界に影響されない。 .TP .B \-w, \-\-wildcard それぞれのキーワードを、シェル形式のワイルドカードを含んだパターン として扱う。ページの名前と 要約文とが、それぞれ独立にキーワードマッチの対象になる。 展開されたキーワードがページまたは記述の全体にマッチする場合にのみ、 マッチしたと判定される。 .PP .B \-m .I system\c .RB \|[\|,.\|.\|.\|]\| , .BI \-\-systems= system\c \|[\|,.\|.\|.\|] .RS 現在のシステムから、他のオペレーティングシステムについてのマニュアルに アクセスできる場合には、このオプションをつけるとそれらのマニュアルが 検索される。 NewOS のマニュアルページを検索する場合には、 .B \-m .B NewOS のようなオプションを指定する。 .I system には複数のオペレーティングシステムをコンマで区切った形式で指定できる。 ネイティブのオペレーティングシステムの .B whatis 要約文を検索の対象に含めるためには、システム名 .B man を引き数文字列に加える。 このオプションは .RB $ SYSTEM 環境変数を上書きする。 .RE .TP .BI \-M\ path ,\ \-\-manpath= path 検索対象にするマニュアルページの階層 (hierarchy) を変えたい場合、それ らをコロンで区切った形式で指定する。 デフォルトでは、 .B apropos は環境変数 .RB $ MANPATH を用いる。これが空だったり設定されていなかった場合には、 .RB $ PATH 環境変数に基づいて、適切な manpath を決めようと試みる。 このオプションは .RB $ MANPATH の内容を上書きする。 .TP .B \-h, \-\-help ヘルプメッセージを表示して終了する。 .TP .B \-V, \-\-version バージョンと著者に関する情報を表示する。 .SH 返り値 .TP .B 0 プログラムの実行に成功した。 .TP .B 1 使用法、文法、設定ファイルのいずれかにエラーがある。 .TP .B 2 実行時エラー。 .TP .B 16 指定したキーワードにマッチするものが見つからなかった。 .SH 環境変数 .TP .B SYSTEM .RB $ SYSTEM 環境変数が設定されている場合には、その内容が .B \-m オプションの引き数として指定された場合と同じ効力を持つ。 .TP .B MANPATH .RB $ MANPATH が設定されている場合には、その内容は検索対象とするマニュアルの階層を コロンで区切ったリストとみなされる。 .TP .B POSIXLY_CORRECT .RB $ POSIXLY_CORRECT が設定されていると (内容が空であっても)、デフォルトの .B apropos の検索は拡張正規表現形式 .RB ( \-r ) で行われる。 .SH ファイル .TP .I /usr/man/index.(bt|db|dir|pag) 従来形式の、 global なデータベースキャッシュの インデックス。 .TP .I /var/catman/index.(bt|db|dir|pag) 新しい (FSSTND 準拠の)、 global なデータベースキャッシュのインデックス。 .TP .I /usr/man/\|.\|.\|.\|/whatis 従来形式の、 .B whatis テキストデータベース。 .SH 関連項目 .BR whatis (1), .BR man (1) .SH 著者 Wilf. (G.Wilford@ee.surrey.ac.uk)