'\" t
.ig
troff.man

Last update : 09 Dec 2002

This file is part of groff, the GNU roff type-setting system.

Copyright (C) 1989, 2000, 2001, 2002 Free Software Foundation, Inc.

written by James Clark

modified by Werner Lemberg <wl@gnu.org>
            Bernd Warken <bwarken@mayn.de>

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation; with the
Invariant Sections being this .ig-section and AUTHOR, with no
Front-Cover Texts, and with no Back-Cover Texts.

A copy of the Free Documentation License is included as a file called
FDL in the main directory of the groff source package.
..
.
.\" $FreeBSD$
.
.\" --------------------------------------------------------------------
.\" Setup
.\" --------------------------------------------------------------------
.
.mso www.tmac
.
.if n \{\
.  mso tty-char.tmac
.  ftr CR R
.  ftr CI I
.\" $FreeBSD$
.\}
.
.if '\*[.T]'dvi' \
.  ftr CB CW
.
.de TQ
.br
.ns
.TP \\$1
..
.
.\" Like TP, but if specified indent is more than half
.\" the current line-length - indent, use the default indent.
.de Tp
.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
.el .TP "\\$1"
..
.
.
.\" --------------------------------------------------------------------
.\" Title
.\" --------------------------------------------------------------------
.
.TH TROFF 1 "1 May 2003" "Groff Version 1.19"
.SH 名称
troff \- groff テキストフォーマットシステムの troff プロセッサ
.
.
.\" --------------------------------------------------------------------
.SH 書式
.\" --------------------------------------------------------------------
.
.nr a \n(.j
.ad l
.nr i \n(.i
.in +\w'\fBtroff 'u
.ti \niu
.B troff
.de OP
.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
.el .RB "[\ " "\\$1" "\ ]"
..
.OP \-abcivzCERU
.OP \-d cs
.OP \-f fam
.OP \-F dir
.OP \-m name
.OP \-M dir
.OP \-n num
.OP \-o list
.OP \-r cn
.OP \-T name
.OP \-w name
.OP \-W name
.RI "[\ " files\|.\|.\|. "\ ]"
.br
.ad \na
.P
コマンドラインオプションとパラメータの間には、
空白を含めることができます。
.
.
.\" --------------------------------------------------------------------
.SH 解説
.\" --------------------------------------------------------------------
.
本マニュアルでは、GNU バージョンの
.BR troff
について記述しています。
これは、groff ドキュメントフォーマットシステムの一部です。
.
本コマンドは UNIX troff と高い互換性を持っている一方で、
多くの拡張がなされています。
この拡張については、
.BR \%groff_diff (7)
を参照してください。
通常 troff は
.BR groff (1)
コマンドから起動されます。
また groff は、適切な前処理プログラムと後処理プログラムを
適切なオプションを用いて、適切な順序で起動します。
.
.
.\" --------------------------------------------------------------------
.SH オプション
.\" --------------------------------------------------------------------
.
.TP \w'\-dname=s'u+2n
.B \-a
.SM ASCII
文字のみの近似的な出力を行います。
.
.TP
.B \-b
各警告とエラーメッセージに対するバックトレースを表示します。
.
これは、警告やエラーの原因を調べるのに有用です。
.
出力される行番号は必ずしも正しくはありません。
.B as
や
.B am
リクエストによって、
.BR troff
が行番号を誤認する可能性があるからです。
.
.TP
.B \-c
カラー出力を無効にします (互換モードでは常に無効です)。
.
.TP
.B \-C
互換モードを有効にします。
.
.TP
.BI \-d cs
.TQ
.BI \-d name = s
マクロ
.I c
または
.I name
を文字列
.IR s
と定義します。
.I c
は 1 文字のマクロ名です。
.
.TP
.B \-E
.BR troff
のエラーメッセージを一切出力しません。
これは、
.B tm
や
.B tm1
リクエストを用いたマクロパッケージによって標準エラー出力へ表示される
メッセージには影響しないことに注意してください。
.
.TP
.BI \-f fam
.I fam
をデフォルトのフォントファミリとして使用します。
.
.TP
.BI \-F dir
ディレクトリ (またはディレクトリパス)
.I dir
以下のサブディレクトリ
.BI dev name
.RI ( name
は出力デバイス名) を検索し、その中からフォントファイルと
.B DESC
ファイルを探します。
.I dir
は、他のすべてのフォントディレクトリより前に調べられます。
.
.TP
.B \-i
指定されたファイルをすべて処理したあとに、標準入力を読み取ります。
.
.TP
.BI \-m name
マクロファイル
.IB name .tmac\fR
を読み取ります。
見つからなければ、かわりに
.BI tmac. name
を試みます。
.
まず最初に
.B \-M
コマンドラインオプションで指定されたディレクトリ、続いて
.B GROFF_TMAC_PATH
環境変数で指定されたディレクトリ、
そして現在のディレクトリ (安全でないモードの場合のみ)、
ホームディレクトリ、/usr/share/tmac/、/usr/share/tmac/、
/usr/share/tmac の順に検索します。
.
.TP
.BI \-M dir
指定したディレクトリ (またはディレクトリパス)
.I dir
からマクロファイルを検索します。
.
これは他のすべてのマクロディレクトリより前に調べられます。
.
.TP
.BI \-n num
最初のページ番号を
.IR num
とします。
.
.TP
.BI \-o list
.IR list
で指定したページのみを出力します。
.IR list
は、コンマで区切られたページ範囲のリストです:
.I n
は
.IR n
ページの出力、
.IB m \- n
は
.I m
ページから
.IR n
ページまでの出力、
.BI \- n
は
.IR n
ページまでの出力、
.IB n \-
は
.IR n
ページ以降の出力を意味します。
.B troff
はリストの最後のページを印刷し終えると終了します。
.
.TP
.BI \-r cn
.TQ
.BI \-r name = n
数値レジスタ
.I c
または
.I name
の値を
.IR n
とします。
.I c
は 1 文字の名前です。
.I n
は troff で扱える数式です。
.
.TP
.B \-R
.B troffrc
と
.BR troffrc-end
を読み取りません。
.
.TP
.BI \-T name
デバイス
.IR name
用の出力を生成します。
デフォルトは
.BR ps
です。
更なる解説は
.BR groff (1)
を参照してください。
.
.TP
.B \-U
安全でないモード。
.
これによって以下のリクエストが有効になります:
.BR open ,
.BR opena ,
.BR pso ,
.BR sy ,
.BR pi
。
このオプションが指定されない場合、セキュリティのために
これらの危険性のあるリクエストは禁止されます。
.
またこのオプションによって、現在のディレクトリがマクロ検索パスに追加されます。
.
.TP
.B \-v
バージョン番号を表示します。
.
.TP
.BI \-w name
.IR  name
で指定した分類の警告を行います。
指定できる警告は、後述の
.I 警告
のサブセクションを参照してください。
.
例えば、すべての警告を有効にする場合、
.B \-w
.BR all
とします。
.B \-w
オプションは複数指定できます。
.
.TP
.BI \-W name
.IR name
で指定した分類の警告を行いません。
.B \-W
オプションは複数指定することができます。
.
.TP
.B \-z
フォーマットした結果を出力しません。
.
.
.\" --------------------------------------------------------------------
.SH 警告
.\" --------------------------------------------------------------------
.
.B troff
が出力する警告は以下のカテゴリに分類されます。
.
各警告に関連する名前は
.B \-w
と
.B \-W
オプションで使用可能です。
また番号は、
.B warn
リクエストおよび
.B .warn
レジスタが使用します。
番号は、ビット合成しやすいように常に 2 の冪乗となっています。
.
.P
.TS
tab(@), center, box;
c c c | c c c
r rI lB | r rI lB.
ビット@コード@警告@ビット@コード@警告
_
0@1@char@10@1024@reg
1@2@number@11@2048@tab
2@4@break@12@4096@right-brace
3@8@delim@13@8192@missing
4@16@el@14@16384@input
5@32@scale@15@32768@escape
6@64@range@16@65536@space
7@128@syntax@17@131072@font
8@256@di@18@262144@ig
9@512@mac@19@524288@color
.TE
.
.P
.nr x \w'\fBright-brace'+1n+\w'00000'u
.ta \nxuR
.
.TP \nxu+3n
.BR break "\t4"
行詰めモードにおいて、行を分割できなかったため、
行の長さよりも短くなりました。
.
これはデフォルトで有効です。
.
.TP
.BR char "\t1"
存在しない文字です。
.
これはデフォルトで有効です。
.
.TP
.BR color "\t524288"
色に関する警告です。
.
.TP
.BR delim "\t8"
閉じる方のデリミタがないか、もしくはマッチしませんでした。
.
.TP
.BR di "\t256"
現在転換がないにもかかわらず、引数なしで
.B di
や
.B da
を使用しました。
.
.TP
.BR el "\t16"
対応する
.B ie
リクエストのない、
.B el
リクエストです。
.
.TP
.BR escape "\t32768"
認識できないエスケープシーケンスです。
.
認識できないエスケープシーケンスがあった場合は、
そのエスケープ文字は無視されます。
.
.TP
.BR font "\t131072"
存在しないフォントです。
.
これはデフォルトで有効です。
.
.TP
.BR ig "\t262144"
.B ig
リクエストによって無視されたテキストの中にある、不正なエスケープです。
.
これらは、無視されたテキストの中でなければエラーとなっているものです。
.
.TP
.BR input "\t16384"
不正な入力文字です。
.
.TP
.BR mac "\t512"
未定義の文字列、マクロ、転換を使用しました。
.
未定義の文字列、マクロ、転換を使用した場合、
その文字列は自動的に空に定義されます。
.
このため多くの場合、各名前に対する警告は、たかだか 1 回だけです。
.
.TP
.BR missing "\t8192"
必要な引数が足りないリクエストです。
.
.TP
.BR number "\t2"
不正な数式です。
.
これはデフォルトで有効です。
.
.TP
.BR range "\t64"
引数が範囲を越えています。
.
.TP
.BR reg "\t1024"
未定義の数値レジスタを使用しました。
.
未定義の数値レジスタを使用した場合、
そのレジスタは自動的に値 0 に定義されます。
.
このため多くの場合、特定の名前に対する警告は、たかだか 1 回だけです。
.
.TP
.BR right-brace "\t4096"
数字が期待される場所で
.B \[rs]}
が使用されました。
.
.TP
.BR scale "\t32"
意味のないスケールインジゲータです。
.
.TP
.BR space "\t65536"
リクエストもしくはマクロとそれらの引数との間に空白がありません。
.
この警告は、最初の 2 文字が定義された名前であるような、
2 文字より長い未定義の名前があった場合に起こります。
.
この時、リクエストもしくはマクロは起動されません。
.
この警告が発せられる時、どのようなマクロも自動的には定義されません。
.
これはデフォルトで有効です。
.
この警告は互換モードでは起こりません。
.
.TP
.BR syntax "\t128"
数式中に疑わしい文法があります。
.
.TP
.BR tab "\t2048"
タブ文字の使い方が不適切です。
数字が期待される場所でタブを使用したか、
またはクォートされていないマクロの引数中でタブ文字を使用しました。
.
.P
警告のグループを指定する名前もあります:
.
.TP
.B all
.BR di ,
.BR mac ,
.BR reg
を除くすべての警告を指定します。
これは、伝統的なマクロパッケージを使用する際に有用な警告の
すべてをカバーするよう意図されています。
.
.TP
.B w
すべての警告を指定します。
.
.
.\" --------------------------------------------------------------------
.SH 環境変数
.\" --------------------------------------------------------------------
.
.TP
.SM
.B GROFF_TMAC_PATH
マクロファイルを検索すべきディレクトリ名の、コロン区切りのリストです。
.B troff
は、それらの前に
.B \-M
オプションで指定されたディレクトリを検索し、
次に本環境変数で指定されたディレクトリ、最後に標準のディレクトリ
(現在のディレクトリ (安全でないモードの場合)、ホームディレクトリ、
.BR /usr/share/tmac ,
.BR /usr/share/tmac ,
.BR /usr/share/tmac )
を検索します。
.
.TP
.SM
.B GROFF_TYPESETTER
デフォルトの出力デバイス。
.
.TP
.SM
.B GROFF_FONT_PATH
.BI dev name
ディレクトリを検索すべきディレクトリ名の、コロン区切りのリストです。
.B troff
は、まず
.B \-F
オプションで指定されたディレクトリを検索し、次に本環境変数で指定された
ディレクトリ、最後に標準のディレクトリ (
.RB ( /usr/share/groff_font ,
.BR /usr/share/groff_font ,
.BR /usr/share/groff_font )
を検索します。
.
.
.\" --------------------------------------------------------------------
.SH 関連ファイル
.\" --------------------------------------------------------------------
.
.Tp \w'/usr/share/groff_font/devname/DESC'u+3n
.B /usr/share/tmac/troffrc
初期化ファイル (他のマクロパッケージの前に呼び出されます)
.
.TP
.B /usr/share/tmac/troffrc-end
初期化ファイル (他のマクロパッケージの後に呼び出されます)
.
.TP
.BI /usr/share/tmac/ name .tmac
.TQ
.BI /usr/share/tmac/tmac. name
マクロファイル
.
.TP
.BI /usr/share/groff_font/dev name /DESC
デバイス
.IR name
用のデバイス記述ファイル
.
.TP
.BI /usr/share/groff_font/dev name / F
デバイス
.IR name
のフォント
.I F
用のフォント記述ファイル
.P
.B troffrc
と
.B troffrc-end
は、セキュリティのためデフォルトでは (
.B \-U
オプションが指定されていても) 現在のディレクトリと
ホームディレクトリのどちらからも検索されない事に注意してください。
.
必要な場合は、
.B \-M
コマンドラインオプションもしくは
.B GROFF_TMAC_PATH
環境変数を使用することで、これらのディレクトリを検索パスに加えられます。
.
.
.\" --------------------------------------------------------------------
.SH 作者
.\" --------------------------------------------------------------------
.
Copyright (C) 1989, 2001, 2002 Free Software Foundation, Inc.
.
.P
この文書は、FDL (GNU Free Documentation License) バージョン 1.1 か
それ以降のものに基づいて配布されています。
.
あなたは、システム上に FDL のコピーを受け取っているはずですが、
これは
.URL http://www.gnu.org/copyleft/fdl.html "GNU copyleft site"
からもオンラインで入手可能です。
この文書は James Clark によって書かれ、
.MTO wl@gnu.org "Werner Lemberg"
と
.MTO bwarken@mayn.de "Bernd Warken"
によって修正されました。
.
.P
この文書は GNU の roff ディストリビューションである
.IR groff
の一部です。
.
.
.\" --------------------------------------------------------------------
.SH 関連項目
.\" --------------------------------------------------------------------
.
.TP
.BR groff (1)
.I groff
システムの主要プログラムです。
これは
.IR troff
を包むラッパとなっています。
.
.TP
.BR groff (7)
.I groff
言語の説明です。
これには、素の
.IR groff
の持つすべての定義済みのリクエスト、レジスタ、エスケープについての
簡潔ですが完全なリファレンスが含まれています。
コマンドラインからは、以下のように呼び出します。
.RS
.IP
.B man 7 groff
.RE
.
.TP
.BR \%groff_diff (7)
.I groff
言語と
.I 古典的な troff
言語の違いです。
.
現在のところ、これが
.I groff
システムで実際の文書そのものです。
.
.TP
.BR roff (7)
.I groff
や他の
.I roff
システムの概要です。
これにはさらなる関連文書へのポインタも含まれています。
.
.P
.I groff info
.IR ファイル
(
.BR info (1)
を参照) は、1 文書で groff のすべての説明をしています。
.
.
.\" --------------------------------------------------------------------
.\" Emacs variables
.\" --------------------------------------------------------------------
.
.\" Local Variables:
.\" mode: nroff
.\" End: