20.2.5 install-infoの呼び出し

install-infoは，InfoファイルからInfoシステムのトップレベルの dirファイルにメニュー項目を挿入します(dirファイルの動作の 説明は，前のセクションを参照してください)．それは，ソフトウェアのインス トールの一部として，またシステムのマニュアル全体に対し，dirファイ ルを構築するときよく実行されます．構文は以下のようになります．

     install-info [option]... [info-file [dir-file]]

info-fileやdir-fileを指定しない場合，(以下で述べる)それらを 定義するオプションが必要です．コンパイル時のデフォルトは無く，標準入力は 使用しません．install-infoは，呼び出し毎に一つのInfoファイルのみ 読み込み，一つのdirにのみ書き込みます．

dir-file(が指定されていても)存在しない場合，install-infoは (項目の無い)dir-fileを可能な場合は作成します．

入力ファイルが，gzipで圧縮されている場合(see Invoking gzip)，install-infoは自動的に読み込みのために解凍し ます．そして，dir-fileが圧縮されている場合も，install-info は自動的に変更を書き込んだ後，圧縮された状態にします．dir-file自身 が無い場合，install-infoはdir-file.gzを開こうとしま す．

オプションです．

--delete

dir-fileからinfo-fileの項目を削除します．dir-fileの項 目のファイル名はinfo-fileにする必要があります(その中の，オプション の`.info'は例外です)．新しい項目は挿入しません．

--dir-file=name

-d name

Infoディレクトリファイルのファイル名を指定します．これは，dir-file 引数を使用することと同じです．

--entry=text

-e text

Infoディレクトリ項目としてtextを挿入します．textは，Infoメ ニュー項目行にゼロ以上の空白で始まる行を追加した書式にすべきです．一つ以 上の項目を指定する場合，全て追加されます．項目を指定しない場合，Infoファ イル自身の情報から決定します．

--help

-h

基本的な使用方と，利用可能な全てのオプションをリストアップした使用方法メッ セージを表示し，正しく終了します．

--info-file=file

-i file

ディレクトリにインストールするInfoファイルを指定します．info-file 引数の使用と同じです．

--info-dir=dir

-D dir

dirが位置するディレクトリを指定します． `--dir-file=dir/dir'と同じです．

--item=text

`--entry=text'と同じです．Infoディレクトリ項目は，実際にはメ ニュー項目です．

--quiet

警告を抑制します．

--remove

-r

`--delete'と同じです．

--section=sec

-s sec

このファイルの項目を，ディレクトリのセクションsecに書きます．一つ以 上のセクションを指定した場合，Infoファイル自身の情報から決定されます．

--version

-V

バージョン情報を表示し，正しく終了します．