TROFF

Section: User Commands (1)
Updated: 6 August 2001
IndexJM Home Page
 

名称

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

書式


troff-abivzCERU ] [ -wname ] [ -Wname ] [ -dcs ] [ -ffam ] [ -mname ] [ -nnum ] [ -olist ] [ -rcn ] [ -Tname ] [ -Fdir ] [ -Mdir ] [ files... ]

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

解説

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

オプション

-a
ASCII文字のみの近似的な出力を行います。
-b
各警告とエラーメッセージに対するバックトレースを表示します。これは、 警告やエラーの原因を調べるのに有用です。出力される行番号は必ずしも正し くはありません。asamリクエストにより、troffが行番号を誤認する可能性があるからです。
-i
指定されたファイルをすべて処理したあとに、標準入力も読み込み、処理します。
-v
バージョン番号を表示します。
-wname
nameで指定した分類の警告を行います。指定できるnameは、後述の警告のサブセクションを参照してください。-wオプションは複数指定できます。
-Wname
name で指定した分類の警告を行いません。-Wオプションは複数指定することが できます。
-E
エラーメッセージを一切出力しません。
-z
フォーマットした結果を出力しません。
-C
互換モードにします。
-dcs

-dname=sマクロcまたはnameを文字列sと定義します。cは 1 文字のマクロ名です。
-ffam
famをデフォルトのフォントファミリとして使用します。
-mname
マクロファイルname.tmacを読み込みます。見つからなければ、かわりにtmac.nameを試みます。 まず最初に-Mコマンドラインオプションで指定されたディレクトリ、 続いてGROFF_TMAC_PATH環境変数で指定されたディレクトリ、 そして現在のディレクトリ (安全でないモードの 場合のみ)、ホームディレクトリ、/usr/share/tmac/、/usr/share/tmac/、/usr/share/tmacの順に検索します。
-U
安全でないモード。 これによって以下のリクエストが有効になります:.open,.opena,.pso,.sy,.pi. そうでなければ、セキュリティのためにこれらの危険性のあるリクエストは 禁止されています。また現在のディレクトリをマクロ検索パスに加えます。
-R
troffrctroffrc-endを読みません。
-nnum
最初のページ番号をnumとします。
-olist
listで指定したページのみを出力します。listは、コンマで区切られ たページ範囲の列です。ページ範囲の指定方法は以下のとおりです:nnペー ジの出力、m-nmページからnページまでの出力、-nnページまでの 出力、n-nページ以降の出力を意味します。troffはリストの最後のページを印刷し終えると終了します。
-rcn
-rname=n数値レジスタcまたはnameの値をnとします。cは 1 文字の名前です。nは troff で扱える数式です。
-Tname
デバイスname用の出力を生成します。デフォルトは ps です。
-Fdir
フォントファイルとDESCファイルを検索するのに、ディレクトリ (またはディレクトリパス)dir以下のdevname(nameは出力デバイス名) を探します。 他のすべてのフォントディレクトリより前にdirを調べます。
-Mdir
指定したディレクトリ (またはディレクトリパス)dirからマクロファイルを検索します。 他のすべてのマクロディレクトリより前に調べます。
 

使用法

ここでは UNIX troff には無い機能のみを説明します。 

長い名前

数値レジスタ、フォント、文字列/マクロ/転換、 特殊文字のそれぞれの名前の長さは任意です。 エスケープシーケンス中、すなわち
2 文字の名前(xxを使用可能な場所で、 任意の長さの名前[xxx]を使用可能です。
\[xxx]
xxxで呼ばれる特殊文字を表示します。
\f[xxx]
フォントxxxを設定します。
\*[xxx]
文字列xxxを挿入する。
\n[xxx]
数値レジスタxxxを挿入する。
 

分数のポイントサイズ

スケールドポイントは 1/sizescaleポイントです。ここで sizescale はDESCファイルで指定されます (デフォルト値は 1 です)。 また、新しいスケールインジケータzがあります。 これは sizescale 倍する効果があります。 troff におけるリクエストおよびエスケープシーケンスは ポイントサイズを表す引数をスケールドポイント単位で表されているとして 解釈しますが、 このような引数の評価はデフォルトのスケールインジケータzにて行います。 このように取り扱われる引数には、psリクエストの引数、csリクエストの 3 番目の引数、tkfリクエストの 2 番目および 4 番目の引数、\Hエスケープシーケンスの引数、\sエスケープシーケンスの変形で数値式を引数として取るものとがあります。

例えば sizescale を 1000 とします; この場合スケールドポイントはミリポイントとなります; リクエスト.ps 10.25.ps 10.25zと同じですし、ポイントサイズは 10250 スケールドポイントに設定されます。 これは 10.25 ポイントと等しい値です。

数値レジスタ\n[.s]はポイントサイズを 10 進数分数のポイント単位で返します。 新しい数値レジスタ\n[.ps]もあり、これはスケールドポイント単位でのポイントサイズを返します。

デフォルトのスケールインジケータがu,zのどちらでもない数式中でzスケールインジケータを使用するのは無意味でしょう。troffはこのようなことを禁止します。 同様に、zがデフォルトのスケールインジケータであった数式においてz,uのどちらでもないスケールインジケータを使用するのは無意味でしょう。troffはこのようなことを禁止します。

また、新しいスケールインジケータsがあります。これはもとの値をスケールドポイントの単位数で逓倍します。 例えば、\n[.ps]s1mと同じです。s,zスケールインジケータを混同しないようにして下さい。 

数値式

括弧内の数式中に空白を含めることが許されます。

Mは em の 1/100 を意味します。

e1>?e2
e1e2とで小さくない方。
e1<?e2
e1e2とで大きくない方。
(c;e)
cをデフォルトのスケールインジケータとしてeを評価します。cが指定されない場合はeの評価においてスケールインジケータは無視されます。
 

新しいエスケープシーケンス

\A'anything'
1または0に展開されます。 これはanythingが文字列、マクロ、展開、数値レジスタ、環境、フォントのいずれかとして 受理可能か否かに依存します。anythingが空の場合には0が返されます。 連想表のようなものからユーザの入力を取り出すような場合に有効です。
\B'anything'
これは数値式anythingが正当か否かに応じて1または0に展開されます。anythingが空の場合は0を返します。
\C'xxx'
xxxという名前の文字をタイプセットします。 通常、\[xxx]を使用する方が便利です。 しかし\Cの優位点は、最近のUNIXと互換性があり 互換モードにおいて使用可能であることです。
\E
エスケープ文字と等価ですが、コピーモードでは解釈されません。 例えば、上付き文字の始まりと終りの文字列は次のように定義できます:
.ds { \v'-.3m'\s'\En[.s]*6u/10u'
.ds } \s0\v'.3m'

\Eを使用すると、 例え\*{がコピーモードにおいて解釈されるような場合でも、 これらの定義がうまく作用することを保証できます (例えばマクロの引数で使用される場合)。

\N'n'
コードnの文字を現在のフォントでタイプセットします。nは任意の整数値です。 ほとんどのデバイスは文字コードが 0 から 255 までしかありません。 現在のフォントが対応するコードの文字を持たない場合、 スペシャルフォントは探されません。\Nエスケープシーケンスはcharリクエストとの組み合わせにより便利に使えます:
.char \[phone] \f(ZD\N'37'
各文字のコードは、フォント記述ファイルで、charsetコマンドの後の 4 番目のカラムに書かれています。 文字の名前として---を使うことで、名前の無い文字をフォント記述ファイルに組み込むことが可能です。 これらの文字を使用するには、\Nエスケープシーケンスを使う方法しかありません。
\R'name ±n'
これは、次のものと同じ効果です。
.nr name ±n
\s(nn

\s±(nnポイントサイズをnnポイントに設定します;nnは正確に 2 桁の 10 進数である必要があります。
\s[±n]
\s±[n]
\s'±n'
\s±'n'ポイントサイズをnスケールドポイントにします;nは数値式であり、デフォルトスケールインジケータはzです。
\Vx
\V(xx
\V[xxx]getenv(3) で返される環境変数xxxの内容を挿入します。\Vはコピーモードで解釈されます。
\Yx
\Y(xx
\Y[xxx]これは\X'\*[xxx]'とほとんど同一です。 しかし文字列/マクロxxxは解釈されません; またxxxがマクロととして定義されることが許されており、改行文字を含んでも良いです (\Xの引数は改行文字を含んではなりません)。 改行文字を含む場合には UNIX troff 出力フォーマットが 拡張されている必要があります。 また、この拡張を知らないドライバーを混乱させてしまいます。
\Z'anything'
anything を表示したあと水平位置及び垂直位置を元に戻します;anythingはタブやリーダーを含んではなりません。
\$0
現在のマクロが呼び出された名前です。alsリクエストはマクロに複数の名前を持たせることができます。
\$*
マクロ中で、全ての引数を空白で区切って結合した文字列になります。
\$@
マクロ中で、各引数をダブルクォートで括り、 その全てを空白で区切って結合した文字列になります。
\$(nn

\$[nnn]マクロ中で、nn番目 もしくはnnn番目の 引数を与えます。 マクロの取りうる引数の数には制限はありません。
\?anything\?
転換中で使用すると、anythingを転換中に透過的に埋め込みます。anythingはコピーモードで読まれます。 転換の内容が後で読み込まれる時、anythingは解釈されます。anythingは改行文字を含んではなりません; 転換中に改行文字を埋め込みたい場合には\!を使用して下さい。 エスケープシーケンス\?はコピーモードにおいて認識され、単一の内部コードに変換されます;anythingの終了を表すのがこのコードです。 それゆえ、
.nr x 1
.nf
.di d
\?\\?\\\\?\\\\\\\\nx\\\\?\\?\?
.di
.nr x 2
.di e
.d
.di
.nr x 3
.di f
.e
.di
.nr x 4
.f
4を表示します。
\/
先行する文字の幅を増やします。 その結果、継続する文字がローマン文字の場合、 先行する文字と継続する文字との間隔が正しくなります。 例えば、イタリックの f の直後にローマンの右括弧が続く場合、 ほとんどのフォントにおいて f の右上の部分が右括弧の左上の部分とが重なりf) となります。 これは醜いです。\/を挿入することによりf) となりこの問題を防ぎます。 このエスケープシーケンスを、 イタリック文字の直後に空白をはさまずにローマン文字が続く場合には 常に使用することは良い考えです。
\,
後続する文字の空白を修正します。 その結果、先行する文字がローマン文字の場合、 その文字と先行する文字との間の空白が正しくなります。 例えば\,を括弧と f の間に挿入することにより、 (f は (fとなります。 ローマン文字の直後に空白をはさまずにイタリック文字が続く場合には 常に使用することは良い考えです。
\)
\&に似ていますが、cflagsリクエストにより宣言された文字として動作します。 このは文の終了判定のために使用します。
\~
行分割されないが、行内部の空白調整において普通の単語間空白と同様に伸び 縮みする空白を生成します。
\:
幅が 0 のブレークポイントを挿入します。\%と等価ですがソフトハイフン文字を挿入しません。
\#
次の改行文字 (これを含みます) までの全てを無視します。 コピーモードで解釈されています。 これは\に似ていますが、\は最後の改行文字を無視しないところが違います。
 

新しいリクエスト

.aln xx yy
数値レジスタオブジェクトで名前がyyのものへのエイリアスxxを作成します。 新しい名前と古い名前は完全に等価になります。 もしyyが未定義の場合、タイプregの警告が生成され、リクエストは無視されます。
.als xx yy
yyという名前のリクエスト/文字列/マクロ/転換の各オブジェクトに対する エイリアスxxを作成します。 新しい名前と古い名前は完全に等価になります (ソフトリンクに対するハードリンクのようなものです)。yyが未定義なら、タイプmacの警告が生成され、リクエストは無視されます。 マクロ/転換/文字列転換が現在未定義である場合、 もしくはリクエストとして定義されている場合には、de,am,di,da,ds,asリクエストは新しいオブジェクトを生成するだけです; これらは通常は既に存在するオブジェクトの値を変更します。
.am1 xx yy
.amと同様ですが、実行中に互換モードはオフになります。 入る時に現在の互換モードが保存され、終了時に回復されます。
.asciify xx
このリクエストは、転換xxを以下のように `アンフォーマット' します。 すなわちフォーマットされxxに転換格納されたASCIIと空白文字 (そしていくつかのエスケープシーケンス) が、xxが再度読み込まれる時に、普通に入力された文字として扱われます。.writemリクエストと組み合わせた転換で有用です。 また大々的なハックにも利用できます。 例えば、
.tr @.
.di x
@nr n 1
.br
.di
.tr @@
.asciify x
.x
はレジスタnを 1 に設定します。 グリフ情報 (フォント、フォントサイズ等々) は保存されません。 代わりに.unformatを使ってください。
.backtrace
入力スタックのバックトレースを標準エラー出力に出力します。
.blm xx
空行マクロをxxに設定します。 空行マクロが存在する場合、 空行に出会った時に、 通常の troff の振舞とは異なり、 このマクロを呼び出します。
.box xx
.boxa xxこれらのリクエストは、 途中まで行詰めされた行が転換の一部にならず (つまり転換は常に 改行から始まります)、しかし転換の終了後に戻され、転換から 生じたであろう途中まで行詰めされた行を 破棄するという点を除いて、didaリクエストと同様です。
.break
while ループを抜けます。while,continueリクエストも見て下さい。brリクエストと混同しないようにして下さい。
.brp
\pと同様です。
.cflags n c1 c2...
文字c1,c2,... は、nで定義されるプロパティを持ちます。 ここでnは以下のものを OR したものです。
1
この文字で文が終ります。 (初期状態では文字.?!がこのプロパティを持ちます);
2
この文字の前でラインブレイク可能です (初期状態ではこのプロパティを持つ文字はありません); 両側の文字が非 0 のハイフネーションコードを持つ場合を除き、 このプロパティを持つ文字の場所で ラインブレイクはしません。
4
この文字の後でラインブレイク可能です (初期状態では文字-\(hy\(emがこのプロパティを持ちます); 両側の文字が非 0 のハイフネーションコードを持つ場合を除き、 このプロパティを持つ文字の場所で ラインブレイクはしません。
8
この文字は水平にオーバラップします。 (初期状態では文字\(ul\(rn\(ruがこのプロパティを持ちます);
16
この文字は垂直にオーバラップします。 (初期状態では文字\(brがこのプロパティを持ちます);
32
このプロパティを持つ文字が任意数後続し その後に改行もしくは 2 つの空白が後続するような文の終りを表す文字は、 文の終りとして扱われます; 言い替えると、この文字は文の終りの認識において透過です; TeX においてゼロ空白ファクタを持つのと同じです (初期状態では文字s')]*\(dg\(rqがこのプロパティを持ちます)。
.char c string
文字cstringと定義します。 文字cが表示される必要がある時はいつでも、 一時的な環境でstringが処理され、結果が単一のオブジェクトして生成されます。stringの処理中は、 互換モードはオフにされ エスケープ文字は\に設定されます。 太字化/定空白化/カーニングは、stringの各文字ではなくこのオブジェクトに対して適用されます。 このリクエストによって定義された文字は、 出力デバイスによって提供される通常の文字のように使用できます。 特に、他の文字はこの文字にtrリクエストによって変換可能です; この文字はlcリクエストによってリーダ文字とすることが可能です;\l,\Lエスケープシーケンスによって、この文字を繰り返しパタンで 使用することが可能です;hcodeリクエストによってこの文字がハイフネーションコードを持てば、 この文字を含む語は正確にハイフネーション可能です。 また特殊な非再帰機能があります: 文字の定義中にいて使用される文字は、 通常の文字として扱われ、charでは定義されたものではありません。 文字の定義はrcharリクエストにて除去可能です。
.chop xx
マクロ/文字列/転換xxから最後の文字を切り落とします。 文字列として挿入される転換から最後の改行文字を除去するのに有効です。
.close stream
streamという名前のストリームをクローズします;streamwriteリクエストの引数とはなりえなくなります。openリクエストを見て下さい。
.continue
while ループの現在の繰り返しを終了します。while,breakリクエストも見て下さい。
.cp n
nが非ゼロか存在しない場合、 互換モードを有効にします。 そうでない場合は互換モードを無効にします。 互換モードでは、長い名前は理解されず、 長い名前に起因する非互換性の問題は発生しません。
.dei xx yy
間接的にマクロを定義します。 次の例は
.ds xx aa
.ds yy bb
.dei xx yy
以下と等価です。
.de aa bb
.de1 xx yy
.deと同様ですが、実行中に互換モードはオフになります。 入る時に現在の互換モードが保存され、終了時に回復されます。
.do xxx
.xxxを互換モードを無効にして解釈します。 例えば
.do fam T

は、互換モードが有効であっても機能することを除けば、

.fam T

と同じ効果を持ちます。xxxで使用するファイルを解釈する前に互換モードは元に戻されることに注意して 下さい。

.ecs
現在のエスケープ文字を保存します。
.ecr
ecsで保存したエスケープ文字を復帰します。 事前にecsを呼び出していないと `\' が新しいエスケープ文字になります。
.evc xx
環境xxの内容を、現在の環境へコピーします。 環境のプッショおよびポップは行いません。
.fam xx
現在のフォントファミリをxxに設定します。 現在のフォントファミリは現在の環境の一部です。xxが無い場合は以前のフォントファミリに戻ります。 フォントファミリに関するさらなる情報は、styリクエストの解説を見て下さい。
.fspecial f s1 s2...
現在のフォントがfの場合、 フォントs1,s2,... がスペシャルとなります。 すなわち、現在のフォントで存在しない文字が スペシャルフォントにおいて探されます。specialリクエストで指定されたフォントはfspecialリクエストで指定されたフォントの後に探されます。
.ftr f g
フォントfgに変換します。\fエスケープシーケンス中、ft,ul,bd,cs,tkf,special,fspecial,fp,styリクエスト中で、 名前fで参照されるフォントに関して、フォントgが使用されます。gが指定されない場合およびfと等しい場合は、 フォントfは変換されません。
.hcode c1 code1 c2 code2...
ハイフネーションコードの設定を、 文字c1に対しcode1、文字c2に対しcode2というふうに行います。 ハイフネーションコードは、 数字もしくは空白以外の単一入力文字 (非スペシャルな文字) である必要があります。 初期状態では、 各小文字はハイフネーションコードをそれ自体の文字として持ち、 各大文字はハイフネーションコードを各小文字として持ちます。hpfリクエストも見て下さい。
.hla lang
現在のハイフネーション言語をlangに設定します。hwリクエストで指定されるハイフネーション例外 およびhpfリクエストで指定されるハイフネーションパタンは 現在のハイフネーション言語に関連づけられます。hlaリクエストは通常troffrcファイルから起動されます。
.hlm n
ハイフネーションされた行が連続できる行数の最大値をnに設定します。nが負の場合、最大値はありません。 デフォルト値は -1 です。 この値は現在の環境と関連づけられています。 行数のカウントは、一つの環境の中でその環境での最大値まで行われます。\%の結果のハイフンはカウントされます; 明示的なハイフンはカウントされません。
.hpf file
ハイフネーションパタンをfileから読み込みます; ファイルの探索は、-mnameオプションが指定された時にname.tmacが探されるのと同じ方法で行われます。 このパタンは TeX における \patterns プリミティブの引数と 同じフォーマットである必要があります; このファイル中の文字はハイフネーションコードとして解釈されます。 パタンファイル中の%文字は行末までのコメントを表します。 ハイフネーションパタンのセットはhlaリクエストにより指定される言語に関連づけられます。hpfリクエストは通常troffrcファイルにより起動されます。
.hym n
ハイフネーションマージンnに設定します: 現在の修正モードがbではない時、 行がnより短い場合には行はハイフネーションされません。 デフォルトのハイフネーションマージンは 0 です。 このリクエストに対するデフォルトのスケーリングインジケータはmです。 ハイフネーションマージンは現在の環境と関連づけられています。 現在のハイフネーションマージンは\n[.hym]レジスタを介して利用可能です。
.hys n
ハイフネーション空白をnに設定します: 現在の修正モードがbの場合、 各単語の間の間隔に追加する間隔の幅をn以下で行調整が済ませられる場合、その 行はハイフネーションされません。 デフォルトのハイフネーション空白は 0 です。 このリクエストに対するデフォルトのスケーリングインジケータはmです。 ハイフネーション空白は現在の環境と関連づけられています。 現在のハイフネーション空白は\n[.hys]レジスタを介して利用可能です。
.kern n
nが非 0 か指定されない場合、文字ペア間カーニングを有効にします。 そうでない場合は文字ペア間のカーニングを無効にします。
.length xx string
stringの長さを計算し、これを数値レジスタxx(前もって定義する必要はありません) に入れて返します。
.linetabs n
nが 0 でないか省略されるとライン-タブモードが有効になり、 そうでない場合は無効にします (デフォルトは無効です)。 ライン-タブモードではタブの幅が (現在の) 出力行に応じて 計算されます。そうでない場合は入力行に応じて計算されます。 例えば次のソース
.ds x a\t\c
.ds y b\t\c
.ds z c
.ta 1i 3i
\*x
\*y
\*z
は以下を生成します。
a b c
ライン-タブモードでは同じコードが以下のようになります。
a b c
ライン-タブモードは現在の環境に関連づけられます。ライン-タブモードでは 読み出し専用の数値レジスタ\en[.linetabs]が ~1 にセットされ、そうでなければ 0 にセットされます。
.mso file
-mコマンドラインオプションが指定された場合に マクロファイルを検索するのと同じディレクトリでfileを検索する点を除いてsoリクエストと同じです。 インクルードするファイル名がname.tmacの形式で、見つからない場合は、代わりにmsotmac.nameをインクルードしようとします。 逆もまた同様です。
.nop anything
anythingを実行します。 これは `.if 1' と同様です。
.nroff
nビルトイン条件を真にし、tビルトイン条件を偽にします。troffリクエストを使用することで、逆にできます。
.open stream filename
filenameを書き込みのためにオープンし、streamという名前のストリームと関連づけます。close,writeリクエストも見て下さい。
.opena stream filename
openと同様ですが、filenameが存在する場合、縮小することはせずに、アペンドします。
.pnr
現在定義されている数値レジスタの名前と内容を標準エラー出力に出力します。
.psbb filename
PostScript イメージfilenameのバウンディングボックスを得ます。 このファイルは、 Adobe の Document Structuring Conventions に従うことが必要です。 このコマンドは、%%BoundingBoxコメントを探し、バウンディングボックス値を得ます。 呼び出しに成功すると、 左下と右上の角の座標が (PostScript 単位で)、レジスタ\n[llx],\n[lly],\n[urx],\n[ury]にそれぞれ設定されます。 なんらかのエラーが発生すると、4 個のレジスタは 0 に設定されます。
.pso command
入力がcommandの標準出力であることを除けば、soリクエストのように動作します。
.ptr
全てのトラップ (入力行のトラップと転換のトラップは除きます) の名前と位置を標準エラー出力に出力します。 ページトラップリストの空のスロットも出力されます。 なぜなら、後で設置されるトラップの優先度に影響を与え得るからです。
.rchar c1 c2...
文字c1,c2,... の定義を取り除きます。charリクエストの影響を取り除きます。
.return
マクロ中であれば即座に復帰します。 それ以外では何もしません。
.rj

.rj n後続するn入力行を右揃えします。 引数が無い場合、次の行を右揃えします。 右揃えされる行の数は\n[.rj]レジスタを介して利用可能です。 本リクエストにより暗黙的に.ce 0となります。ceリクエストは暗黙的に.rj 0します。
.rnn xx yy
数値レジスタxxyyにリネームします。
.shc c
ソフトハイフン文字をcにします。cが省略された場合、 ソフトハイフン文字はデフォルトの\(hyになります。 ソフトハイフン文字は、語がラインブレイクによってハイフネーションされる時に 挿入される文字です。 ブレイクすべき位置の直前の文字のフォントにソフトハイフン文字が存在しない場合、 そのような位置ではブレイクしません。 ソフトハイフン文字を見付ける時には、 定義 (charリクエストで指定) も変換 (trリクエストで指定) も解釈されません。
.shift n
マクロ中で引数をnポジションだけシフトします: 引数iは引数i-nとなります; 引数 1 からnは使用不能となります。nが指定されない場合、 引数は 1 シフトされます。 負のシフトは現在未定義です。
.special s1 s2...
フォントs1,s2, はスペシャルであり、 現在のフォントには無い文字が探されます。
.sty n f
スタイルfをフォント位置nと関連づけます。 フォント位置はフォントもしくはスタイルと関連づけ可能です。 現在のフォントはフォント位置のインデックスであり、 つまり、フォントもしくはスタイルです。 現在のフォントがスタイルである場合、 実際に使用されるフォントは、 現在のファミリ名と現在のスタイル名とを結合した名前をもつものとなります。 例えば現在のフォントが 1 であり、フォント位置 1 がスタイルRと関連づけられており、 現在のフォントファミリがTである場合、 フォントTRが使用されます。 現在のフォントがスタイルではない場合、 現在のファミリは無視されます。 リクエストcs,bd,tkf,uf,fspecialがスタイルに適用される場合、 実際は当該スタイルに対応する現在のファミリのメンバに対して適用されます。 デフォルトファミリは-fオプションで設定できます。DESCファイル中のスタイルコマンドが、 (もし存在すれば) どのフォント位置が初期状態において フォントではなくスタイルに関連づけられているのかを制御します。
.substring xx n1 [n2]
レジスタxx中の文字列を、インデックスn1n2で指定されるサブ文字列で置き換えます。 文字列の最初の文字はインデックス 1 です。n2が省略されると、文字列の長さとみなされます。 インデックス値n1またはn2が負または 0 である場合、文字列の末尾から後ろ向きに数えます。 すなわち、最後の文字がインデックス 0 であり、 最後の文字の前の文字が -1 などとなります。
.tkf f s1 n1 s2 n2
フォントfに対しトラックカーニングを有効にします。 現在のフォントがfである場合、 全ての文字の幅がn1からn2の範囲で増加します; 現在のポイントサイズがs1以下の場合、幅はn1増えます; 現在のポイントサイズがs2以上の場合、幅はn2増えます; ポイントサイズがs1以上かつs2以下の場合は、 増加する幅はポイントサイズの線形関数となります。
.tm1 string
tmリクエストと同様です。stringがコピーモードで読み込まれて標準エラーに書き出されます。 ただし先頭に空白を置けるようにするために、stringの最初のダブルクォートは取り除かれます。
.tmc string
tm1と同様ですが最後の改行を出力しません。
.trf filename
透過的にファイルfilenameの内容を出力します。 各行の出力は各行の先頭に\!ついたものとして出力されます。 しかし、 行はコピーモードにおける解釈の対象とはなりません。 ファイルが改行文字で終らない場合、改行文字が追加されます。 例えば、ファイルfの内容を含むマクロxを定義するには、
.di x
.trf f
.di

とします。cfリクエストとは異なり、 ファイル中にはNULといった troff 入力文字として不正なものを含むことはできません。

.trnt abcd
\!により転換へ透過的に取り込まれるテキストに対して適用されないことを除いて、trリクエストと同じです。 例えば、
.tr ab
.di x
\!.tm a
.di
.x

bを表示します;trnttrのかわりに使われた場合、aを表示します。

.troff
nビルトイン状態を偽に、tビルトイン状態を真にします。nroffリクエストの効果を打ち消します。
.unformat xx
このリクエストは、転換xxを `アンフォーマット' します。 転換の整形済み要素を可能な限り入力トークンに復元しようと試みる.asciifyリクエストとは逆に、.unformatは単語間のタブとスペース (通常、入力中のスペースか改行で生じる) のみ 特別扱いします。 前者はそれらが入力トークンであるかのように扱われます。そして後者は 再び伸び縮み可能と扱われます。 行の垂直方向のサイズが保存されないことに注意してください。 グリフ情報 (フォント、フォントサイズ、スペース幅等々) は 保たれます。.box.boxaリクエストと組み合わせると便利です。
.vpt n
nが非 0 の場合 垂直位置トラップを有効にします。 そうでない場合、垂直位置トラップを無効にします。 垂直位置トラップはwh ,dtリクエストにより設定されるトラップです。itリクエストにより設定されるトラップは垂直位置トラップではありません。 垂直位置トラップが発生するか否かを制御するこのパラメータは大域的です。 初期状態では垂直位置トラップは有効です。
.warn n
警告を制御します。nは有効とされるべき警告と関連づけられた数の和です; その他の警告は無効となります。 警告と関連づけられる数のリストは`警告'の章に記載します。 例えば.warn 0は全ての警告を無効にします。 また、.warn 1は存在しない文字に関する警告のみを有効にします。nが与えられない場合、 全ての警告が有効になります。
.while c anything
条件cが真の間、anythingを入力として受け付けます;cifリクエストとして受理可能な任意の条件です; 最初の行が\{で開始され最後の行が\}で終了する場合、anythingは複数行となり得ます。break,continueリクエストも見て下さい。
.write stream anything
anythingstreamという名前のストリームに書き込みます。streamはすでにopenリクエストの対象であったはずです。anythingがコピーモードで読まれます; 先行するsは取り除かれます。
.writem stream xx
マクロまたは文字列xxの内容をstreamで指定されたストリームへ書き出します。streamは事前にopenリクエストでオープンされていなければなりません。xxはコピーモードで読まれます。
 

拡張されたリクエスト

.cf filename
転換の中で使用された場合は、後でその転換が読み込まれるときに、filenameの内容が透過的に出力にコピーされるようなオブジェクトを その転換の中に埋め込みます。
UNIX troff では、 現在、転換の中かどうかにかかわらずfilenameの内容はすぐに出力にコピーされます; この動作は変則的でありバグに違いありません。
.ev xx
xxが数でない場合、xxで呼ばれる名前付き環境に切り替えます。 引数なしのevリクエストに対しては、番号付き環境の場合と同様に、 対応する環境がポップされます。 名前のある環境の数には制限はありません; 最初に参照される時に生成されます。
.fp n f1 f2
fpリクエストはオプションで 3 番目の引数を取ります。 この引数はフォントの外部名を与えます。 この名前でフォント記述ファイルを探します。 2 番目の引数はフォントの内部名であり、 フォントをマウントした後に troff 中でフォントを参照するのに使用します。 3 番目の引数が無い場合は内部名を外部名として使用します。 この機能により、互換モードにて長い名前のフォントを使用できます。
.ss m n
ssリクエストに対し 2 つの引数が与えられる場合、 2 番目の引数は文の空白サイズを与えます。 2 番目の引数が与えられない場合、 文の空白サイズは語の空白サイズと同じになります。 語の空白サイズと同様、文の空白サイズは 現在のフォントの空白幅パラメータの 1/12 を単位とします。 語の空白サイズと文の空白サイズの初期値はともに 12 です。 UNIX troff に反して GNU troff はこのリクエストも nroff モードで 扱います。 それから指定された値は ~12 の倍数で最も近い値に丸められます。 文の空白サイズは 2 つの状況にて使用されます: 行詰めモードにて文の終りとなった場合、 語間の空白と文の空白がともに追加されます; 行の途中にて、文の終りに引続き 2 つの空白が後続する場合、 2 番目の空白は文の空白となります。 リクエストの 2 番目の引数を与えなければ、 GNU troff の動作は UNIX troff の動作と完全に同じになります。 GNU troff では UNIX troff と同様、 改行及び 2 つの空白にて文を追跡します。
.ta n1 n2...nn T r1 r2...rn
タブ位置をn1,n2,...,nnとし、その後タブ位置をnn+r1,nn+r2,....,nn+rnとし、その後タブ位置をnn+rn+r1,nn+rn+r2,...,nn+rn+rn, とし…ということを繰り返します。 例えば、
.ta T .5i

は 1/2 インチ毎にタブ位置とします。

 

新しい数値レジスタ

以下の読み取り専用レジスタが利用可能です:
\n[.C]
互換モード時に 1 に、そうでない場合は 0 になります。
\n[.cdp]
現在の環境に付加されている最後の文字の深さ。 文字がベースラインより下にいく場合に正になります。
\n[.ce]
中央寄せされるべき残りの行数。 この値はceリクエストでセットされます。
\n[.cht]
現在の環境に付加されている最後の文字の高さ。 文字がベースラインの上にいく場合に正になります。
\n[.csk]
現在の環境に付加されている最後の文字のスキュー値。 文字のスキューは、その文字の上に付くアクセントが その文字の中央からどれだけ右によって配置されるかを表します。
\n[.ev]
現在の環境の名前もしくは番号。 これは文字列で値を保持するレジスタです。
\n[.fam]
現在のフォントファミリ。 これは文字列で値を保持するレジスタです。
\n[.fp]
次のフリーフォント位置の数を表します。
\n[.g]
常に 1 です。 マクロ中で GNU troff 下で動作しているかどうかを判定するには、この値を 使用すること。
\n[.hla]
hlaリクエストにより設定された現在のハイフネーション言語。
\n[.hlc]
連続してハイフネーション処理した行数。
\n[.hlm]
連続してハイフネーション処理して良い最大値。 この値は、hlmリクエストで設定されます。
\n[.hy]
現在のハイフネーションフラグ (hyリクエストにて設定されます)。
\n[.hym]
現在のハイフネーションマージン (hymリクエストにて設定されます)。
\n[.hys]
現在のハイフネーション空白 (hysリクエストにて設定されます)。
\n[.in]
現在の出力行に適用されているインデント。
\n[.int]
直前の出力行が割り込まれた場合に正の値に設定されます (つまり\cを含んでいる場合です)。
\n[.kern]
文字ペア間カーニングが有効なら1、そうでないなら0です。
\n[.lg]
現在のリガチャモードを表します (lgリクエストにて設定されます)。
\n[.linetabs]
現在のライン-タブモード (linetabsリクエストで設定された)。
\n[.ll]
現在の出力行に適用する行の長さ。
\n[.lt]
ltリクエストにより設定されたタイトル長。
\n[.ne]
最後にトラップを起こしたneリクエストに必要だった空白の量。\n[.trunc]レジスタとともに使用します。
\n[.ns]
空白モードが有効でない場合は1で、そうでない場合は0です。
\n[.pn]
次のページ番号:pnリクエストにて設定されるか、現在のページ番号に 1 を加えたものです。
\n[.ps]
スケールドポイント単位で表した現在のポイントサイズです。
\n[.psr]
スケールドポイント単位で表した最後にリクエストされたポイントサイズです。
\n[.rj]
右揃えすべき行数。rjリクエストにより設定されます。
\n[.sr]
最後にリクエストされた10進数分数ポイントで表すポイントサイズ。 これは文字列で値を保持するレジスタです。
\n[.tabs]
現在のタブ設定の文字列表記であり、taリクエストの引数としてそのまま利用可能です。
\n[.trunc]
最後に発生した垂直位置トラップにより縮められた垂直空白の量。 トラップがneリクエストにて生じた場合、neリクエストにより垂直位置位置の移動分は差し引かれます。 言い替えるなら、 トラップが発生した場所で、トラップがなかったとした場合の垂直位置と、 実際の垂直位置との差を表します。\n[.ne]レジスタとともに使用すると効果があります。
\n[.ss]

\n[.sss]ssリクエストの最初の引数および 2 番目の引数により設定された値を与えます。
\n[.vpt]
垂直位置トラップが有効の場合 1、そうでない場合は 0 です。
\n[.warn]
現在有効となっている警告に関連づけられている数の和です。 警告に関連づけられている数字のリストは`警告'節に記載されています。
\n[.x]
メジャーバージョン番号。 例えばバージョン番号が1.03の場合、\n[.x]1です。
\n[.y]
マイナバージョン番号。 例えばバージョン番号が1.03の場合、\n[.y]03です。
\n[.Y]
groff のバージョン番号。
\n[llx]

\n[lly]
\n[urx]
\n[ury]これらの 4 個のレジスタは、.psbbリクエストによって設定され、指定された PostScript イメージに対する (PostScript 単位での) バウンディングボックス情報を保持します。

以下の読み書き可能レジスタは\wエスケープシーケンスで設定されます:

\n[rst]
\n[rsb]st,sbレジスタと同様ですが、文字の高さと深さも考慮に入れます。
\n[ssc]
最後の文字から下付き文字までに加えられる水平空白の量。 負も取り得ます。
\n[skw]
\w引数における最後の文字の中央からどれほど右にずれて、 ローマンフォントのアクセントの中央がその文字上に配置されるかを表します。

他に利用可能な読み書き可能の数値レジスタとして以下があります:

\n[c.]
現在の入力行番号。\n[.c]はこのレジスタの別名であり、読み出し専用です。
\n[hp]
入力行での現在の水平位置です。
\n[systat]
syリクエストにより 最後に実行された system() の戻り値。
\n[slimit]
0 より大きい場合、入力スタックの最大オブジェクト数を表します。 0 以下の場合、入力スタック上のオブジェクト数に制限はありません。 制限が無い場合、仮想記憶を使い果たすまで再帰が続くことがあります。
\n[year]
現在の年。 伝統的なtroff数値レジスタ\n[yr]は、現在の年から 1900 を減じた値であることに注意してください。
 

その他

troffは、(読み書き用) 文字列ベースのレジスタ\*(.Tを前もって定義しており、これには-Tコマンドラインオプションに与えられた引数、 すなわち現在の出力デバイスを保持しています (例えばlatin1ascii)。 これは、(読み込み専用の) 数値レジスタ\n[.T]が、troff-Tコマンドラインオプション付で呼び出されたときに 1 に定義され、 そうでないときに 0 に定義されるのとは同じではありません。 この動作は、UNIX troff とは異なります。

DESCファイルに記述されていないフォントは、 参照された時点で自動的に次の利用可能なフォント位置にマウントされます。 フォントを明示的にfpリクエストにて未使用のフォント位置にマウントする場合、 最初の未使用のフォント位置にマウントしなければなりません。 この位置は\n[.fp]レジスタにて参照できます; しかしながら、troffはこれを厳密には強いません。 現在使用されている位置よりも 多大に大きくずれる位置にマウントされることは許されません。

文字列の挿入は既に存在するマクロ引数を隠しはしません。 それゆえマクロ中で

.xx \\$@

をより効率良く行うためには、

\\*[xx]\\

とします。

フォント記述ファイルに文字ペア間カーニング情報が含まれる場合、 このフォントから出力される文字はカーニングされます。\&を 2 つの文字間に置くことで、その文字間のカーニングを禁止できます。

条件において文字列を比較する場合、 最初のデリミタと異なる入力レベルにおいて出現する文字は 2 番目 3 番目のデリミタとして認識されません。 これはtlリクエストにも当てはまります。\wエスケープシーケンスにおいて、 最初のデリミタ文字とは異なる入力レベルにある閉じる方のデリミタ文字は、 認識されません。 マクロ引数をデコードする時に、 マクロ引数がダブルクォートで区切られる場合、 最初のデリミタ文字とは異なる入力レベルにある文字は、 閉じる方のデリミタ文字とは認識されません。\$@の実装では、引数を括るダブルクォートは同じレベルとなることが保証されています。 このレベルは引数の入力レベルとは異なります。 長いエスケープ名中では]は 開く方の]の入力レベルと同じである場合を除き、 閉じる方のデリミタとは認識されません。 互換モードでは入力レベルに対する注意は払われません。

条件が増えました:

.if rxxx
数値レジスタxxxが存在する場合に真となります。
.if dxxx
文字列/マクロ/転換/リクエストにxxxという名前のものがあった場合に真になります。
.if cch
文字chが使用可能な場合に真になります;chASCII文字でもスペシャル文字\(xx,\[xxx]でもかまいません;chcharリクエストにて定義された場合にも真になります。

trリクエストは文字を\~にマップできるようになりました。 

警告

troffが出力する警告は以下のカテゴリに分類されます。 各警告に関連する名前は-w,-Wオプションで使用可能です; また番号は、warnリクエストおよび.warnレジスタが使用します。
char1
存在しない文字。 デフォルトで有効です。
number2
不正な数式。 デフォルトで有効です。
break4
行詰めモードにて、行を分割できなかったため、 行の長さよりも短くなってしまいました。 デフォルトで有効です。
delim8
閉じる方のデリミタが無いもしくはマッチしません。
el16
対応するieリクエストの無い、elリクエスト。
scale32
意味の無いスケーリングインジゲータ。
range64
引数が範囲を越えています。
syntax128
数式中の曖昧な文法。
di256
現在転換が無いにもかかわらず、 引数無しでdi,daを使用した。
mac512
未定義の文字列、マクロ、転換を使用した。 未定義の文字列、マクロ、転換を使用した場合、 文字列が自動的に空に定義されます。 このため各名前に対する警告は大概最大 1 回だけです。
reg1024
未定義の数値レジスタを使用した。 未定義の数値レジスタを使用した場合、 レジスタが自動的に値 0 に定義されます。 定義は自動的に値 0 にて行われます。 このため各名前に対する警告は大概最大 1 回だけです。
tab2048
タブ文字の使用が不適切でした。 数字が期待される場所でタブを使用したか、 クォートされいてないマクロの引数中でタブ文字を使用したかの どちらかでしょう。
right-brace4096
数字が期待される場所で\}が使用された。
missing8192
非オプション引数が足りないリクエスト。
input16384
不正な入力文字。
escape32768
認識できないエスケープシーケンス。 認識できないエスケープシーケンスに会った場合は、 そのエスケープ文字は無視されます。
space65536
リクエストもしくはマクロとそれらの引数の間に空白がありません。 この警告は、2 文字より長い未定義の文字に会った場合で 最初の 2 文字が定義された名前のときに起こり得ます。 このときリクエストもしくはマクロは起動されません。 この警告が発せられる時、どのようなマクロも自動的には定義されません。 デフォルトで有効です。 この警告は互換モードでは起こり得ません。
font131072
存在しないフォント。 デフォルトで有効です。
ig262144
igリクエストにより無視されたテキストの中にある不正なエスケープ。 これらは無視されたテキストの中では発生しないエラーです。

警告のグループを指定する名前もあります:

all
すべて、ただしdi,mac,regを除きます。 伝統的なマクロパッケージを使用する際に有用な警告の全てをカバーする ように導入されました。
w
全ての警告。
 

非互換性

長い名前を使用すると非互換性の問題が起こる場合があります。 UNIX troff は

.dsabcd

を文字列abの定義であり、その内容がcdであると解釈します。 通常、GNU troff はこれをマクロdsabcdの呼び出しであると解釈します。 また、UNIX troff は\*[\n[を、文字列/数値レジスタ[の参照であると解釈します。 しかし、GNU troff では、これは通常長い名前の始まりであると解釈します。互換モードでは GNU troff はこれらを伝統的な方法で解釈します。 また長い名前は認識されません。 互換モードは-Cコマンドラインオプションにて有効に出来、cpリクエストにて有効無効の切替えが出来ます。 互換モードが有効の場合には数値レジスタ\n[.C]が 1 となり、そうでない場合は 0 となります。

GNU troff は文字列/マクロ/展開/数値レジスタ/フォント/環境の名前において、 エスケープシーケンス\e\|\^\&\}\{\(space)\'\`\-\_\!\%\cを使用することを許しません; 一方 UNIX troff では出来ます。 名前中でのこれらのエスケープシーケンスの使用を避けるには、\Aエスケープシーケンスが役に立つかもしれません。

分数のポイントサイズは顕著な非互換性を引き起こします。 UNIX troff ではpsリクエストはスケールインジケータを無視するため

.ps 10u

はポイントサイズを 10 ポイントに設定しますが、 GNU troff ではポイントサイズを 10 スケールドポイントに設定します。

GNU torff では、 フォーマットされていない入力文字と フォーマットされた出力文字との間に基本的な違いがあります。 出力文字がどのように出力されるのかに影響することがらは全て、 その文字に記録されています。 一度出力文字が構成されたならば、 その出力文字はその後に実行されるリクエストの影響を受けません。 このリクエストにはbd,cs,tkf,tr,fpリクエストが含まれます。 通常、 出力文字が入力文字から構成されるのは、 出力文字が現在の出力行に追加される直前です。 マクロ/転換/文字列は実際同じタイプのオブジェクトです; すなわち入力文字のリストと出力の文字の任意の組み合わせのリストを保持しています。 マクロ処理においては出力文字は入力文字のようには振舞いません; 出力文字は、その元の入力文字が持っていた特殊なプロパティを 一切継承しません。 例えば、

.di x
\\\\
.br
.di
.x

は GNU groff では\\を表示します; 各\のペアは単一の出力\になり、出力結果の複数の\は、再読み込みの時にはエスケープ文字としては解釈されません。 UNIX troff では再読み込みの時にはエスケープ文字として解釈されるため、 最終的な結果は単一の\となります。 表示可能な\を得る正しい方法は、\eエスケープシーケンスを使用することです: このエスケープシーケンスは、 転換の中であるか否にかかわらず、 常に現在のエスケープ文字実体を一つ表示します; これは GNU troff でも UNIX troff でも動作します。 転換中に、 転換が再読み込みされた時に解釈されるような エスケープシーケンスを埋め込みたい場合、 伝統的な\!透過出力機構を使用するか、これが適当でないなら新しい\?エスケープシーケンスを使用して下さい。 

環境変数

GROFF_TMAC_PATH
:で区切られた、マクロファイルを検索すべきディレクトリ名のリスト。troffは、それらの前に-Mオプションで指定されたディレクトリを調べ、 そららの後で標準のディレクトリ (安全でないモードでは 現在のディレクトリ、ホームディレクトリ、/usr/share/tmac/,/usr/share/tmac/,/usr/share/tmac/) を調べます。
GROFF_TYPESETTER
デフォルトの出力デバイス
GROFF_FONT_PATH
:で区切られた、フォントを検索すべきディレクトリ名のリスト。 troff は、まず -F オプションで指定されたディレクトリを検索し、次に本環 境変数で指定されたディレクトリ、最後に標準のディレクトリ (/usr/share/groff_font) を検索します。
 

関連ファイル

u+3n
/usr/share/tmac/troffrc初期化ファイル (他のマクロパッケージの前に呼び出されます)
/usr/share/tmac/troffrc-end
初期化ファイル (他のマクロパッケージの後に呼び出されます)
/usr/share/tmac/name.tmac

/usr/share/tmac/tmac.nameマクロファイル
/usr/share/groff_font/devname/DESC
デバイスnameのデバイス記述ファイル
/usr/share/groff_font/devname/F
デバイスnameにおけるフォントFのフォント記述ファイル

troffrctroffrc-endは、セキュリティのためデフォルトで現在のディレクトリと ホームディレクトリのいずれでも検索されない事に注意してください (-Uオプションが指定されていても)。 必要な場合は-MコマンドラインオプションかGROFF_TMAC_PATH環境変数を使ってそれらのディレクトリを検索パスに加えられます。 

関連項目

groff(7) -- 短いですが、リクエスト、レジスタ、エスケープに関する 完全なリファレンスです。

groff(1),tbl(1),pic(1),eqn(1),refer(1),soelim(1),grn(1),grops(1),grodvi(1),grotty(1),grohtml(1),grolj4(1),groff_font(5),groff_out(5),groff_char(7)


関連キーワード

リクエスト,フォント,マクロ,troff,レジスタ,サイズ,モード,ポイント,ディレクトリ,トラップ 

Index

名称
書式
解説
オプション
使用法
長い名前
分数のポイントサイズ
数値式
新しいエスケープシーケンス
新しいリクエスト
拡張されたリクエスト
新しい数値レジスタ
その他
警告
非互換性
環境変数
関連ファイル
関連項目

This document was created byman2html, using the manual pages.
Time: 15:49:14 GMT, July 11, 2021