Man page - groff(1)

Packages contains this manual

Available languages:

en ja zh_TW zh_CN de

Manual

GROFF

名 称
書 式
解 説
オ プ シ ョ ン
環 境 変 数
関 連 フ ァ イ ル
使 用 例
作 者
バ グ
COPYRIGHT
入 手 性
関 連 項 目

名 称

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

書 式

groff [ -abeghilpstvzCEGNRSUVXZ ] [ -w name ] [ -W name ] [ -m name ] [ -F dir ] [ -I dir ] [ -T dev ] [ -f fam ] [ -M dir ] [ -d cs ] [ -r cn ] [ -n num ] [ -o list ] [ -P arg ] [ -L arg ] [ files... ]

コ マ ン ド ラ イ ン オ プ シ ョ ン と パ ラ メ ー タ の 間 に 空 白 を 含 め る こ と が 可 能 で す 。

解 説

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

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 を 使 っ て 前 処 理 を 行 い ま す 。

-I dir

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

-R

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

-v

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

-V

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

-z

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

-Z

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

-P arg

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

-l

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

-L arg

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

-T dev

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

-X

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

-N

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

-S

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

-U

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

-a

-b

-i

-C

-E

-w name

-W name

-m name

-o list

-d cs

-r cn

-F dir

-M dir

-f fam

-n num

こ れ ら の オ プ シ ョ ン の 詳 細 は 、 troff (1) に 記 述 し て あ り ま す 。

環 境 変 数

GROFF_COMMAND_PREFIX

も し こ の 変 数 が X に 設 定 さ れ て い る と 、 groff troff の か わ り に X troff を 起 動 し ま す 。 こ れ は 、 tbl , pic , eqn , grn , refer , soelim に も 同 様 に 影 響 し ま す 。 grap , gropos , grodvi , grotty , grolj4 , grohtml , gxditview に は 影 響 し ま せ ん 。

GROFF_TMAC_PATH

デ フ ォ ル ト デ ィ レ ク ト リ に 加 え て 、 マ ク ロ フ ァ イ ル を 検 索 す べ き デ ィ レ ク ト リ の リ ス ト (リ ス ト の 区 切 り は コ ロ ン で す )。 更 な る 詳 細 は troff (1) を 参 照 し て く だ さ い 。

GROFF_TYPESETTER

デ フ ォ ル ト の デ バ イ ス

GROFF_FONT_PATH

デ フ ォ ル ト デ ィ レ ク ト リ に 加 え て 、 dev name と い う 名 前 の デ ィ レ ク ト リ を 検 索 す べ き デ ィ レ ク ト リ の リ ス ト (リ ス ト の 区 切 り は コ ロ ン で す )。 更 な る 詳 細 は 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/dev name /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@jclark.com>

バ グ

バ グ レ ポ ー ト は 、 bug-groff@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@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)