名 前
install−info − Info デ ィ レ ク ト リ に エ ン ト リ を 作 成 し た り 更 新 し た り す る
書 式
install−info [−−version] [−−help] [−−debug] [−−maxwidth=nnn] [−−section regexp title] [−−infodir=xxx] [−−align=nnn] [−−quiet] [−−menuentry=xxx] [−−description=xxx] [−−remove|−−remove−exactly] [−−] filename
説 明
install−info は 、 Info デ ィ レ ク ト リ の dir フ ァ イ ル に エ ン ト リ を 作 成 ・ 更 新 ・ 削 除 す る 。 作 成 か 更 新 の 場 合 、 コ マ ン ド ラ イ ン に も Info フ ァ イ ル に も 説 明 文 が 指 定 さ れ て い な か っ た ら 、 フ ァ イ ル の 中 身 か ら 説 明 文 を 推 測 し よ う と す る 。 エ ン ト リ の 置 か れ る 位 置 や dir フ ァ イ ル の 望 ま し い 形 式 の 説 明 に つ い て は 、 −−section の 記 述 を 見 ら れ よ 。
オ プ シ ョ ン
[−−] filename メ ニ ュ ー エ ン ト リ を 作 成 ・ 更 新 ・ 削 除 し た い Info フ ァ イ ル の フ ァ イ ル 名 を 与 え る 。 −−remove−exactly が 指 定 さ れ た 場 合 は 、 filename は 削 除 対 象 の 正 確 な エ ン ト リ 名 (例 え ば "emacs−20/emacs" と か "gcc") で な け れ ば な ら な い 。 指 定 さ れ な か っ た 場 合 は 、 こ の フ ァ イ ル 名 の ベ ー ス ネ ー ム が 作 成 さ れ る メ ニ ュ ー エ ン ト リ の リ フ ァ レ ン ス と し て 使 わ れ る (た だ し そ の フ ァ イ ル の 内 部 で START−INFO−DIR に よ る 上 書 き が さ れ て い る 場 合 は 除 く )。 従 っ て こ の フ ァ イ ル は dir フ ァ イ ル と 同 じ デ ィ レ ク ト リ に 存 在 し て い な け れ ば な ら な い 。 あ る い は 、 ほ ぼ イ ン ス ト ー ル さ れ て い る か 、 エ ン ト リ 削 除 の 場 合 は 以 前 存 在 し て い た か 、 で な け れ ば な ら な い 。 −−infodir オ プ シ ョ ン を 参 照 せ よ 。
filename が .gz で 終 わ っ て い た ら 、 GNU gzip で 圧 縮 さ れ て い る フ ァ イ ル で あ る と み な さ れ る 。 filename は 存 在 し な い が こ れ に 対 応 す る filename.gz が 存 在 す る 場 合 は 、 替 わ り に filename.gz が 使 わ れ る 。 エ ン ト リ を 追 加 か 更 新 す る と き は 、 フ ァ イ ル (拡 張 子 .gz が 付 加 的 に 付 い て い る か も し れ な い )は 指 定 さ れ た パ ス に 存 在 し て い な け れ ば な ら な い 。
−−remove フ ァ イ ル filename の エ ン ト リ を 削 除 す る こ と を 指 定 す る 。 デ フ ォ ル ト で は エ ン ト リ は 作 成 も し く は 更 新 さ れ る 。 削 除 の 結 果 セ ク シ ョ ン が 空 っ ぽ に な る 場 合 、 こ れ が フ ァ イ ル の 最 後 の セ ク シ ョ ン で な い か −−keep−old が 指 定 さ れ る か し て い な か っ た ら 、 セ ク シ ョ ン 見 出 し も 同 様 に 削 除 さ れ る 。 dir フ ァ イ ル の 望 ま し い 形 式 の 説 明 に つ い て は 、 −−section の 記 述 を 見 ら れ よ 。 あ て は ま る エ ン ト リ が dir フ ァ イ ル に い く つ か あ る 場 合 、 最 初 に マ ッ チ し た カ テ ゴ リ グ ル ー プ の も の が 削 除 さ れ 、 残 り は 無 視 さ れ る 。
install−info は −−quiet オ プ シ ョ ン が 指 定 さ れ な い 限 り 警 告 を 発 す る が 、 こ の オ プ シ ョ ン に つ い て は 、 あ て は ま る エ ン ト リ が 見 つ か ら な く て も エ ラ ー に は な ら な い 。
−−remove オ プ シ ョ ン が 指 定 さ れ た 場 合 、 −−maxwidth, −−align, −−calign の 整 形 オ プ シ ョ ン は 無 視 さ れ る 。
−−remove−exactly
こ の オ プ シ ョ
ン は 基 本 的 に
は −−remove と 同
じ だ が 、 た だ
し filename を 削 除 対
象 と な る 既 存
の フ ァ イ ル と
し て で は な く
、 削 除 対 象 の
エ ン ト リ そ の
も の と み な す
。 こ の 違 い は
、 サ ブ デ ィ レ
ク ト リ の info フ ァ
イ ル を 参 照 し
て い る エ ン ト
リ (例 え ば
"emacs−20/emacs" な ど )
を 削 除 し よ う
と す る 場 合 に
重 要 と な る 。
な ぜ な ら
−−remove は 与 え
ら れ た filename そ の
も の で は な く
、 そ の ベ ー ス
ネ ー ム に 作 用
す る か ら で あ
る (つ ま り
−−remove "emacs−20/emacs"
と す る と 、
install−info は
"emacs−20/emacs" で は な
く "emacs" を 対 象
と す る )。
−−section regexp title 新
し い エ ン ト リ
を 作 る と き に
、 dir フ ァ イ ル
の 中 で タ イ ト
ル が regexp に マ ッ
チ す る セ ク シ
ョ ン に 配 置 す
る こ と を 指 定
す る 。 該 当 す
る セ ク シ ョ ン
が 存 在 し な か
っ た ら 、 フ ァ
イ ル の 最 後 か
ら 二 番 目 の セ
ク シ ョ ン (後 述
)と し て title と い
う タ イ ト ル で
作 ら れ る 。 セ
ク シ ョ ン と は
dir メ ニ ュ ー の
中 の 一 部 で 、
空 白 行 で 区 切
ら れ た も の で
あ る 。 セ ク シ
ョ ン の 先 頭 行
は タ イ ト ル と
し て 扱 わ れ る
。 新 た な エ ン
ト リ を 作 る と
き 、 install−info は
セ ク シ ョ ン の
中 で ア ル フ ァ
ベ ッ ト 順 に そ
れ を 挿 入 し よ
う と す る 。 セ
ク シ ョ ン 中 の
エ ン ト リ が あ
ら か じ め ソ ー
ト さ れ て い な
か っ た ら 、 セ
ク シ ョ ン 中 の
位 置 は 予 測 で
き な い 。 す で
に 存 在 す る エ
ン ト リ の 順 番
は 変 更 さ れ な
い 。 デ フ ォ ル
ト で は 新 た な
エ ン ト リ を フ
ァ イ ル の 終 わ
り に 付 け 加 え
る 。 最 後 の セ
ク シ ョ ン は 、
タ イ ト ル 行 だ
け で あ っ て も
常 に 存 在 し て
い な け ら ば な
ら な い 。 こ れ
は 新 た な セ ク
シ ョ ン が 正 し
い 場 所 に 作 ら
れ る よ う に す
る た め で あ る
。 最 後 の セ ク
シ ョ ン は 、 位
置 が 正 し く 指
定 さ れ て い な
い Info フ ァ イ ル が
そ こ に 付 け 加
え ら れ る よ う
に タ イ ト ル を
付 け な け れ ば
な ら な い 。
Info フ ァ イ ル の エ ン ト リ が す で に イ ン ス ト ー ル さ れ て い た ら 、 そ の 位 置 で 新 た な エ ン ト リ に 置 き 換 え ら れ る 。 エ ン ト リ 削 除 時 に セ ク シ ョ ン を 指 定 す る と 、 セ ク シ ョ ン は 無 視 さ れ 警 告 が 発 せ ら れ る 。 エ ン ト リ を 加 え る と き に セ ク シ ョ ン が 必 要 と な る に も か か わ ら ず フ ァ イ ル に セ ク シ ョ ン 見 出 し が 一 つ も な か っ た ら 、 install−info は 必 要 と な る セ ク シ ョ ン と フ ァ イ ル の 終 わ り の Miscellaneous と い う セ ク シ ョ ン と の 両 方 を 作 る 。
−−infodir=infodir
dir フ ァ イ ル と 、 イ ン ス ト ー ル さ れ る 新 た な Info フ ァ イ ル の コ ピ ー と が infodir に あ る こ と を 指 定 す る 。 デ フ ォ ル ト は /usr/share/info/ で あ る 。
−−align=nnn
[非 推 奨 ] 説 明
文 の 最 初 の 行
を 少 な く と も
nnn 字 だ け 字 下
げ す べ き も の
と 指 定 す る 。
余 分 な 空 白 が
必 要 な も の と
し て 加 え ら れ
る 。 dir の メ ニ
ュ ー エ ン ト リ
の 詳 細 の 長 さ
の た め 、 よ り
多 く の オ フ セ
ッ ト が 必 要 か
も し れ な い 。
デ フ ォ ル ト は 27
で あ る 。
−−calign=nnn [非 推
奨 ] 説 明 文 の 二
行 目 以 降 の 行
を 少 な く と も
nnn だ け 字 下 げ
す べ き も の と
指 定 す る 。 デ
フ ォ ル ト は 29 で
あ る 。
−−maxwidth=nnn [非 推
奨 ]
Info フ ァ イ ル の 最 大 幅 を nnn に す る 。 説 明 文 を ワ ー ド ラ ッ プ す る と き に 使 わ れ る 。 デ フ ォ ル ト は 79 で あ る 。
−−quiet 挿 入 さ れ る 直 前 の 新 た な メ ニ ュ ー エ ン ト リ と 、 現 存 す る エ ン ト リ の 置 換 ・ 削 除 や セ ク シ ョ ン の 作 成 ・ 削 除 の 案 内 の メ ッ セ ー ジ を 表 示 し な い 。
−−help |
install−info の 使 用 法 を 表 示 し て 終 了 す る 。 |
−−version
install−info の バ ー ジ ョ ン と 著 作 権 の 情 報 を 表 示 し て 終 了 す る 。
−−description=xxx 新 規 ・ 更 新 の メ ニ ュ ー エ ン ト リ の 説 明 文 を xxx と す る 。 デ フ ォ ル ト で は Info フ ァ イ ル 自 身 の 中 で 指 定 さ れ た 値 を 使 う 。 こ れ は 次 の よ う な 形 式 の セ ク シ ョ ン を 探 す こ と で 見 つ け ら れ る 。
START−INFO−DIR−ENTRY
* Auto−PGP: (auto−pgp). PGP under GNU Emacs.
END−INFO−DIR−ENTRY
Info フ ァ イ ル に 見 つ か っ た エ ン ト リ 自 身 が そ れ だ け で 数 行 に 渡 り 、 そ れ ぞ れ に メ ニ ュ ー の エ ン ト リ が あ る 場 合 、 フ ァ イ ル の 中 に 見 つ か っ た テ キ ス ト が そ の ま ま 使 わ れ る 。 こ の と き は 、 ア ル フ ァ ベ ッ ト 順 の 配 置 は 行 わ れ ず 、 エ ン ト リ は 問 い 合 わ せ の セ ク シ ョ ン の 先 頭 に 挿 入 さ れ る 。 ま た −−menuentry, −−maxwidth, −−align, −−calign, −−menuentry の オ プ シ ョ ン は 無 視 さ れ る 。 フ ァ イ ル に dir エ ン ト リ が な か っ た ら 、 フ ァ イ ル の 最 初 の ほ う に this file documents で 始 ま る 段 落 が な い か を 見 つ け よ う と す る 。 そ の 後 の 最 初 の 文 字 を 大 文 字 に し て そ れ を 使 う 。 こ れ ら の 方 法 で 説 明 文 を 得 る こ と が で き な か っ た ら エ ラ ー に な る 。
−−remove が 指 定 さ れ た と き に は 説 明 文 の 引 数 が 与 え ら れ て も 無 視 さ れ 、 警 告 が 発 せ ら れ る 。
−−menuentry=xxx
メ ニ ュ ー の 中
の エ ン ト リ を
xxx と す る 。 デ
フ ォ ル ト で は
、 Info フ ァ イ ル 自
身 の 中 で 指 定
さ れ た 値 を 使
う 。 そ れ が な
か っ た 場 合 は
、 Info フ ァ イ ル の
ベ ー ス ネ ー ム
が 使 わ れ る 。
.info が 取 り 除 か
れ 、 大 文 字 小
文 字 混 在 の エ
ン ト リ 名 が 作
ら れ る 。 Info フ ァ
イ ル の メ ニ ュ
ー エ ン ト リ の
望 ま し い 形 式
の 説 明 に つ い
て は 、 上 記 の
記 述 を 参 照 さ
れ た い 。 エ ン
ト リ を 削 除 す
る と き 、
−−menuentry オ プ シ
ョ ン の 値 は 、
削 除 さ れ る メ
ニ ュ ー ア イ テ
ム の 実 際 の メ
ニ ュ ー エ ン ト
リ フ ィ ー ル ド
と 一 致 し な け
れ ば な ら な い
。 −−menuentry を 省
略 し た と き は
、 メ ニ ュ ー エ
ン ト リ の チ ェ
ッ ク は 行 わ れ
な い 。
−−keep−old 現 存 す
る エ ン ト リ の
置 換 や 空 セ ク
シ ョ ン の 削 除
を 行 わ な い 。
す で に イ ン ス
ト ー ル さ れ て
い る フ ァ イ ル
が デ ィ レ ク ト
リ に エ ン ト リ
を 持 っ て い る
場 合 、 古 い エ
ン ト リ は 置 き
換 え ら れ ず そ
の ま ま 残 る 。
デ フ ォ ル ト で
は 、 古 い エ ン
ト リ は い ず れ
も 新 規 作 成 さ
れ た も の に よ
っ て 置 き 換 え
ら れ る 。
−−remove が 指 定 さ れ て い る 場 合 、 削 除 の 結 果 セ ク シ ョ ン が 空 っ ぽ に な る か も し れ な い が 、 −−keep−old は セ ク シ ョ ン 見 出 し を 削 除 し な い 。
−−test テ ス ト モ ー ド を 有 効 に し 、 デ ィ レ ク ト リ フ ァ イ ル を 更 新 し な い 。 |
−−debug デ バ ッ グ モ ー ド を 有 効 に し 、 内 部 の 処 理 ス テ ッ プ を い く ら か 表 示 す る 。
関 連 項 目
著 作 権
Copyright 1994, Ian Jackson. install−info is free software; see the GNU General Public Licence version 2 or later for copying conditions. There is no warranty.
翻 訳 者
関 戸 幸 一 <sekido [AT] mbox.jp>