名 前
dh_installman − パ ッ ケ ー ジ ビ ル ド デ ィ レ ク ト リ 以 下 に man ペ ー ジ を イ ン ス ト ー ル す る
書 式
dh_installman [debhelper options] [manpage ...]
説 明
dh_installman は 、 パ ッ ケ ー ジ ビ ル ド デ ィ レ ク ト リ 内 の 正 し い 位 置 に man ペ ー ジ を イ ン ス ト ー ル す る d ebhelper プ ロ グ ラ ム で す 。 パ ッ ケ ー ジ に ど ん な man ペ ー ジ が 入 っ て い る か を 指 定 す る と 、 各 man ペ ー ジ に 記 載 さ れ て い る .TH や .Dt 行 に あ る 章 番 号 に 基 づ き man ペ ー ジ を ど こ に イ ン ス ト ー ル す れ ば 良 い か を 見 つ け 出 し ま す 。 書 式 ど お り の 正 し い .TH や .Dt が あ れ ば 、 そ の man ペ ー ジ は 正 し い デ ィ レ ク ト リ に 、 正 し い 名 前 で イ ン ス ト ー ル さ れ ま す (こ れ は 、 例 え ば 3perlで あ れ ば 、 適 切 な サ ブ セ ク シ ョ ン に 対 す る man ペ ー ジ と し て 扱 わ れ 、 man3 以 下 に イ ン ス ト ー ル さ れ 、 .3perl と い う 拡 張 子 が 与 え ら れ る と い う 事 も 含 み ま す )。 も し 、 .TH や .Dt が 間 違 っ て い た り 、 あ る い は な か っ た り し た 場 合 、 プ ロ グ ラ ム は イ ン ス ト ー ル し よ う と し て い る man ペ ー ジ の フ ァ イ ル の 拡 張 子 か ら 、 間 違 っ た 判 断 を す る 可 能 性 が あ り ま す 。 こ の コ マ ン ド は 翻 訳 さ れ た man ペ ー ジ に つ い て も 、 .ll.8 や .ll_LL.8 の 拡 張 子 に 持 つ フ ァ イ ル を 探 す 事 に よ り 、 あ る い は 、 −−language を 指 定 す る こ と に よ っ て 扱 い ま す 。
dh_installman が 間 違 っ た 章 番 号 や 、 間 違 っ た 拡 張 子 を つ け て man ペ ー ジ を イ ン ス ト ー ル す る よ う に 見 え る と き が あ り ま す 。 こ れ は 、 man ペ ー ジ が 間 違 っ た 章 番 号 を .TH や .Dt 行 に 列 挙 し て い る の が 原 因 で す 。 こ の 場 合 、 man ペ ー ジ を 編 集 し て 、 章 番 号 を 正 し く す れ ば 、 dh_installman は 意 図 ど お り に 動 作 す る よ う に な り ま す 。 .TH 章 に つ い て の 詳 細 は man(7) を 参 照 く だ さ い 。 さ ら に 、 .Dt 章 に つ い て は 、 mdoc(7) を 参 照 く だ さ い 。 ま た 、 dh_installman が /usr/share/man/pl/man1/ の よ う な デ ィ レ ク ト リ へ man ペ ー ジ を イ ン ス ト ー ル し て し ま う 場 合 が あ り ま す 。 こ れ は 、 パ ッ ケ ー ジ に F <foo.pl> の よ う な 名 前 を 持 つ フ ァ イ ル が あ り 、 dh_installman が こ れ を ポ ー ラ ン ド 語 へ の 翻 訳 済 み man ペ ー ジ と 勘 違 い す る 時 と な り ま す 。 こ の 動 作 を 避 け る に は 、 −−language=C を 利 用 し て く だ さ い 。
dh_installman は 、 man ペ ー ジ を イ ン ス ト ー ル し た 後 に 、 処 理 を 行 っ た パ ッ ケ ー ジ 内 の 一 時 デ ィ レ ク ト リ 以 下 に あ る 全 man ペ ー ジ を 対 象 に 、 .so リ ン ク を 含 む か ど う か を 確 認 し ま す 。 も し 存 在 す る よ う で あ れ ば 、 そ の man ペ ー ジ 本 体 を シ ン ボ リ ッ ク リ ン ク へ 変 更 し ま す 。 ま た 、 dh_installman は man コ マ ン ド を 使 っ て 、 man ペ ー ジ の 文 字 コ ー ド を 推 定 し 、 UTF−8 に 変 換 し ま す 。 こ の 推 定 作 業 は 失 敗 に 終 わ る 事 が あ る の で 、 文 字 コ ー ド 宣 言 文 を 使 っ て 検 出 さ れ る べ き 文 字 コ ー ド の 情 報 を 上 書 き で き ま す 。 詳 細 に つ い て は manconv(1) を 参 照 く だ さ い 。
フ ァ イ ル
debian/package.manpages イ ン ス ト ー ル さ れ る べ き man ペ ー ジ を 列 挙 し た も の で す 。
オ プ シ ョ ン
−A,
−−all 全 パ ッ ケ
ー ジ に 対 し て
、 コ マ ン ド ラ
イ ン パ ラ メ ー
タ に 指 定 さ れ
た フ ァ イ ル を
全 て イ ン ス ト
ー ル し ま す 。
−−language=ll 処 理
予 定 の man ペ ー ジ
が ど ん な 言 語
で 記 載 さ れ て
い る か を こ ち
ら の オ プ シ ョ
ン を 使 っ て 指
定 し ま す 。
manpage ... 最 初 に 処 理
す る パ ッ ケ ー
ジ に こ れ ら の man
ペ ー ジ を イ ン
ス ト ー ル し ま
す (あ る い は 、
−A が 指 定 さ れ
た 場 合 は 、 全
パ ッ ケ ー ジ に
イ ン ス ト ー ル
を 行 い ま す )
付 記
本 プ ロ グ ラ ム の 昔 の バ ー ジ ョ ン の プ ロ グ ラ ム で あ る dh_installmanpages(1) を 未 だ に 利 用 し て い る パ ッ ケ ー ジ が 存 在 し ま す 。 ま た 、 dh_installmanpages(1) は 未 だ に debhelper に 梱 包 さ れ て い ま す 。 し か し な が ら 、 こ の プ ロ グ ラ ム は 、 非 直 感 的 で 統 一 さ れ て い な い イ ン タ ー フ ェ ー ス の 為 に 、 す で に 廃 止 と な っ て い ま す 。 代 わ り に 本 プ ロ グ ラ ム を 使 っ て く だ さ い 。
参 照
debhelper(7) こ の プ ロ グ ラ ム は debhelper の 一 部 で す 。
作 者
Joey Hess <joeyh [AT] debian.org>