.\" 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) .\" .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH APROPOS 1 2022-02-10 2.10.1 マニュアルページユーティリティー .SH 名前 apropos \- マニュアルページの名前と要約文を検索する .SH 書式 \fBapropos\fP [\|\fB\-dalv?V\fP\|] [\|\fB\-e\fP\||\|\fB\-w\fP\||\|\fB\-r\fP\|] [\|\fB\-s\fP \fIlist\fP\|] [\|\fB\-m\fP \fIsystem\fP\|[\|,.\|.\|.\|]\|] [\|\fB\-M\fP \fIpath\fP\|] [\|\fB\-L\fP \fIlocale\fP\|] [\|\fB\-C\fP \fIfile\fP\|] \fIkeyword\fP \&.\|.\|. .SH 説明 各マニュアルページには短い要約文が含まれています。 \fBapropos\fP はそのマニュアルページの要約内にある \fIkeyword\fP を検索します。 \fIkeyword\fP は通常は (\fB\-r\fP を指定した時のように) 正規表現として扱われますが、 \fB\-w\fP を指定してワイルドカードを含めたり、 \fB\-e\fP を指定して厳密に keyword に一致させたりすることもできます。これらのオプションを使用する場合には、シェルの解釈を抑止するために \fIkeyword\fP を引用符で囲むか、特殊文字をエスケープ (\e) する必要があります。 標準の一致処理ルールではページ名や要約文内の単語境界にも一致させることができます。 \fBapropos\fP によって検索されるデータベースは \fBmandb\fP プログラムによって更新されます。インストール方法によりますが、cron ジョブとして \fBmandb\fP が定期的に実行されているかもしれませんし、マニュアルページをインストール時に \fBmandb\fP を手動で実行する必要があるかもしれません。 .SH オプション .TP .if !'po4a'hide' .BR \-d ", " \-\-debug デバッグ情報を表示します。 .TP .if !'po4a'hide' .BR \-v ", " \-\-verbose 冗長な警告メッセージを表示します。 .TP .if !'po4a'hide' .BR \-r ", " \-\-regex 各 keyword を正規表現として解釈します。これはデフォルトの動作です。ページ名と要約文に対してそれぞれ独立して keyword の一致処理が行われます。一致処理は両者のどの部分も対象になります。一致処理は単語境界に限定されません。 .TP .if !'po4a'hide' .BR \-w ", " \-\-wildcard 各 keyword をシェル形式のワイルドカードを含むパターンとして解釈します。ページ名と要約文に対してそれぞれ独立して一致処理が行われます。 \fB\-\-exact\fP も併せて指定した場合、展開された keyword が要約文またはページ名全体に一致した場合のみ一致したと判定されます。指定しない場合、 keyword は要約文内の単語境界に対しても一致処理が行われます。 .TP .if !'po4a'hide' .BR \-e ", " \-\-exact 各 keyword はページ名と要約文に対して厳密に一致処理が行われます。 .TP .if !'po4a'hide' .BR \-a ", " \-\-and 与えた keyword 全てに一致したページのみ表示します。デフォルトはいずれかに一致するページを表示します。 .TP .if !'po4a'hide' .BR \-l ", " \-\-long 出力を端末幅で切り詰めません。通常は、適切に書かれていない \fB名前\fP (\fBNAME\fP) 節による見にくさを避けるために出力が端末の幅に切り詰められます。 .TP \fB\-s\fP \fIlist\/\fP, \fB\-\-sections=\fP\fIlist\/\fP, \fB\-\-section=\fP\fIlist\fP 指定したマニュアルセクションのみ検索します。 \fIlist\fP はコロンまたはコンマで区切られたセクションのリストです。もし、 \fIlist\fP の項目が単純なセクション、例えば "3" ならば、表示される説明のリストには "3"、 "3perl"、 "3x" 等のセクションのページが含まれます。一方 \fIlist\fP に拡張部分も含める、例えば "3perl" ならば、表示される説明のリストはマニュアルセクションに厳密に一致したページのみ含まれるようになります。 .TP \fB\-m\fP \fIsystem\fP\|[\|,.\|.\|.\|]\|, \fB\-\-systems=\fP\fIsystem\fP\|[\|,.\|.\|.\|] If this system has access to other operating systems' manual page descriptions, they can be searched using this option. To search NewOS's manual page descriptions, use the option \fB\-m\fP \fBNewOS\fP. \fIsystem\fP にはコンマで区切ったオペレーティングシステム名の組み合わせを指定できます。現在のオペレーティングシステムの \fBwhatis\fP を検索に含めるためにはシステム名として \fBman\fP を引数に含めます。このオプションは $\fBSYSTEM\fP 環境変数を上書きします。 .TP \fB\-M\ \fP\fIpath\fP,\ \fB\-\-manpath=\fP\fIpath\fP 検索するマニュアルページ階層を変更する場合、その集合をコロンで区切って指定します。デフォルトでは、\fBapropos\fP は $\fBMANPATH\fP 環境変数を使用します。 $\fBMANPATH\fP 環境変数が空であるか、設定されていない場合、$\fBPATH\fP 環境変数に応じて適切なマニュアルページのパスが決定されます。このオプションは $\fBMANPATH\fP の内容を上書きします。 .TP \fB\-L\ \fP\fIlocale\fP,\ \fB\-\-locale=\fP\fIlocale\fP \fBapropos\fP は通常、現在のロケールを C の関数 \fBsetlocale\fP(3) を呼び出すことによって決定します。これはおそらく $\fBLC_MESSAGES\fP や $\fBLANG\fP などを含むさまざまな環境変数を使用します。一時的にこの値を上書きしたい場合には、このオプションを使用して \fBapropos\fP に直接 \fIlocale\fP 文字列を渡します。これはページの検索が実際に開始されるまでは効果が無いことに注意してください。ヘルプメッセージなどは常に初期に決定されたロケールによって表示されます。 .TP \fB\-C\ \fP\fIfile\fP,\ \fB\-\-config\-file=\fP\fIfile\fP デフォルトの \fI~/.manpath\fP ではなく指定したユーザ設定ファイルを使用します。 .TP .if !'po4a'hide' .BR \-? ", " \-\-help ヘルプメッセージを表示して終了します。 .TP .if !'po4a'hide' .B \-\-usage Print a short usage message and exit. .TP .if !'po4a'hide' .BR \-V ", " \-\-version バージョン情報を表示します。 .SH 終了ステータス .TP .if !'po4a'hide' .B 0 プログラムが正常に実行されました。 .TP .if !'po4a'hide' .B 1 使用法、構文または設定ファイルのエラーです。 .TP .if !'po4a'hide' .B 2 操作のエラーです。 .TP .if !'po4a'hide' .B 16 指定したキーワードにマッチしたページが見つかりませんでした。 .SH 環境変数 .TP .if !'po4a'hide' .B SYSTEM $\fBSYSTEM\fP が設定されている場合、 \fB\-m\fP オプションで指定した引数と同様の効果があります。 .TP .if !'po4a'hide' .B MANPATH $\fBMANPATH\fP が設定されている場合、その値はコロン区切りのマニュアルページ階層の検索パスとして使用されます。 See the \fBSEARCH PATH\fP section of \fBmanpath\fP(5) for the default behaviour and details of how this environment variable is handled. .TP .if !'po4a'hide' .B MANWIDTH If $\fBMANWIDTH\fP is set, its value is used as the terminal width (see the \fB\-\-long\fP option). If it is not set, the terminal width will be calculated using the value of $\fBCOLUMNS\fP, and \fBioctl\fP(2) if available, or falling back to 80 characters if all else fails. .TP .if !'po4a'hide' .B POSIXLY_CORRECT $\fBPOSIXLY_CORRECT\fP が設定されている場合、値が空であったとしても、 \fBapropos\fP はデフォルトで拡張正規表現 (\fB\-r\fP) を使用して検索します。今日ではこの動作が常にデフォルトです。 .SH ファイル .TP .if !'po4a'hide' .I /usr/share/man/index.(bt\^|\^db\^|\^dir\^|\^pag) 伝統的な大域\fIインデックス型\fPデータベースキャッシュです。 .TP .if !'po4a'hide' .I /var/cache/man/index.(bt\^|\^db\^|\^dir\^|\^pag) FHS 準拠の大域\fIインデックス型\fPデータベースキャッシュです。 .TP .if !'po4a'hide' .I /usr/share/man/\|.\|.\|.\|/whatis 伝統的な \fBwhatis\fP テキスト型データベースです。 .SH 関連項目 .if !'po4a'hide' .BR man (1), .if !'po4a'hide' .BR whatis (1), .if !'po4a'hide' .BR mandb (8) .SH 著者 .nf .if !'po4a'hide' Wilf.\& (G.Wilford@ee.surrey.ac.uk). .if !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org). .if !'po4a'hide' Colin Watson (cjwatson@debian.org). .fi .SH バグ .if !'po4a'hide' https://gitlab.com/cjwatson/man-db/-/issues .br .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db