TROFF(1)

名称
troff - 文書をフォーマットする

書式
troff [-abivzCER] [-w name] [-W name] [-d cs] [-f fam] [-m name] [-n num] [-o list] [-r cn] [-T name] [-F dir] [-M dir] [ files... ]

解説
本マニュアルでは、groff ドキュメントフォーマットシステムの一部である GNU バージョンの troff について記述します。本コマンドは UNIX troff と 高い互換性を持ちます。通常 troff は groff コマンドから起動されます。 groff はまた、適切な前処理プログラムと後処理プログラムを適切な オプションで、適切な順序で起動します。

オプション

-a  ASCII 文字のみの近似的な出力を行います。

-b  各警告とエラーメッセージに対するバックトレースを表示します。これは、 警告やエラーの原因を調べるのに有用です。出力される行番号は必ずしも正し くはありません。 as や am リクエストにより行番号を誤認する可能性がある からです。

-i  指定されたファイルをすべて処理したあとに、標準入力も読み込み、処理します。

-v  バージョン番号を表示します。

-wname
    name で指定した分類の警告を行います。指定できる name は、後述の Warnings の項を参照してください (オリジナルのオンラインマニュアルを参照して下さい)。 -w オプションは複数指定できます。

-Wname
    name で指定した分類の警告を行いません。 -W オプションは複数指定することが できます。

-E  すべてのエラーメッセージを出力しません。

-z  フォーマットした結果を出力しません。

-C  互換モードにします。

-dcs
-dname=s
    マクロ c または name を文字列 s と定義します。 c は 1 文字のマクロ名です。

-ffam
    fam をデフォルトのフォントファミリとして指定します。

-mname
    マクロファイル tmac.name を読み込みます。通常、ディレクトリ /usr/share/tmac が検索されます。

-R  troffrc を読みません。

-nnum
    最初のページ番号を num とします。

-olist
    list で指定したページのみを出力します。 list は、コンマで区切られ たページ範囲の列です。ページ範囲の指定方法は以下のとおりです: n は n ペー ジの出力、 m-n は m ページから n ページまでの出力、 -n は n ページまでの 出力、 n- は n ページ以降の出力を意味します。

-rcn
-rname=n
    数値レジスタ c または name の値を n とします。 c は 1 文字の名前です。 n は troff で扱える数式です。

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

-Fdir
    フォントファイルと DESC ファイルを検索するのに、ディレクトリ dir 以下の devname (出力デバイス名) を探します。通常フォントは /usr/share/groff_font から検索されますが、本オプションで指定したディレクトリのほうが先に 検索されます。

-Mdir
    /usr/share/tmac のかわりに、指定したディレクトリ dir からマクロファイルを検索します。

環境変数

GROFF_TMAC_PATH
    : で区切られた、マクロファイルを検索すべきディレクトリ名のリスト。

GROFF_TYPESETTER
    デフォルトの出力デバイス

GROFF_FONT_PATH
    : で区切られた、フォントを検索すべきディレクトリ名のリスト。 troff は、まず -F オプションで指定されたディレクトリを検索し、 次に本環境変数で指定されたディレクトリ、最後に標準のディレクトリ ( /usr/share/groff_font )を検索します。

関連ファイル
/usr/share/tmac/troffrc 初期化ファイル

/usr/share/tmac/tmac.name
    マクロファイル

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

/usr/share/groff_font/devname/F
    フォント記述ファイル

関連項目
groff(1) tbl(1), pic(1), eqn(1), grops(1), grodvi(1), grotty(1), groff_font(5), groff_out(5), groff_char(7)