Manpages

名 前

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 デ バ ッ グ モ ー ド を 有 効 に し 、 内 部 の 処 理 ス テ ッ プ を い く ら か 表 示 す る 。

関 連 項 目

emacs(1), info(1), gzip(1).

著 作 権

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>