GROFF(1)

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

書式
groff [ -tpeszaivhblCENRVXZ ] [ -wname ] [ -Wname ] [ -mname ] [ -Fdir ] [ -Tdev ] [ -ffam ] [ -Mdir ] [ -dcs ] [ -rcn ] [ -nnum ] [ -olist ] [ -Parg ] [ files... ]

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

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

dvi TeX の dvi フォーマット

X75 75 dpi の X11 プレビュア

X100
    100 dpi の X11 プレビュア

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

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

指定されたデバイス用の後処理を行うプログラムは、デバイス記述ファイルの postpro コマンドにより指定されています。これは -X オプションにより変更す ることができます。

デフォルトのデバイスは ps です。 pic 、 eqn 、 tbl 、 refer 、 soelim を使って前処理を行わせることができます。

引数を伴わないオプションは - のあとにまとめて続けることができます。 ファイル名のかわりに用いられる - は標準入力を意味します。

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

オプション

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

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

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

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

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

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

-v  groff から起動されるプログラムのバージョン番号が表示されるようにし ます。

-V  groff が実行するコマンドのパイプラインを表示します。実行はしません。

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

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

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

-l  プリンタへ出力します。プリントアウトに用いられるコマンドは、デバイス 記述ファイルの print コマンドによって指定されます。

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

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

-X  通常の後処理プログラムのかわりに、 gxditview を起動してプレビューし ます。 -Tps 以外が指定されている場合は、よい結果が得られません。

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

-a
-b
-i
-C
-E
-wname
-Wname
-mname
-olist
-dcs
-rcn
-Fdir
-Mdir
-ffam
-nnum
    これらのオプションの詳細は、 troff(1) に記述してあります。

環境変数

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

GROFF_TMAC_PATH
    マクロファイルを検索すべきディレクトリのリスト(コロンで区切る)

GROFF_TYPESETTER
    デフォルトのデバイス

GROFF_FONT_PATH
    devname という名前の、ディレクトリを検索すべきディレクトリのリスト(コロ ンで区切る)

PATH
    groff から起動されるプログラムが存在するパス

GROFF_TMPDIR
    一時的なファイルが作成されるディレクトリ。もし、 GRROFF_TMPDIR が設定さ れておらず、 TMPDIR が設定されているなら、 TMPDIR で示されるディレクトリ に一時ファイルが生成される。さもなければ、一時ファイルは /tmp に作られる。 grops(1) と refer(1) が一時ファイルを作成する可能性があります。

関連ファイル
/usr/share/groff_font/devname/DESC デバイス記述ファイル

/usr/share/groff_font/devname/F
    デバイス name のためのフォントファイル

作者
James Clark <jjc@jclark.com>

関連項目
grog(1), troff(1), tbl(1), pic(1), eqn(1), soelim(1), refer(1), grops(1), grodvi(1), grotty(1), gxditview(1), groff_font(5), groff_out(5), groff_ms(7), groff_me(7), groff_char(7)