Manpages

名 称

groff − groff ド キ ュ メ ン ト フ ォ ー マ ッ ト シ ス テ ム の フ ロ ン ト エ ン ド

書 式

groff−abeghilpstvzCEGNRSUVXZ ] [ −wname ] [ −Wname ] [ −mname ] [ −Fdir ] [ −Idir ] [ −Tdev ] [ −ffam ] [ −Mdir ] [ −dcs ] [ −rcn ] [ −nnum ] [ −olist ] [ −Parg ] [ −Larg ] [ files... ] コ マ ン ド ラ イ ン オ プ シ ョ ン と パ ラ メ ー タ の 間 に 空 白 を 含 め る こ と が 可 能 で す 。

解 説

groff は 、 groff ド キ ュ メ ン ト フ ォ ー マ ッ ト シ ス テ ム の フ ロ ン ト エ ン ド プ ロ グ ラ ム で す 。 通 常 grofftroff を 実 行 し 、 そ の 出 力 を 指 定 さ れ た デ バ イ ス で 扱 う た め の 後 処 理 プ ロ グ ラ ム を 実 行 し ま す 。 利 用 可 能 な デ バ イ ス は 以 下 の と お り で す :

ps

PostScript プ リ ン タ や プ レ ビ ュ ア 。

dvi

TeX の dvi フ ォ ー マ ッ ト 。

X75

75dpi の X11 プ レ ビ ュ ア 。

X100

100dpi の X11 プ レ ビ ュ ア 。

ascii

タ イ プ ラ イ タ に 似 た 特 性 を 持 つ デ バ イ ス 。

ascii8 タ イ プ ラ イ タ に 似 た 特 性 を 持 つ デ バ イ ス 。

ascii と は 異 な り 、 こ の デ

バ イ ス は 8 ビ ッ ト ク リ ー ン で す 。 こ の デ バ イ ス は ASCII や ISO-8859-1 以 外 の 文 字 集 合 で の 使 用 を 想 定 し て い ま す 。

latin1

ISO Latin-1 (ISO 8859-1) 文 字 集 合 を 利 用 す る タ イ プ ラ イ タ に 似 た 特 性 を 持 つ デ バ イ ス 。

utf8

UTF-8 エ ン コ ー デ ィ ン グ の Unicode (ISO 10646) 文 字 集 合 を 利 用 す る タ イ プ ラ イ タ に 似 た 特 性 を 持 つ デ バ イ ス 。

cp1047

EBCDIC コ ー ド ペ ー ジ IBM cp1047 を 利 用 す る タ イ プ ラ イ タ に 似 た 特 性 を 持 つ デ バ イ ス (例 え ば OS/390 Unix)。

lj4

HP LaserJet4 互 換 (ま た は 他 の PCL5 互 換 ) プ リ ン タ 。 lbp Canon CAPSL プ リ ン タ 用 (LBP-4 と LBP-8 シ リ ー ズ の レ ー ザ プ リ ン タ )。

html

HTML 出 力 を 行 い ま す 。

指 定 さ れ た デ バ イ ス 用 の 後 処 理 を 行 う プ ロ グ ラ ム は 、 デ バ イ ス 記 述 フ ァ イ ル の postpro コ マ ン ド に よ り 指 定 さ れ て い ま す 。 こ れ は −X オ プ シ ョ ン に よ り 変 更 で き ま す 。 デ フ ォ ル ト の デ バ イ ス は ps で す 。 pic, eqn, grn, grap, tbl, refer, soelim の 任 意 の 前 処 理 を 行 わ せ る こ と も で き ま す 。 引 数 を 伴 わ な い オ プ シ ョ ン は の あ と に ま と め て 続 け る こ と が で き ま す 。 フ ァ イ ル 名 の か わ り に 用 い ら れ る は 標 準 入 力 を 意 味 し ま す 。

grog コ マ ン ド を 用 い て ド キ ュ メ ン ト を 正 し く フ ォ ー マ ッ ト す る た め の groff コ マ ン ド を 調 べ る こ と が で き ま す 。

オ プ シ ョ ン

−h ヘ ル プ メ ッ セ ー ジ を 表 示 し ま す 。

−e

eqn を 使 っ て 前 処 理 を 行 い ま す 。

−t

tbl を 使 っ て 前 処 理 を 行 い ま す 。

−g

grn を 使 用 し て 前 処 理 を 行 い ま す 。

−G

grap を 使 用 し て 前 処 理 を 行 い ま す 。

−p

pic を 使 っ て 前 処 理 を 行 い ま す 。

−s

soelim を 使 っ て 前 処 理 を 行 い ま す 。

−Idir

こ の オ プ シ ョ ン は soelim(1) に 記 述 さ れ て い ま す 。 こ の オ プ シ ョ ン は −s オ プ シ ョ ン を 暗 黙 的 に 指 定 し ま す 。
−R

refer を 使 っ て 前 処 理 を 行 い ま す 。 refer に 引 数 を 渡 す 機 構 は 用 意 さ れ て い ま せ ん 。 refer の ほ と ん ど の オ プ シ ョ ン は 、 フ ァ イ ル 中 に 記 述 す る こ と が で き る 等 価 な コ マ ン ド を 備 え て い る か ら で す 。 詳 し く は refer(1) の マ ニ ュ ア ル を 参 照 し て く だ さ い 。

−v

groff か ら 起 動 さ れ る プ ロ グ ラ ム の バ ー ジ ョ ン 番 号 を 表 示 し ま す 。

−V

実 行 し な い で 、 groff で 実 行 さ れ る 処 理 内 容 を 標 準 出 力 に 表 示 し ま す 。
−z

troff か ら の 出 力 を 捨 て ま す 。 エ ラ ー メ ッ セ ー ジ の み が 表 示 さ れ ま す 。

−Z

troff か ら の 出 力 を 後 処 理 し ま せ ん 。 通 常 groff は 、 自 動 的 に 適 当 な 後 処 理 プ ロ グ ラ ム を 起 動 し ま す 。

−Parg

後 処 理 プ ロ グ ラ ム に arg を 引 数 と し て 渡 し ま す 。 別 々 の 引 数 は 別 々 の −P オ プ シ ョ ン で 指 定 す る 必 要 が あ り ま す 。 groff は 、 arg の 前 に を つ け て コ マ ン ド に 渡 し た り し な い こ と に 注 意 し て く だ さ い 。

−l

プ リ ン タ の ス プ ー ラ へ 出 力 し ま す 。 印 字 出 力 に 用 い ら れ る コ マ ン ド は 、 デ バ イ ス 記 述 フ ァ イ ル の print コ マ ン ド に よ っ て 指 定 さ れ ま す (こ れ が 存 在 し な い 場 合 に は 、 −l は 無 効 果 で す )。
−L
arg

arg を プ リ ン タ ス プ ー ラ プ ロ グ ラ ム に 渡 し ま す 。 別 々 の 引 数 は 、 別 々 の −L オ プ シ ョ ン で 指 定 す る 必 要 が あ り ま す 。 groff は 、 arg の 前 に を つ け て コ マ ン ド に 渡 し た り し な い こ と に 注 意 し て く だ さ い 。 デ バ イ ス 記 述 フ ァ イ ル に print コ マ ン ド が 無 い 場 合 に は 、 −L は 無 視 さ れ ま す 。

−Tdev

デ バ イ ス dev 用 に 出 力 し ま す 。 デ フ ォ ル ト の デ バ イ ス は ps で す 。

−X 通 常 の 後 処

理 プ ロ グ ラ ム の か わ り に 、 gxditview を 起 動 し て プ レ ビ ュ ー し ま す 。 groffgxditview-printCommand オ プ シ ョ ン を 渡 し ま す 。 こ の オ プ シ ョ ン は groff-l オ プ シ ョ ン 指 定 時 に 実 行 さ れ る Print ア ク シ ョ ン を 実 行 さ せ ま す 。 −Tps 以 外 が 指 定 さ れ て い る 場 合 は 、 よ い 結 果 が 得 ら れ ま せ ん 。
−N

eqn の 区 切 り 文 字 間 に 改 行 が 入 る こ と を 禁 止 し ま す 。 eqn−N オ プ シ ョ ン と 同 様 で す 。

−S

よ り 安 全 な モ ー ド 。 −S オ プ シ ョ ン を pic に 渡 し 、 次 の troff リ ク エ ス ト を 無 効 化 し ま す : .open, .opena, .pso, .sy, .pi 。 セ キ ュ リ テ ィ 上 の 理 由 か ら 安 全 な モ ー ド は デ フ ォ ル ト で 有 効 で す 。
−U

安 全 で な い モ ー ド 。 古 い 安 全 で な い 動 作 に 戻 し ま す 。

−a

−b

−i

−C

−E

−wname

−Wname

−mname

−olist

−dcs

−rcn

−Fdir

−Mdir

−ffam

−nnum こ れ ら の オ プ シ ョ ン の 詳 細 は 、

troff(1) に 記 述 し て あ り ま す 。

環 境 変 数

GROFF_COMMAND_PREFIX も し こ の 変 数 が X に 設 定 さ れ て い る と 、 grofftroff の か わ り に Xtroff を 起 動 し ま す 。 こ れ は 、 tbl, pic, eqn, grn, refer, soelim に も 同 様 に 影 響 し ま す 。 grap, gropos, grodvi, grotty, grolj4, grohtml, gxditview に は 影 響 し ま せ ん 。
GROFF_TMAC_PATH
デ フ ォ ル ト デ ィ レ ク ト リ に 加 え て 、 マ ク ロ フ ァ イ ル を 検 索 す べ き デ ィ レ ク ト リ の リ ス ト (リ ス ト の 区 切 り は コ ロ ン で す )。 更 な る 詳 細 は troff(1) を 参 照 し て く だ さ い 。
GROFF_TYPESETTER
デ フ ォ ル ト の デ バ イ ス
GROFF_FONT_PATH
デ フ ォ ル ト デ ィ レ ク ト リ に 加 え て 、 devname と い う 名 前 の デ ィ レ ク ト リ を 検 索 す べ き デ ィ レ ク ト リ の リ ス ト (リ ス ト の 区 切 り は コ ロ ン で す )。 更 な る 詳 細 は troff(1) を 参 照 し て く だ さ い 。
GROFF_BIN_PATH
こ の 検 索 パ ス は 、 groff が 起 動 す る コ マ ン ド の た め に 、 PATH の 前 に 使 用 さ れ ま す 。 設 定 し な い と 、 PATH の 前 に ’/usr/bin’ が 追 加 さ れ ま す 。
GROFF_TMPDIR
一 時 的 な フ ァ イ ル が 作 成 さ れ る デ ィ レ ク ト リ 。 も し 、 GROFF_TMPDIR が 設 定 さ れ て お ら ず 、 TMPDIR が 設 定 さ れ て い る な ら 、 TMPDIR で 示 さ れ る デ ィ レ ク ト リ に 一 時 フ ァ イ ル が 生 成 さ れ ま す 。 さ も な け れ ば 、 一 時 フ ァ イ ル は /tmp に 作 ら れ ま す 。 grops(1)refer(1) が 一 時 フ ァ イ ル を 作 成 す る 可 能 性 が あ り ま す 。

関 連 フ ァ イ ル

/usr/share/groff_font/devname/DESC デ バ イ ス name の デ バ イ ス 記 述 フ ァ イ ル
/usr/share/groff_font/dev
name/F デ バ イ ス name の た め の フ ォ ン ト F を 記 述 し た フ ォ ン ト フ ァ イ ル

EBCDIC ホ ス ト に お い て は 、 出 力 デ バ イ ス ascii, latin1, utf8 は 使 用 不 可 で す 。 同 様 に 、 cp1047 は ASCII ベ ー ス の オ ペ レ ー テ ィ ン グ シ ス テ ム 上 で は 使 用 不 可 で す 。

使 用 例

マ ニ ュ ア ル ペ ー ジ foo.1 を 標 準 出 力 に 対 し 、 latin-1 出 力 デ バ イ ス を 使 用 し て 印 刷 し 、 less を ペ ー ジ ャ に 使 用 す る に は 、 次 の コ マ ン ド を 使 用 し ま す :

groff -mandoc -Tlatin1 foo.1 | less ま た 、 次 の よ う に も 使 用 で き ま す :

groff -m mandoc -Tlatin1 foo.1 | less

作 者

James Clark <jjc [AT] jclark.com>

バ グ

バ グ レ ポ ー ト は 、 bug-groff [AT] gnu.org ま で お 願 い し ま す 。 レ ポ ー ト の 際 に は バ グ を 再 現 で き る 完 全 な 例 題 を 添 付 し 、 あ な た の 利 用 し て い る groff の バ ー ジ ョ ン を 添 え て 下 さ い 。

COPYRIGHT

Copyright © 1989-2000 Free Software Foundation, Inc.

groff は フ リ ー ソ フ ト ウ ェ ア で す 。 Free Software Foundation か ら 出 版 さ れ て い る the GNU General Public License の ver 2.0 か そ れ 以 降 に 基 づ く 限 り 再 配 布 し た り 、 変 更 す る こ と が 可 能 で す 。

groff は 使 い 易 い ツ ー ル と し て 配 布 さ れ る こ と を 望 ま れ て い ま す が 、 ど の よ う な 保 証 も あ り ま せ ん 。 そ れ が 商 業 的 で あ っ て も あ る 特 定 の 目 的 に 対 す る だ け で あ っ て も 保 証 は あ り ま せ ん 。 詳 し く は GNU の General Public License を 参 照 し て 下 さ い 。 あ な た は groff の コ ピ ー を GNU General Public License と 共 に 受 け と っ て い る は ず で す 。 そ の COPYING を 参 照 し て 下 さ い 。 そ う で な い 場 合 に は 、 Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA ま で 御 連 絡 下 さ い 。

入 手 性

最 新 の groff は た い て い ftp.gnu.org の gnu/groff デ ィ レ ク ト リ に 置 か れ て お り 、 anonymous ftp で 入 手 で き ま す 。

groff の み が 、 Ted Faber <faber [AT] lunabase.org> が 記 述 し た 自 由 に 入 手 可 能 な grap 実 装 を サ ポ ー ト し ま す 。 実 物 は 、 次 の と こ ろ に あ り ま す :

http://www.lunabase.org/~faber/Vault/software/grap/

関 連 項 目

grog(1), troff(1), tbl(1), pic(1), eqn(1), grn(1), grap(1), soelim(1), refer(1), grops(1), grodvi(1), grotty(1), grolj4(1), grolbp(1), grohtml(1), gxditview(1), groff_font(5), groff_out(5), groff_man(7), groff_ms(7), groff_me(7), groff_char(7)