GETNAME(8)

名称
getNAME - whatis/apropos 用のデータベースを作るために、マニュアルのソースから NAME セクションを得る

書式
[-itvw] path [path ...]

解説
getNAME ユーティリティは、マニュアルの名前を見つけるために、 そのマニュアルのソースの中身を調べます。 目次を作ったり、マニュアルのスタイルを調べたり、 マニュアルのイントロダクションを作るのに利用できます。 デフォルトでは、 getNAME は apropos(1) データベース用のデータを出力します。 getNAME は makewhatis(8) やその他のマニュアル処理ツールから呼ばれることを想定して設計されており、 直接利用することは想定していません。

オプション
以下のオプションが利用可能です:

-i  -i オプションは、 マニュアルのイントロダクションを作る場合に便利な情報を出力します。 例は intro(1) や intro(2) などを参照してください。

-t  -t オプションは、目次を作る場合に便利な情報を出力します。

-v  マニュアルのフォーマットが正しくない場合に警告を発します。

-w  -w オプションを指定すると、そのマニュアルが 伝統的な man スタイル (“OLD”), 新しい mandoc スタイル (“NEW”), その他不明なスタイル (“UNKNOWN”) のどれを使っているかを判定します。

歴史
getNAME コマンドは 2.0BSD で初めて登場しました。

バグ
getNAME が圧縮されたマニュアルやフォーマット済みのマニュアルを扱えればいいのですが…。 一致判定部分では .S[Hh] NAME を見ていますが、他の言語で書かれたマニュアルでは だめでしょう。

関連項目
man(1), catman(8), makewhatis(8)