troff コマンド

目的

タイプセット・デバイスでの印刷のためテキストをフォーマットします。

構文

troff -a ] [  -i ] [  -q ] [  -z ] [  -F Directory ] [  -n Number ] [  -o List ] [  -r ANumber ] [  -s Number ] [  -T Name ] [  -mm | -me | -mptx | -ms | -man | -mv ] [ -M Media ] [ File ... |  ]

説明

troff コマンドは、1 つ以上のファイルを読んで、 フォトタイプセッターまたはそれに相当するデバイス上で印刷できるようにテキストをフォーマットします。 次に、目的のデバイスに対する troff コマンドの出力のポストプロセスを行うために、 ポストプロセッサーが必要になります。 後述のを参照してください。

ファイルを指定しないか、または - (マイナス) フラグが最後のパラメーターではない場合は、デフォルトで標準入力が読み取られます。

3812 プリンター、3816 プリンター、および Hewlett-Packard LaserJet Series II プリンターのデフォルトのフォントが、 そのプリンターの固有フォントです。 これらのプリンターでは追加フォントも使用できます。追加フォントは troff .fp ディレクティブを使用してロードできます。これらの追加フォントはホスト上のディレクトリー /usr/lib/font/devPrinter/bitmaps に保管されており、 必要に応じてプリンターにダウンロードします。

書体

3 つの異なる書体が、4 つのスタイルで提供されています。 以下の表は、書体、スタイル、 および troff コマンドがフォントにアクセスするために使用する名前の対応を示しています。
注: この集合のフォントは、 Donald E Knuth によって開発されたコンピューター Modern 文字に基づいています。 (Knuth, Donald: Computer Modern Typefaces (Addison-Wesley, 1986)) を参照。

Typeface      Regular     Italic       Bold        Italic

Roman         cr          cR           Cr          CR

Sans Serif    cs          cS           Cs          CS

Typewriter    ct          cT           Ct          CT

troff special sp

これらのフォントは、すべて標準の 15 個の troff サイズ、すなわち、6、7、8、9、10、11、12、14、 16、28、20、22、24、28、36 ポイントで提供されます。

例えば、.fp 1 Cr は、Roman のボールド・フォントを 1 の位置へロードします。

注: troff コマンドに対する入力の中の最初の中断作成要求の前に、 .tl 要求を使用することはできません。

フラグ

項目 説明
-a 印刷可能で、ASCII に相当する形でフォーマットされた結果を標準出力に送ります。
-FDirectory デフォルトの /usr/lib/font/devName ディレクトリーではなく、 Directory/devName ディレクトリーのフォント情報にアクセスします (Name-T フラグで指定します)。
-i ファイルがなくなると標準入力を読みます。
-M Media 用紙上のイメージ可能領域の大きさを判別するために、用紙サイズを指定します。 Media 変数で有効な値は以下のとおりです。
A4
用紙サイズ 8.3 X 11.7 インチ (210 X 297 mm) を指定します。
A5
用紙サイズ 5.83 X 8.27 インチ (148 X 210 mm) を指定します。
B5
用紙サイズ 6.9 X 9.8 インチ (176 X 250 mm) を指定します。
EXEC
用紙サイズ 7.25 × 10.5 インチ (184.2 × 266.7 mm) を指定します。
LEGAL
用紙サイズ 8.5 X 14 インチ (215.9 X 355.6 mm) を指定します。
LETTER
用紙サイズ 8.5 X 11 インチ (215.9 X 279.4 mm) を指定します。これはデフォルト値です。
注: Media 変数では大文字小文字の区別はありません。
-nNumber Number 変数で指定された値を使って最初の印刷ページに番号を付けます。
-oList List 変数で指定されたページだけを印刷します。 List は以下のように、ページ番号と範囲をコンマで区切ったリストです。
  • Start-Stop の範囲は、Start から Stop までのページの印刷を意味します。 例えば、9-15 であれば、9 ページから 15 ページまでが印刷されます。
  • 最初の -Stop は、先頭ページからページ Stop までの印刷を意味します。
  • 最後の Start- は、ページ Start から最終ページまでの印刷を意味します。
  • ページ番号と範囲を組み合わせると、指定したページが印刷されます。例えば、 -3,6-8,10,12- では、先頭ページから 3 ページまで、6 ページから 8 ページまで、10 ページ、12 ページから最終ページまでを印刷します。
    注: このフラグをパイプラインで使用する場合 (例えば、piceqntbl コマンドの 1 つ以上と一緒に)、文書の最後のページを List 変数で指定しないと、broken pipe メッセージを受け取ることがあります。この broken pipe メッセージは問題があることを示すものではないので、無視してかまいません。
-q .rd 要求の同時入出力モードを呼び出します。
-rANumber A 変数で指定されたレジスターを指定の数値に設定します。A 変数の値は、1 文字の ASCII 名でなくてはなりません。
-sNumber 指定されたページ数ごとにタイプセッターを停止させる出力を生成します。
-TName 指定された印刷装置の出力を作成します。フォトタイプセッターまたはそれに相当する印刷装置は、オペレーティング・システム国際拡張文字に以下の Name 変数を使用しています。 デフォルトは ibm3816 です。
注: 指定されたポイント・サイズをデバイスがサポートしていない場合は、bad point size というメッセージが表示されます。troff コマンドは最も近い有効ポイント・サイズを使ってフォーマットを継続します。
canonls
Canon Lasershot LBP-B406S/D/E,A404/E,A304E
ibm3812
3812 Pageprinter II
ibm3816
3816 Pageprinter
hplj
Hewlett-Packard LaserJet II
ibm5585H-T
5585-H01 中国語 (繁体字) サポート
ibm5587G
5587-G01、5584-H02、5585-H01、5587-H01、5589-H01 Kanji Printer マルチバイト言語サポート
psc
PostScript プリンター。
X100
AIXwindows ディスプレイ
注: また、troff コマンドの -TName フラグを使用するのではなく、TYPESETTER 環境変数を上記の値のいずれかに設定することもできます。
-man man マクロ処理パッケージを選択します。
-me me マクロ処理パッケージを選択します。
-mm mm マクロ処理パッケージを選択します。
-mptx mptx マクロ処理パッケージを選択します。
-ms ms マクロ処理パッケージを選択します。
-mv mv マクロ処理パッケージを選択します。

マクロの詳細は、フォーマット・ツールのためのマクロ・パッケージのセクションを参照してください。

項目 説明
-z .tm (ワークステーション・メッセージ) 要求によって生成されたメッセージだけを印刷します。
- 入力を標準入力から読み取るようにします。

環境変数

項目 説明
TYPESETTER 特定の印刷装置の情報を保持します。

troff コマンドの例を以下に示します。


troff -Tibm3812 File | ibm3812 | qprt

フォーマット・ツールのためのマクロ・パッケージ

以下のマクロ・パッケージは、テキスト・フォーマット・システム内のフォーマット・ツールの一部です。詳細は次ページ以降を参照してください。

項目 説明
man これを使用すると、オンラインのブック・ページから独自のブック・ページを作成できます。
me 用紙をフォーマットするためのマクロを提供します。
mm nroff および troff フォーマット・プログラムを使用して文書をフォーマットします。
mptx 順列索引をフォーマットします。
ms 各種のスタイルの記事、論文、著書のフォーマット機能を提供します。
mv troff コマンドを使用して、英語表示のグラフとスライドをタイプセットします。

nroff および troff コマンド用 man マクロ・パッケージ

man マクロ・パッケージは、nroff コマンドまたは troff コマンドのいずれかを使って処理されたオンラインのブック・ページから、ユーザーが独自のブック・ページを作成できるようにするために提供されています。 man マクロ・パッケージは、nroff コマンドまたは troff コマンドのいずれかと一緒に使用します。

以下に示すフォーマット・マクロ文字列レジスターの一覧に加えて、特殊なマクロ、文字列、数値レジスターが man マクロ・パッケージ内部にあります。 troff コマンドで事前定義した名前と dmy 数値レジスターを除き、このような内部名の形式はすべて SymbolAlpha となります。Symbol)]} のいずれかで、Alpha は任意の英数字です。

man マクロ・パッケージは Roman フォントだけを使用します。エントリーの入力テキストにその他のフォントを求める要求 (例えば、.I フォーマット・マクロ、.RB 要求、¥fI 要求など) が含まれている場合は、対応するフォントをマウントする必要があります。

フォーマット・マクロ

以下のマクロは、man マクロ・パッケージを使用してフォーマットしたブック・ページの特性を変更するのに使用します。

タイプ・フォントおよびサイズは、各パラグラフの前と、フォントおよびサイズ設定マクロ (例えば、.I フォーマット・マクロ、.SM フォーマット・マクロ、.B フォーマット・マクロ) の処理後に、デフォルト値にリセットされます。

タブ・ストップは、.DT フォーマット・マクロおよび .TH フォーマット・マクロ以外のフォーマット・マクロによって使用または設定されることはありません。

.B [Text]
テキストをボールドにします。

Text 変数は 6 桁までのワードを表します。ワード内に文字スペースを入れるには、" " (二重引用符) を使用します。変数が空の場合、この処理は印刷するテキストが入っている次の入力テキスト行に適用されます。 例えば、行全体をイタリックにするには .I フォーマット・マクロを使用し、 行全体を縮小ボールドのテキストにするには、.SM および .B フォーマット・マクロを使用します。 デフォルトでは、nroff コマンドのハイフン付けはオフですが、 troff コマンドではオンのままです。

.DT
デフォルトのタブ設定値を、nroff コマンドでは 5 en ごとに、troff コマンドでは 7.2 en ごとに復元します。
.HP [Indent]
Indent 変数で指定したハンギング・インデントからパラグラフを開始します。

Indent 変数を省略すると、 Indent の直前の値が使用されます。 この値は、.TH フォーマット・マクロ、 .P フォーマット・マクロ、.RS フォーマット・マクロによってデフォルト (nroff コマンドでは 5 en、troff コマンドでは 7.2 en) に設定され、.RE フォーマット・マクロによって復元されます。 Indent のデフォルト単位は en です。

.I [Text]
テキストをイタリックにします。

Text 変数は 6 桁までのワードを表します。ワード内に文字スペースを入れるには、" " (二重引用符) を使用します。変数が空の場合、この処理は印刷するテキストが入っている次の入力テキスト行に適用されます。 例えば、行全体をイタリックにするには .I フォーマット・マクロを使用し、 行全体を縮小ボールドのテキストにするには、.SM および .B フォーマット・マクロを使用します。 デフォルトでは、nroff コマンドのハイフン付けはオフですが、 troff コマンドではオンのままです。

.IP [Tag] [Indent]
.TP Indent マクロに Tag 変数を指定したものと同じです。Tag 変数の値が NULL の場合、字下げされたパラグラフを開始します。このマクロは、タグの付かない字下げされたパラグラフを生成するのによく使用されます。

Indent 変数を省略すると、 Indent の直前の値が使用されます。 この値は、.TH フォーマット・マクロ、 .P フォーマット・マクロ、.RS フォーマット・マクロによってデフォルト (nroff コマンドでは 5 en、troff コマンドでは 7.2 en) に設定され、.RE フォーマット・マクロによって復元されます。 Indent のデフォルト単位は en です。

.P
通常のフォント、ポイント・サイズ、インデントでパラグラフを開始します。 .PP マクロは mm マクロ・パッケージの .P マクロと同義です。
.PD [Number]
パラグラフ間の間隔を Number パラメーターで指定した垂直スペースの数に設定します。 デフォルトの Number 変数値は、troff コマンドでは 0.4v、nroff コマンドでは 1v です。
.PM [Indicator]
以下のような所有権のマーキングを設定します。
インジケーター マーキング
P PRIVATE
N NOTICE
Indicator を指定しない 所有権のマーキングをオフにする

.RE [Number]
Number 変数で指定したインデント・レベル位置にある相対インデント (.RS) を終了します。Number 変数値を省略すると、直前の浅いインデント・レベルに戻ります。
.RI Character1Character2...
Roman の Character1 とイタリックの Character2 を結合し、 最大 6 セットの Character1Character2 でこの 2 種類のフォントを交換します。 同様のマクロは、Roman、イタリック、ボールドのいずれか 2 つの組み合わせ (.IR.RB.BR .IB .BI マクロ) で交換を行います。
.RS [Indent]
相対インデント (最初は 0) を増加します。 すべての出力は、Indent 変数で指定した左マージンから余分の単位数だけ字下げされます。

Indent 変数を省略すると、 Indent の直前の値が使用されます。 この値は、.TH フォーマット・マクロ、 .P フォーマット・マクロ、.RS フォーマット・マクロによってデフォルト (nroff コマンドでは 5 en、troff コマンドでは 7.2 en) に設定され、.RE フォーマット・マクロによって復元されます。 Indent のデフォルト単位は en です。

.SH [Text]
小ヘッダーのテキストを置きます。

Text 変数は 6 桁までのワードを表します。ワード内に文字スペースを入れるには、" " (二重引用符) を使用します。変数が空の場合、この処理は印刷するテキストが入っている次の入力テキスト行に適用されます。 例えば、行全体をイタリックにするには .I フォーマット・マクロを使用し、 行全体を縮小ボールドのテキストにするには、.SM および .B フォーマット・マクロを使用します。 デフォルトでは、nroff コマンドのハイフン付けはオフですが、 troff コマンドではオンのままです。

.SM [Text]
テキストをデフォルトのポイント・サイズよりも 1 ポイント小さくします。

Text 変数は 6 桁までのワードを表します。ワード内に文字スペースを入れるには、" " (二重引用符) を使用します。変数が空の場合、この処理は印刷するテキストが入っている次の入力テキスト行に適用されます。 例えば、行全体をイタリックにするには .I フォーマット・マクロを使用し、 行全体を縮小ボールドのテキストにするには、.SM および .B フォーマット・マクロを使用します。 デフォルトでは、nroff コマンドのハイフン付けはオフですが、 troff コマンドではオンのままです。

.SS [Text]
小小ヘッダーのテキストを置きます。

Text 変数は 6 桁までのワードを表します。ワード内に文字スペースを入れるには、" " (二重引用符) を使用します。変数が空の場合、この処理は印刷するテキストが入っている次の入力テキスト行に適用されます。 例えば、行全体をイタリックにするには .I フォーマット・マクロを使用し、 行全体を縮小ボールドのテキストにするには、.SM および .B フォーマット・マクロを使用します。 デフォルトでは、nroff コマンドのハイフン付けはオフですが、 troff コマンドではオンのままです。

.TH [Title][Section][Commentary][Name]
タイトルおよびエントリーの見出しを設定します。 このマクロは .DT フォーマット・マクロを呼び出します。
変数 マーキング
Title タイトル
Section セクション番号
Commentary 特別なコメント
Name 新しいブック名
注: .TH フォーマット・マクロの値に、" " (二重引用符) で囲まれていない文字スペースが含まれていると、不規則なドットが出力に示されます。
.TP [Indent]
ハンギング・タグの付いた字下げされたパラグラフを開始します。 テキストが入っている次の入力行はタグです。 タグが適切でない場合には別の行に印刷されます。

Indent 変数を省略すると、 Indent の直前の値が使用されます。 この値は、.TH フォーマット・マクロ、 .P フォーマット・マクロ、.RS フォーマット・マクロによってデフォルト (nroff コマンドでは 5 en、troff コマンドでは 7.2 en) に設定され、.RE フォーマット・マクロによって復元されます。 Indent のデフォルト単位は en です。

文字列

項目 説明
¥*R 商標を追加します。 nroff コマンドでは (Reg.)、 troff コマンドでは登録商標記号です。
¥*S デフォルトのタイプ・サイズに変更します。
¥*(Tm 商標インジケーターを追加します。

レジスター

項目 説明
IN 小ヘッダーに関連付けられているインデントの左マージン。 デフォルトは、troff コマンドでは 7.2 en、 nroff コマンドでは 5 en です。
LL IN レジスターで指定した値を含む行の長さ。
PD 現在のパラグラフ間の間隔。

フラグ

項目 説明
-rs1 幅 6.5 インチ、長さ 10 インチのテキスト域を持つ幅 8.5 インチ、 長さ 11 インチのデフォルトのページ・サイズを、幅 4.75 インチ、 長さ 8.375 インチのテキスト域を持つ幅 6 インチ、長さ 9 インチのページ・サイズに縮小します。 このフラグはまた、デフォルトのタイプ・サイズを 10 ポイントから 9 ポイントに、 縦方向の行送りを 12 ポイントから 10 ポイントに縮小します。

  1. ファイル your.book を処理し、フォーマットされた出力をローカル・ライン・プリンター qprt に送信するには、以下のように入力します。
    
    nroff -Tlp -man your.book | qprt -dp 
  2. テーブルが入っているファイル my.book および dept.book を処理し、フォーマットされた出力をローカル・ライン・プリンター qprt に送信するには、以下のように入力します。
    tbl my.book dept.book | nroff -Tlp -man | col -Tlp | qprt -dp
    注: 出力は、qprt に送信される前に、 まず col コマンドによるフィルターにかけられ、 tbl コマンドが使用する逆方向の行送りを処理します。
  3. ピクチャー、グラフ、テーブルが入っているファイル group を処理し、IBM® 3816 プリンターで処理できるようにフォーマットされた出力を作成するには、以下のように入力します。
    grap group | pic | tbl | troff -Tibm3816 -man ¥
      | ibm3816 | qprt -dp
注:
  1. man マクロ・パッケージを使って作成したブック・ページがオンライン機能を目的としている場合には、 grap コマンドまたは pic コマンドなどの troff コマンドを必要とするコンポーネントは使用しないでください。
  2. grap コマンドは pic コマンドのプリプロセッサーであるため、pic コマンドより先に実行します。 この逆の順序ですと正しくフォーマットされません。
  3. col コマンドは、 tbl コマンドのフィルターとしては必要ありません。 つまり、タイプセット文書には逆方向の行送りは不要です。

nroff および troff コマンド用 me マクロ・パッケージ

nroff コマンドおよび troff コマンドのマクロ定義の me パッケージは、 各種フォーマットによる技術文書のためのフォーマット機能を提供します。 場合によっては、nroff の出力のポストプロセスを行うために col コマンドが必要になります。

マクロ要求は、次の me 要求のセクションで定義します。 このパッケージとともに使用すると、 予測できない結果が生じることが考えられる nroff/troff 要求が多くあります。 しかし、以下の要求は最初の .pp 要求の後に使用できます。

項目 説明
.bp 新しいページを開始します。
.br ここで出力行を中断します。
.ce [Number] 指定された次の行数の中央揃えを行います。 デフォルトは 1 です。
.ls [Number] 行間隔を設定します。 テキストは、Number を 1 に設定するとシングル・スペースで、 2 に設定するとダブルスペースで行送りされます。
.na 右マージンを揃えないままにします。
.sp [Number] 指定した数だけスペース行を挿入します。
.sz [+]Number 指定された数をポイント・サイズに追加します。
.ul [Number] 指定された次の行数に下線を引きます。 デフォルトは 1 です。

式およびテーブルのための eqnneqnrefertbl コマンドのプリプロセッサーの出力は、 入力として使用できます。

me 要求

me マクロに使用できるすべてのマクロ、文字列、数値レジスターを以下に示します。 選択した troff コマンド、レジスター、関数も含まれています。

項目 説明
¥(space) 埋め込み不可のスペースを定義します (troff コマンドの組み込み関数)。
¥“ 行の終わりにコメントを付けます (troff コマンドの組み込み関数)。
¥*# オプションの遅延テキスト・タグ文字列を指定します。
¥$Number Number 変数で指定した値を補間します (troff コマンドの組み込み関数)。
¥n($0 セクションの深さを定義します (数値レジスター)。
.$0 セクションのタイトルが印刷された後に開始されます (ユーザー定義可能マクロ)。
¥n($1 最初のセクション番号を定義します (数値レジスター)。
.$1 深さ 1 のセクションの印刷前に開始されます (ユーザー定義可能マクロ)。
¥n($2 2 番目のセクション番号を定義します (数値レジスター)。
.$2 深さ 2 のセクションの印刷前に開始されます (ユーザー定義可能マクロ)。
¥n($3 3 番目のセクション番号を定義します (数値レジスター)。
.$3 深さ 3 のセクションの印刷前に開始されます (ユーザー定義可能マクロ)。
¥n($4 4 番目のセクション番号を定義します (数値レジスター)。
.$4 深さ 4 のセクションの印刷前に開始されます (ユーザー定義可能マクロ)。
¥n($5 5 番目のセクション番号を定義します (数値レジスター)。
.$5 深さ 5 のセクションの印刷前に開始されます (ユーザー定義可能マクロ)。
¥n($6 6 番目のセクション番号を定義します (数値レジスター)。
.$6 深さ 6 のセクションの印刷前に開始されます (ユーザー定義可能マクロ)。
.$C 章の冒頭で呼び出されます (ユーザー定義可能マクロ)。
.$H テキストのヘッダーを指定します (ユーザー定義可能マクロ)。
¥n($R ディスプレイ内に相対垂直スペーシングを定義します (デフォルトで定義された数値レジスターのため、 変更できません)。
¥n($c 現在の列のヘッダーを定義します (数値レジスター)。
.$c 章のタイトルを印刷します (デフォルトで定義されたマクロのため、変更できません)。
¥n($d 遅延テキスト番号を指定します (数値レジスター)。
¥n($f 脚注番号を指定します (数値レジスター)。
.$f フッターを印刷します (デフォルトで定義されたマクロのため、変更できません)。
.$h ヘッダーを印刷します (デフォルトで定義されたマクロのため、変更できません)。
¥n($i パラグラフ単位のインデントを定義します (数値レジスター)。
¥n($l 列幅を定義します (数値レジスター)。
¥n($m 有効な列の数を指定します (数値レジスター)。
¥*($n セクション名を指定します (文字列)。
¥n($p 番号付きパラグラフの番号を定義します (数値レジスター)。
.$p セクションの見出しを印刷します (デフォルトで定義されたマクロのため、変更できません)。
¥n($r テキスト内に相対垂直スペーシングを定義します (デフォルトで定義された数値レジスターのため、 変更できません)。
¥n($s 列インデントを定義します (数値レジスター)。
.$s 脚注をテキストから切り離します (デフォルトで定義されたマクロのため、変更できません)。
¥n% 現行ページ番号を定義します (デフォルトで定義された数値レジスターのため、変更できません)。
¥& 0 幅の文字を指定します。コントロールを隠すのに便利です (troff コマンドの組み込み関数)。
¥(XX XX 変数で指定した特殊文字を補間します (troff コマンドの組み込み関数)。
.(b ブロックを開始します (マクロ)。
.(c センター・ブロックを開始します (マクロ)。
項目 説明
.(d 遅延テキストを開始します (マクロ)。
.(f 脚注を開始します (マクロ)。
.(l リストを開始します (マクロ)。
.(q 引用を開始します (マクロ)。
.(xIndex 指定された索引内の索引付きの項目を開始します (マクロ)。
.(z 浮動キープを開始します (マクロ)。
.)b ブロックを終了します (マクロ)。
.)c センター・ブロックを終了します (マクロ)。
.)d 遅延テキストを終了します (マクロ)。
.)f 脚注を終了します (マクロ)。
.)l リストを終了します (マクロ)。
.)q 引用を終了します (マクロ)。
.)x 索引項目を終了します (マクロ)。
.)z 浮動キープを終了します (マクロ)。
¥*String String 変数で指定した値を補間します (troff コマンドの組み込み関数)。
¥*String1String2 String1String2 変数で指定した値を補間します (troff コマンドの組み込み関数)。
¥** オプションの脚注タグ文字列を指定します。
.++mH 文書のセクションを定義するマクロ。 m 変数で指定した値で文書の各部分を定義します。 m 変数には以下の値を指定できます。
C
章を定義します。
A
付録を定義します。
P
予備情報 (概要および目次など) を定義します。
B
参考文献を定義します。
RC
各章の 1 ページから番号を付け直す章を定義します。
RA
1 ページから番号を付け直す付録を定義します。

H パラメーターは新しいヘッダーを定義します。 その中にスペースがある場合は、ヘッダー全体を引用符で囲む必要があります。 ヘッダーに章番号を入れたい場合は、文字列 ¥¥¥n(ch を使用します。例えば、付録の A.1、A.2、... に番号を付けるには、 .++ RA '''¥¥¥n(ch.%' と入力します。 各セクション (章や付録など) の前には、.+c 要求を入れる必要があります。

.+cTitle 章 (または付録。例えば .++ マクロで設定されたもの) を開始します。 Title 変数で指定した値は章のタイトルとなります (マクロ)。
¥*, かぎ形記号を指定します (文字列)。
¥ マイナス符号を指定します (troff コマンドの組み込み関数)。
¥*- 3/4 em のダッシュを指定します (文字列)。
¥0 埋め込み不可の数字幅のスペースを定義します (troff コマンドの組み込み関数)。
.1c 単一列出力に復帰します (マクロ)。
.2c 2 列出力を開始します (マクロ)。
¥*: ウムラウトを指定します (文字列)。
¥*< 添え字を開始します (文字列)。
¥*> 添え字を終了します (文字列)。
.EN 式を終了します。 式の後のスペースは eqn コマンドまたは neqn コマンドによって生成されます (マクロ)。
.EQXY 式を開始します。つまり、中断してスペースを追加します。 Y 変数で指定した値は式番号です。 オプションの X 変数の値には以下のいずれかを指定できます。
I
式を字下げします (デフォルト)。
L
式を左寄せします。
C
式を中央揃えします (マクロ)。

¥L'Distance' 指定した距離の縦線描画関数を指定します (troff コマンドの組み込み関数)。
.PE pic ピクチャーを終了します (マクロ)。
.PF フライバック付きの pic ピクチャーを終了します (マクロ)。
.PS pic ピクチャーを開始します (マクロ)。
.TE テーブルを終了します (マクロ)。
.TH テーブルのヘッダーを終了します (マクロ)。
.TS X テーブルを開始します。 X 変数の値が H の場合、 そのテーブルには繰り返し見出しがあります (マクロ)。
¥ スーパースクリプトを開始します (文字列)。
¥n(.$ オプションの数をマクロに定義します (デフォルトで定義された数値レジスターのため、 変更できません)。
¥n(.i 現在のインデントを指定します (デフォルトで定義された数値レジスターのため、変更できません)。
¥n(.l 現在行の長さを指定します (デフォルトで定義された数値レジスターのため、変更できません)。
項目 説明
¥n(.s 現在のポイント・サイズを指定します (デフォルトで定義された数値レジスターのため、 変更できません)。
¥*(4 揚音アクセントを指定します (文字列)。
¥*(` 抑音符号 (文字列)。
¥(4 揚音アクセントを指定します (troff コマンドの組み込み関数)。
¥(` 抑音符号を指定します (troff コマンドの組み込み関数)。
¥ スーパースクリプトを終了します (文字列)。
¥^ 1/12 em の狭いスペースを指定します (troff コマンドの組み込み関数)。
¥*^ 脱字記号を指定します (文字列)。
.acAuthorNumber ACM スタイル出力のセットアップを行います。 Author 変数には 1 人または複数の作成者名を指定します。 Number 変数には全ページ数を指定します。 最初の初期化前に使用する必要があります (マクロ)。
.ad テキスト調整を設定します (マクロ)。
.af フォーマットをレジスターに代入します (マクロ)。
.am マクロに追加します (マクロ)。
.ar ページ番号をアラビア数字で設定します (マクロ)。
.as 文字列に追加します (マクロ)。
.b X X 変数で指定した値をボールド体で印刷します。 X 変数を省略すると、ボールド体テキストが後に続きます (マクロ)。
.ba +Number 指定した Number 値だけベース・インデントを増加させます。 パラグラフなどの標準テキスト上のインデントを設定します (マクロ)。
.bc 新しい列を開始します (マクロ)。
.bi X 非充てんモードでのみ、X パラメーターで指定した値をボールド・イタリックで印刷します。 X パラメーターを使用しないと、 ボールド・イタリックのテキストが後に続きます (マクロ)。
¥n(bi ブロック・インデントを表示します (数値レジスター)。
.bl ページの冒頭であっても、ブランク行を要求します (マクロ)。
¥n(bm ボトム・タイトル・マージンを設定します (数値レジスター)。
.bp ページを開始します (マクロ)。
.br 中断を設定します。つまり、改行します (マクロ)。
¥n(bs ブロックの前スペーシングまたは後スペーシングを表示します (数値レジスター)。
¥n(bt キープのしきい値をブロック化します (数値レジスター)。
.bu 黒丸の付いたパラグラフを開始します (マクロ)。
.bx X 非充てんモードでのみ、X 変数で指定した値をボックス内に印刷します (マクロ)。
¥c 入力を継続します (troff コマンドの組み込み関数)。
.ce 行の中央揃えを行います (マクロ)。
¥n(ch 現在の章番号を定義します (数値レジスター)。
.de マクロを定義します (マクロ)。
¥n(df フォントを表示します (数値レジスター)。
.ds 文字列を定義します (マクロ)。
¥n(dw 現在の曜日を定義します (数値レジスター)。
¥*(dw 現在の曜日を定義します (文字列)。
¥n(dy 現在の日付を定義します (数値レジスター)。
¥e ¥ (円記号) の印刷可能バージョンを指定します (troff コマンドの組み込み関数)。
.ef'X'Y'Z' 偶数ページのフッターを XYZ 変数で指定した値に設定します (マクロ)。
.eh'X'Y'Z' 偶数ページのヘッダーを XYZ 変数で指定した値に設定します (マクロ)。
.el if/else 条件の else の部分を指定します (マクロ)。
.ep ページを終了します (マクロ)。
項目 説明
¥n(es 式の前スペースまたは後スペースを指定します (数値レジスター)。
¥fFont インライン・フォント変更を指定した Font 変数の値に設定します (troff コマンドの組み込み関数)。
¥f(Fontf インライン・フォント変更を指定した Fontf 変数の値に設定します (troff コマンドの組み込み関数)。
.fc フィールド文字を設定します (マクロ)。
¥n(ff 脚注フォントを設定します (数値レジスター)。
.fi 出力行を埋めます (マクロ)。
¥n(fi 脚注インデント (最初の行のみ) を指定します (数値レジスター)。
¥n(fm フッター・マージンを設定します (数値レジスター)。
.fo 'X'Y'Z' フッターを XYZ 変数で指定した値に設定します (マクロ)。
¥n(fp 脚注ポイント・サイズを設定します (数値レジスター)。
¥n(fs 脚注の前スペースを設定します (数値レジスター)。
¥n(fu 右マージンからの脚注インデントを設定します (数値レジスター)。
¥h'Distance' 指定した距離のローカル水平移動を設定します (troff コマンドの組み込み関数)。
.hc ハイフン付き文字を設定します (マクロ)。
.he 'X'Y'Z' ヘッダーを XYZ 変数で指定した値に設定します (マクロ)。
.hl 横線を描画します (マクロ)。
¥n(hm ヘッダー・マージンを設定します (数値レジスター)。
.hx 次ページのヘッダーおよびフッターを抑制します (マクロ)。
.hy ハイフン付きモードを設定します (マクロ)。
.i X X 変数で指定した値をイタリック体にします。 X 変数を省略すると、イタリック体テキストが後に続きます (マクロ)。
.ie if/else 条件の else の部分を指定します (マクロ)。
.if 条件を指定します (マクロ)。
¥n(ii インデント・パラグラフのインデントを設定します (数値レジスター)。
.in インデントを行います (一時的)。 全面的に行う場合は .ba マクロを使用します (マクロ)。
.ip X Y X 変数で指定したハンギング・タグを付けてインデント・パラグラフを開始します。 インデントは Y 変数で指定した en 値となります。 デフォルトは 5 です (マクロ)。
.ix インデントを行いますが、中断しません (マクロ)。
¥l'Distance' 指定した距離の横線描画関数を開始します (troff コマンドの組み込み関数)。
.lc 先行反復文字を設定します (マクロ)。
.lh ローカル文字ヘッドを補間します (マクロ)。
.ll 行の長さを設定します (マクロ)。
.lo 形式 .*x のローカル・マクロのファイルに読み込みます。初期化の前に使用する必要があります (マクロ)。
.lp 左寄せパラグラフを開始します (マクロ)。
¥*(lq 左の引用符を指定します (文字列)。
.ls 複数行スペーシングを設定します (マクロ)。
.m1 ページの先頭からヘッダーまでのスペースを設定します (マクロ)。
.m2 ヘッダーからテキストまでのスペースを設定します (マクロ)。
.m3 テキストからフッターまでのスペースを設定します (マクロ)。
.m4 フッターからページの最後までのスペースを設定します (マクロ)。
.mc マージン文字を挿入します (マクロ)。
.mk 垂直位置をマークします (マクロ)。
¥n(mo 月を定義します (数値レジスター)。
項目 説明
¥*(mo 現在の月を定義します (文字列)。
¥nX X 変数値で指定した数値レジスターを補間します (数値レジスター)。
¥n(XX XX 変数で指定した数値レジスターを補間します (数値レジスター)。
.n1 マージン内の数値行を設定します (マクロ)。
.n2 マージン内の数値行を設定します (マクロ)。
.na テキスト調整をオフにします (マクロ)。
.neNumber 指定した行数の垂直スペースを設定します (マクロ)。
.nf 出力行を未充てんのままにします (マクロ)。
.nh ハイフン付けをオフにします (マクロ)。
.np 番号付きパラグラフを開始します (マクロ)。
.nr 数値レジスターを設定します (マクロ)。
.ns 非スペース・モードを指定します (マクロ)。
¥*o スーパースクリプトの丸 (ノルウェー語の A など) を指定します (文字列)。
.of'X'Y'Z' 奇数フッターを XYZ 変数で指定した値に設定します (マクロ)。
.oh'X'Y'Z' 奇数ヘッダーを XYZ 変数で指定した値に設定します (マクロ)。
.pa ページを開始します (マクロ)。
.pd 遅延テキストを印刷します (マクロ)。
¥n(pf パラグラフ・フォントを指定します (数値レジスター)。
¥n(pi パラグラフ・インデントを指定します (数値レジスター)。
.pl ページの長さを設定します (マクロ)。
.pn 次のページ番号を設定します (マクロ)。
.po ページ・オフセットを設定します (マクロ)。
¥n(po ページ・オフセットをシミュレートします (数値レジスター)。
.pp パラグラフを開始します。最初の行を字下げします (マクロ)。
¥n(pp パラグラフのポイント・サイズを設定します (数値レジスター)。
¥n(ps パラグラフの前スペースを設定します (数値レジスター)。
.q 引用符付きを指定します (マクロ)。
¥*(qa すべてが対象です (文字列)。
¥*qe 存在します (文字列)。
¥n(qi 引用のインデントを設定します。また、行を短縮します (数値レジスター)。
¥n(qp 引用のポイント・サイズを設定します (数値レジスター)。
¥n(qs 引用の前スペースまたは後スペースを設定します (数値レジスター)。
.r Roman テキストが後に続くように設定します (マクロ)。
.rb 実ボールド・フォントを設定します (マクロ)。
.re タブをデフォルト値にリセットします (マクロ)。
.rm マクロまたは文字列を除去します (マクロ)。
.rn マクロまたは文字列の名前を変更します (マクロ)。
.ro ページ番号を Roman で設定します (マクロ)。
¥*(rq 右の引用符を指定します (文字列)。
.rr レジスターを除去します (マクロ)。
.rs レジスターを復元します (マクロ)。
項目 説明
.rt 垂直位置に戻ります (マクロ)。
¥sSize インライン・サイズを指定のサイズに変更します (troff コマンドの組み込み関数)。
.sc ファイルから特殊文字および区別的発音記号を読み取ります。 初期化の前に使用する必要があります (マクロ)。
¥n(sf セクション・タイトル・フォントを設定します (数値レジスター)。
.shLevelTitle セクション・ヘッダーが後に続くように指定します。フォントは自動的にボールドになります。 Level 変数にはセクションのレベルを指定します。 Title 変数にはセクションのタイトルを指定します (マクロ)。
¥n(si 相対ベースのセクションごとのインデントの深さを設定します (数値レジスター)。
.sk 次のページをブランクのままにします。この先は 1 ページだけ記憶されます (マクロ)。
.smX X 変数で指定した値をそれより小さいポイント・サイズで設定します (マクロ)。
.so ソース入力ファイルを指定します (マクロ)。
¥n(so 追加のセクション・タイトルのオフセットを設定します (数値レジスター)。
.sp 垂直スペースを指定します (マクロ)。
¥n(sp セクション・タイトルのポイント・サイズを指定します (数値レジスター)。
¥n(ss セクションの前スペースを指定します (数値レジスター)。
.sx セクションの深さを変更します (マクロ)。
.sz +Number 指定したポイント数だけポイント・サイズを増やします (マクロ)。
.ta タブ・ストップを設定します (マクロ)。
.tc タブ反復文字を設定します (マクロ)。
¥*(td 今日の日付を設定します (文字列)。
n(tf タイトル・フォントを指定します (数値レジスター)。
.th 論文フォーマットで用紙を作成します。初期化の前に使用する必要があります (マクロ)。
.ti 一時インデント (次の行のみ) を指定します (マクロ)。
.tl 3 部からなるタイトルを指定します (マクロ)。
¥n(tm トップ・タイトル・マージンを設定します (数値レジスター)。
.tp タイトル・ページを開始します (マクロ)。
¥n(tp タイトルのポイント・サイズを設定します (数値レジスター)。
.tr 変換します (マクロ)。
.u X troff コマンドであっても X 変数で指定した値に下線を引きます。非充てんモードのみです (マクロ)。
.uh セクション・ヘッダーが後に続くように設定します。フォントは自動的にボールドになります。 .sh マクロと同様ですが、 番号は付きません (マクロ)。
.ul 次の行に下線を引きます (マクロ)。
¥v'Distance' 指定した距離のローカル垂直移動 (troff コマンドの組み込み関数)。
¥*v チェコ語の v を e に変換します (文字列)。
¥w'String' 指定した文字列の幅を戻します (troff コマンドの組み込み関数)。
.xl ローカル行の長さを設定します (マクロ)。
.xpIndex 指定した索引を印刷します (マクロ)。
¥n(xs 索引項目の前スペースを設定します (数値レジスター)。
¥n(xu 右マージンからの索引インデントを設定します (数値レジスター)。
¥n(yr 年 (最後の 2 桁のみ) を指定します (数値レジスター)。
¥n(zs 浮動キープの前スペースまたは後スペースを設定します (数値レジスター)。
¥ 条件付きグループを開始します (troff コマンドの組み込み関数)。
¥| 1/6 em の狭いスペース (troff コマンドの組み込み関数)。
¥} 条件付きグループを終了します (troff コマンドの組み込み関数)。
¥*~ ティルドを指定します (文字列)。

P. Allman による「-ME Reference Manual」を参照してください。

mm、mmt、nroff、troff コマンド用 mm マクロ・パッケージ

mm マクロ・パッケージは、広範囲にわたる各種の文書フォーマット (例えば、 メモ、レター、レポート) のテキストをフォーマットするマクロを提供します。 文書をタイプして編集する方法は、 本質的にはその文書が後で端末またはフォトタイプセッターでフォーマットされるかどうかには関係ありません。

col コマンドは、 nroff の出力をポストプロセスするために必要になる場合があります。 特定要件については、col コマンドを参照してください。

mm マクロおよび追加情報は、以下の見出しのセクションに要約してあります。

正式メモの開始マクロ

項目 説明
.ND Date 新しい日付を設定します。
.TL [ChgNumber] [FileNumber] タイトル情報を設定します。次の行のテキストを文書のタイトルとして使用します。
.AF [CompanyName] 作成者の会社名を指定します。
.AU Name [Initials] [Loc] [Dept] [Ext] [Room] [Option...] 作成者の情報を設定します。
.AT AuthorTitle [...] 署名者の名前の後に続くタイトル (オプションは 9 つまで) を指定します。
.TM [Number] 技術メモ番号を設定します。
.AS [ 0 | 1 | 2 ] [Indent] 技術メモおよび公開された文書の場合のみ、要約を開始します。
0
表紙および最初のページの要約
1
表紙のみの要約
2
ファイルの表紙のメモのみの要約

.AE 要約を終了します。
.NS .AS 2/.AE のマクロの対に続くファイルの表紙のメモで認められている表記を開始します (マクロの終了を参照)。
.NE .AS 2/.AE のマクロの対に続くファイルの表紙のメモで認められている表記を終了します (マクロの終了を参照)。
.OK [Keyword ...] ほかのキーワードを指定します (オプションは 9 つまで)。
.MT [type] [title] 文書タイプを設定します。
”“
タイプなし
0
タイプなし (内部レター)
1
ファイルのメモ
2
プログラマーの注
3
技術者の注
4
公開された文書
5
外部レター
"String"
指定した文字列が印刷されます。

Title ページ番号が前に付けられたユーザー提供のテキスト

ビジネス・レター・マクロ

項目 説明
.WA 筆者のアドレスを開始します。
.WE 筆者のアドレスを終了します。
.LO CN [Notation] 機密メモを指定します。
.LO RN [Notation] リファレンス・メモを指定します。
.IA 内部 (受け取り人) のアドレスを開始します。
.IE 内部 (受け取り人) のアドレスを終了します。
.LO AT [Notation] 注意行を指定します。
.LO SA [Notation] あいさつを指定します。
.LO SJ [Notation] 主題行を指定します。
.LT [ { none BL SB FB SP} ] ビジネス・レターのタイプを指定します。
なし
ブロック化
BL
ブロック化
SB
セミブロック化
FB
全ブロック化
SP
簡略化

マクロの終了 (後書き情報)

項目 説明
.FC [Closing] 正式な結辞を印刷します。
.SG [Initials] [1] 署名行を印刷します。
.NS [{" "0 1 2 3 4 5 6 7 8 9 10 11 12 13 String}] 表記を開始します。
” “
 
 
コピー
0
コピー
1
コピー (アタッチメントあり)
2
コピー (アタッチメントなし)
3
アタッチメント (1 つ)
4
アタッチメント (複数)
5
同封物 (1 つ)
6
同封物 (複数)
7
独立した表紙
8
レター
9
メモ
10
コピー (複数のアタッチメントあり)
11
コピー (複数のアタッチメントなし)
12
要約のみ
13
完全なメモ
String
コピー (String)

.NE 表記を終了します。
.AV Name [1] 承認の署名を印刷します。
.CS [Pgs] [Other] [Tot] [Figs] [Tbls] [Ref] 表紙を印刷します。
.TX 目次のタイトルのユーザー出口を呼び出します。
.TY 目次のヘッダーのユーザー出口を呼び出します。
.TC [Slev] [Spacing] [Tlev] [Tab] [H1] [H2] [H3] [H4] [H5] 目次を印刷します。

パラグラフ

項目 説明
.P [ {0 1 2} ] パラグラフを開始します。
0
左寄せ (デフォルト)
1
インデント
2
インデント (.H.LE.DE の後以外)

セクション・ヘッダー

項目 説明
.H {1 2 3 4 5 6 7} [HeadingText] [FootnoteMark] 番号付きの見出しを指定します。
.HU HeadingText 番号の付かない見出しを指定します。
.HM {1 0001 A a I i}... 見出しマーク・スタイルを指定します。
1
アラビア数字
0001
先行 0 (ゼロ) が付いたアラビア数字
A
英大文字
a
英小文字
I
大文字のローマ数字
i
小文字のローマ数字

.HX [Dlev] [Rlev] [HeadingText] 見出しの前にユーザー定義の終了マクロを呼び出します。
.HY [Dlev] [Rlev] [HeadingText] 見出しの途中でユーザー定義の終了マクロを呼び出します。
.HZ [Dlev] [Rlev] [HeadingText] 見出しの後でユーザー定義の終了マクロを呼び出します。

リスト

リスト開始マクロに最終オプション [1] がある場合は、 項目間にスペースは入りません。

項目 説明
.AL [ {1 A a I i} ] [TextIndent] [1] 自動的に増分リスト (1) を開始します。
.BL [TextIndent] [1] 黒丸リストを開始します。
.DL [TextIndent] [1] ダッシュ・リストを開始します。
.ML Mark [TextIndent] [1] 各リストの項目に指定のマークでタグが付けられているリストを開始します。 TextIndent の値が NULL であるか省略されている場合は、 [Mark- width + 1] に設定されます。 3 番目の引数を指定した場合、リスト内の項目はブランク行で区切られません。
.RL [TextIndent] [1] リファレンス・リストを開始します。
.VL TextIndent [MarkIndent] [1] 可変タグ・リストを開始します。
.LI [Mark] [1] リスト項目を開始します。1 は、 Mark 変数値が現在のマークの前に付けられることを意味します。
.LE [1] リスト項目を終了します。1 は、 リストの後にブランク行を出力することを意味します。 デフォルトではブランク行はありません。
.LB TextIndent MarkIndent Pad Type [Mark] [{0 1}] [{0 1}] リストを開始します。

Type 変数の値は以下のとおりです。

 
1=. 2=) 3=() 4=[] 5=<> 6={}.

6 番目のオプション

0
各リスト項目の前にブランク行はありません。

7 番目のオプション

0
リストの前にブランク行はありません。
.LC [Level] リスト状況を Level 変数値まで消去します。

表示、テーブル、式、脚注

.DS [{0 1 2 3 }] [{0 1}] [Number]

.DS [{L I C CB}] [{N F}] [Number]
静的表示を開始します。
0 または L
インデントなし
1 または I
左からのインデント
2 または C
各行の中央揃え
3 または CB
ブロックとしての中央揃え
0 または N
表示しない
1 または F
表示
Number
Number パラメーターで指定したスペース数だけ右からインデント

.DF [{0 1 2 3 }] [{0 1}] [Number]

.DF [{L I C CB}] [{N F}] [Number]
浮動表示を開始します。
0 または L
インデントなし
1 または I
左からのインデント
2 または C
各行の中央揃え
3 または CB
ブロックとしての中央揃え
0 または N
表示しない
1 または F
表示
Number
Number パラメーターで指定したスペース数だけ右からインデント
 
.DE
表示を終了します。
.FG [Title] [Override] [0 1 2]
Override 変数の値がデフォルトの番号を置き換えるかまたは拡張します。 図のタイトルを指定します。
0
Override 値が接頭部として使用されます。
1
Override 値が接尾部となります。
2
Override 置換値が代替値となります。
 
.TS [H]
テーブルを開始します。
H
複数ページのテーブル
 
.TH [N]
オプション H から .TS までを指定するときに使用しなければなりません。
N
新規ページの冒頭以外の場合に、テーブル・ヘッダーを抑制します。
.TE
テーブルを終了します。
.TB [Title] [Override] [0 1 2]
Override 変数の値がデフォルトの番号を置き換えるかまたは拡張します。 表のタイトルを指定します。
0
Override 値が接頭部として使用されます。
1
Override 値が接尾部となります。
2
Override 置換値が代替値となります。
.EX [Title] [Override] [0 1 2]
Override 変数の値がデフォルトの番号を置き換えるかまたは拡張します。 提示タイトルを指定します。
0
Override 値が接頭部として使用されます。
1
Override 値が接尾部となります。
2
Override 置換値が代替値となります。
.EQ [Label]
指定したラベルを使用して式の表示を開始します。
.EN
式の表示を終了します。
.EC [Title] [Override] [0 1 2]
Override 変数の値がデフォルトの番号を置き換えるかまたは拡張します。 式のタイトルを指定します。
0
Override 値が接頭部として使用されます。
1
Override 値が接尾部となります。
2
Override 置換値が代替値となります。
.FS [Label]
指定したラベルをインジケーターとして使用して脚注を開始します。 デフォルトは番号付き脚注です。
.FE
脚注を終了します。
.FD [{0 1 2 3 4 ... 11}] [1]
脚注のフォーマットを設定します。

最初のオプション:

脚注テキストのフォーマット・スタイルを設定します。 mmt コマンドのデフォルトは 0 です。 mm コマンドのデフォルトは 10 です。 値については、以下の表を参照してください。

2 番目のオプション:

第 1 レベルの見出し上の脚注カウンターをリセットします。

.FD Arg. フォーマット
0
ハイフン
.nh
行末調整
.ad
テキストのインデント
はい
ラベル位置調整
1
ハイフン
.hy
行末調整
.ad
テキストのインデント
はい
ラベル位置調整
2
ハイフン
.nh
行末調整
.na
テキストのインデント
はい
ラベル位置調整
3
ハイフン
.hy
行末調整
.na
テキストのインデント
はい
ラベル位置調整
4
ハイフン
.nh
行末調整
.ad
テキストのインデント
いいえ
ラベル位置調整
5
ハイフン
.hy
行末調整
.ad
テキストのインデント
いいえ
ラベル位置調整
6
ハイフン
.nh
行末調整
.na
テキストのインデント
いいえ
ラベル位置調整
7
ハイフン
.hy
行末調整
.na
テキストのインデント
いいえ
ラベル位置調整
8
ハイフン
.nh
行末調整
.ad
テキストのインデント
はい
ラベル位置調整
9
ハイフン
.hy
行末調整
.ad
テキストのインデント
はい
ラベル位置調整
10
ハイフン
.nh
行末調整
.na
テキストのインデント
はい
ラベル位置調整
11
ハイフン
.hy
行末調整
.na
テキストのインデント
はい
ラベル位置調整

ページ・ヘッダーおよびページ・フッター

項目 説明
.PH ”'Left'Center'Right'“ ページ・ヘッダーを指定します。
.OH ”'Left'Center'Right'“ 奇数ページ・ヘッダーを指定します。
.EH ”'Left'Center'Right'“ 偶数ページ・ヘッダーを指定します。
.PF ”'Left'Center'Right'“ ページ・フッターを指定します。
.OF ”'Left'Center'Right'“ 奇数ページ・フッターを指定します。
.EF ”'Left'Center'Right'“ 偶数ページ・フッターを指定します。
.BS ボトム・ブロックを開始します。
.BE ボトム・ブロックを終了します。
.PX ページ・ヘッダーのユーザー出口を呼び出します。
.TP ページ・マクロの先頭を呼び出します。

その他のマクロ

項目 説明
.B [ Option] [Prev-Font-option] ボールドで印刷します (オプションは 6 つまで)。
.I [ Option] [Prev-Font-option] イタリックで印刷します (オプションは 6 つまで)。 nroff コマンドの場合は下線が引かれます。
.R Roman フォントに戻ります。
.PM [Option] 所有権のマーキングを設定します。 .PM マクロにオプションを指定しない場合は、 所有権のマーキングをオフにします。 /usr/lib/macros/string.mm ファイルには、 所有権のマーキングがいくつか入っています。 このファイルはユーザー要件に合わせて編集する必要があります。
.RD [ Prompt] [Diversion] [String ] コード・マクロを停止します。 Prompt 変数は、スペースの入らないユーザー定義の文字列でなくてはなりません。 Diversion 変数を指定すると、入力されたテキストを保存できます。 String 変数には、プロンプトの後に入力される最初の行が入ります。
.RP [{ 0 1 }] [{0 1 2 3}] リファレンス・ページを作成します。

最初のオプション:

0
リファレンス・カウンターをリセットします (デフォルト)。
1
リファレンス・カウンターをリセットしません。

2 番目のオプション:

0
後で .SK マクロが行われます (デフォルト)。
1
後で .SK マクロは行われません。
2
前に .SK マクロは行われません。
3
前にも後にも .SK マクロは行われません。
.RS/.RF 自動的にリファレンスに番号が付けられます。
.WC [{ N WF -WF FF -FF WD -WD FB -FB}] 2 列を使用する場合の脚注および表示の幅を制御します。
N
通常モード ( -WF-FF-WD)。
WF
脚注は常に広幅です。
-WF
脚注はページ・スタイルに従います。
FF
最初の脚注によってそのページの残りの脚注の幅が決まります。
-FF
脚注は WF または -WF オプションの設定に従います。
WD
表示は常に広幅です。
-WD
表示はページ・スタイルに従います。
FB
浮動表示によって改ページが行われます (デフォルト)。
-FB
浮動表示による改ページは行われません。
.SP [Lines] 何行か下方にスキップします。
.SK [Number] 指定したページ数だけスキップします (デフォルトは 1 です)。
.OP 奇数ページまで中断します。
.2C 出力を 2 列で印刷します。
.1C 出力を 1 列で印刷します (復元される通常の行幅)。
.SA [Option] 右マージンの位置調整を設定します。

オプション:

0
デフォルトを off に設定します (nroff コマンドのデフォルト)。
1
デフォルトを on に設定します (troff コマンドのデフォルト)。

オプションを指定しないと、マクロは現在のデフォルトに復帰します。

.SM String1 [String2] [String3 ] String3 変数値を省略した場合は String1 変数値のサイズを 1 ポイントずつ減らします。それ以外の場合は、String2 変数値のサイズを 1 ポイントずつ減らします。
.HC Character ハイフン付け文字を Character 変数値に設定します。
.S [ PointSize] [VerticalSpacing] ポイント・サイズおよび垂直スペーシングを設定します (troff コマンドのみ)。

デフォルト:

ポイント・サイズ = 10p

垂直スペーシング = 12p

オプション 1 および 2:

Number
新しい値
+/-Number
現在の値まで増分
D
デフォルト
C
現在の値
P
前の値
.VM [Top] [Bottom] 可変垂直マージンを設定します。
.nP パラグラフ上の 2 行インデントを開始します。

以下のマクロはフォントを交互に切り換えるためのもので、 どのマクロも 1 つから 6 つまでのオプションを取ります。

項目 説明
.IB イタリック (nroff の場合は下線) とボールドを交互に切り換えます。
.BI ボールドとイタリックを交互に切り換えます。
.RI Roman とイタリックを交互に切り換えます。
.IR イタリック (nroff の場合は下線) と Roman を交互に切り換えます。
.RB Roman とボールドを交互に切り換えます。
.BR ボールドと Roman を交互に切り換えます。

mm レジスター

レジスター名の後に * (アスタリスク) を付けると、そのレジスターを 2 つの方法で設定できます。 すなわち、コマンド・ラインから設定するか (mm コマンドの例を参照)、またはフォーマット・プログラムが mm マクロ定義を読む前に設定します。 以下のリストでは、括弧内に示された数値はデフォルト値です。

項目 説明
A * 事前印刷用紙の処理
Au 第 1 ページの作成者情報の禁止 (1)
C * コピー・タイプ (コピー元や草案など) (0)
Cl 目次レベル (2)
Cp 図、テーブル、式、提示の配置 (1)
D * デバッグ・フラグ (0) 1 に設定した場合、mm コマンドは、 通常は致命的であるエラーが発生した場合でも処理を継続します。
De 浮動表示の後にページ替えをします (0)。
Df 1 に設定すると、浮動表示用にレジスターをフォーマットします (5)。
Ds 静的表示の前スペースおよび後スペース (1)。
E * Subject/Date/From フィールドのフォントを制御します (0)。0 = ボールド。1 = Roman。
0
ボールド (0)
1
Roman
Ec 式カウンター
Ej 見出しのページ替えフラグ (0)
Eq 式ラベルの配置 (0)
Ex 提示カウンター
Fg 図カウンター
Fs 垂直脚注の分離 (1)
H1...H7 見出しカウンター
Hb 見出し中断レベル (.H および .HU の後) (2)
Hc .H および .HU の見出し中央揃えレベル (0)
Hi 見出し一時インデント (.H および .HU の後) (1)
Hs 見出しスペース・レベル (.H および .HU の後) (2)
Ht 見出しタイプ:
0
連結番号 (0)
1
単一番号 (0)
Hu 番号なし見出しの見出しレベル (2)
Hy ハイフン制御:
0
ハイフン付けなし (0)
1
ハイフン付けあり
L * ページの長さ (66v)
Le 目次の後の式のリスト (0):
0
印刷しません
1
印刷します
Lf 目次の後の図のリスト (0):
0
印刷しません
1
印刷します
Li リスト・インデント (troff コマンドは 5) (nroff コマンドは 6)
Ls 項目間にスペーシングが行われるまでリスト・レベルを下げます (6)。
Lt 目次の後のテーブルのリスト (0):
0
印刷しません
1
印刷します
Lx 目次の後の提示のリスト (1):
0
印刷しません
1
印刷します
項目 説明
N * 番号付けスタイル (0)
Np 番号付きパラグラフ:
0
番号なし
1
番号付き (0)
O * ページのオフセット。
Oc 目次のページ番号付けスタイル:
0
小文字のローマ数字
1
アラビア数字 (0)
Of 図表タイトル・スタイル (0)
P ページ番号。mm コマンドによって管理されます (0)。 レジスターは 0 の値または正の整数を受け入れます。
Pi パラグラフ・インデント (5)
Ps パラグラフ・スペーシング (1)
Pt パラグラフ・タイプ (0)
Pv PRIVATE ヘッダー:
0
PRIVATE を印刷しません。
1
第 1 ページのみ。
2 すべてのページ (0)
Rf リファレンス・カウンター。.RS マクロで使用します。
S * troff コマンドのデフォルトのポイント・サイズ (10)
Si 表示インデント (5)
T * nroff コマンド出力デバイスのタイプ (0)
Tb テーブル・カウンター
U * .H および .HU の下線付けスタイル (nroff コマンド) (0)
W * ページの幅 (行およびタイトルの長さ)

mm 文字列

以下のエスケープ・シーケンスを使用して特殊文字列を印刷します。

項目 説明
¥*x 単一文字の名前 (x) を持つ文字列の場合
¥*(xx 2 文字の名前 (xx) を持つ文字列の場合

文字列名

項目 説明
BU 中黒
Ci 目次内の見出しレベルのインデント
DT 現在の日付 LC_TIME カテゴリーのロケールの設定で指定されたロケール特定の日付のフォーマットが、デフォルト設定として使用されます。 これは、strftime サブルーチンの %x フォーマット指定子に対応しています。 現在日付を変更するには、 .ND マクロを使用します。
EM Em ダッシュ
F 脚注の番号付け
HF 見出しレベル・フォント文字列:
1
Roman
2
イタリック
3
ボールド (2 2 2 2 2 2 2)

HP いろいろな見出しレベルのポイント・サイズ
Le 式のリストのタイトル
Lf 図のリストのタイトル
Lt テーブルのリストのタイトル
Lx 提示のリストのタイトル
RE mm マクロの SCCS SID
Rf リファレンス番号
Rp リファレンス・ページのタイトル
Tm 商標
` 抑音符号
' 揚音アクセント
^ 脱字記号
~ ティルド
: 小文字のウムラウト
; 大文字のウムラウト
, かぎ形記号

予約名

独自の文字列、マクロ、レジスターを定義する場合は、1 つの小文字から構成される名前か、 1 つの小文字の後に小文字以外の文字を付けて構成される名前のいずれかだけを使用してください。 c2 および nP という名前は例外で、 これらの名前は予約済みです。

nroff および troff コマンド用 mptx マクロ・パッケージ

mptx マクロ・パッケージは、 ptx コマンドで作成する順列索引のフォーマットに使用する .xx マクロの定義を提供します。 mptx マクロ・パッケージは、 ヘッダーやフッターなどほかのフォーマット機能は提供しません。 そのような機能が必要な場合は、 mptx マクロ・パッケージを mm マクロ・パッケージと一緒に使用します。 この場合、次のように -mm コールの後に -mptx オプションを呼び出します。

nroff -mm -mptx File... | Printer

nroff および troff コマンド用 ms マクロ・パッケージ

nroff コマンドおよび troff コマンドのマクロ定義の ms パッケージは、 各種のスタイルの記事、論文、著書のためのフォーマット機能を提供します。 場合によっては、出力のポストプロセスを行うために col コマンドが必要になることがあります。

マクロ要求は、ms 要求のセクションで定義します。 このパッケージとともに使用すると、 予測できない結果が生じることが考えられる nroff および troff コマンド要求が多くあります。 ただし、以下のリストの最初の 4 つの要求は初期化後に使用でき、 最後の 2 つの要求は初期化前に使用できます。

項目 説明
.bp 新しいページを開始します。
.br 出力行を中断します。
.ce [Number] 指定した次の行数の中央揃えを行います。
.ls [Number] 行間隔を設定します。 Number 変数の値を、シングル・スペース・テキストの場合は 1 に、 ダブルスペース・テキストの場合は 2 に設定します。
.na 右マージンの位置合わせをオフにします。
.sp [Number] 指定した数だけスペース行を挿入します。

¥f マクロと ¥s マクロによってフォントおよびポイント・サイズを変更することもできます。 例えば ¥fIword¥fR は、word をイタリック体で印刷します。式、テーブル、リファレンスのための tbleqnrefer コマンド・プリプロセッサーの出力は、入力として受け入れられます。

距離のフォーマットは、組み込み数値レジスターによって ms マクロ内で制御できます。 例えば、以下の数値レジスターは行長を 6.5 インチに設定します。


.nr LL 6.5i

ms マクロ・レジスターについて詳しくは、 ms レジスターのセクションを参照してください。

ms 要求

外部 ms マクロ要求を以下に示します。

項目 説明
.AB [X]

要約を開始します。 X がない場合、要約にラベルは付きません。

初期値: -

中断: yes

.AE 要約を終了します。

中断: yes 初期値: -

中断: yes

.AIName 作成者の所属。

初期値: -

中断: yes

.AM アクセント・マーク定義を設定します。

初期値: -

中断: no

.AUName 作成者の名前を設定します。

初期値: -

中断: yes

.B [X] X をボールド体にします。 X がない場合、ボールド体に切り換えます。

初期値: -

中断: no

.B1 テキストのボックス化を開始します。

初期値: -

中断: yes

.B2 テキストのボックス化を終了し、それを印刷します。

初期値: -

中断: yes

.BT ページの最後にボトム・タイトルを印刷します。

初期値: date

中断: no

.BX X ワード X をボックス内に印刷します。

初期値: -

中断: no

.CM ページ間のマークをカットします。

初期値: if t

中断: no

.CT 章タイトルを指定します。ページ番号を CF (TM) に移動します。

初期値: -

中断: yes

リセット: yes

.DA [X] 日付 X を強制的にページのボトムに入れます。 X がない場合は、日付は当日となります。

初期値: if n

中断: no

.DE すべての種類の表示 (未充てんのテキスト) を終了します。

初期値: -

中断: yes

.DS X Y キープ付き表示を開始します。 X=I、L、C、B。Y= インデント。

初期値: I

中断: yes

.ID Y キープなしの表示を字下げします。Y= インデント。

初期値: 8n、.5i

中断: yes

.LD キープなしの左表示を設定します。

初期値: -

中断: yes

.CD キープなしの表示の中央揃えを行います。

初期値: -

中断: yes

.BD ブロック表示。ブロック全体の中央揃えを行います。

初期値: -

中断: yes

.EF X 偶数ページ・フッター X を設定します (troff コマンド、 .tl 要求に関しては 3 個所)。

初期値: -

中断: no

.EH X 偶数ページ・ヘッダー X を設定します (troff コマンド、 .tl 要求に関しては 3 個所)。

初期値: -

中断: no

.EN eqn コマンドで作成した式の表示を終了します。

初期値: -

中断: yes

.EQ [X] [Y] 式を取り出します。 X=L、I、C で、Y は式番号です。

初期値: -

中断: yes

.FE ページのボトムに脚注を入れるのを終了します。

初期値: -

中断: no

.FP 脚注パラグラフに番号を付けます。番号は再定義できます。

初期値: -

中断: no

FS [X] 脚注を開始します。X はオプショナルの脚注ラベルです。

初期値: -

中断: no

.HD オプションのページ・ヘッダーをヘッダー・マージンの下に設定します。

初期値: undef

中断: no

.I [X] X をイタリック体で印刷します。 X がない場合は、イタリック・フォント .ft 2 と同じです。

初期値: -

中断: no

.IP X Y ハンギング・タグ X によってパラグラフを字下げします。 Y は字下げするスペースを指定します。

初期値: -

中断: yes

リセット: yes

.IX X Y XY などのワードに 5 つまでのレベルの索引を付けます。

初期値: -

中断: yes

.KE すべての種類のキープを終了します。

初期値: -

中断: no

.KF 浮動キープを開始します。テキストの残りを充てんします。

初期値: -

中断: no

.KS キープを開始します。文書の単位を単一ページ上に一緒に保存します。

初期値: -

中断: yes

項目 説明
.LG タイプ・サイズを大きく設定します。ポイント・サイズは 2 ずつ増加します。 troff コマンドにのみ有効です。

初期値: -

中断: no

.LP 左ブロック・パラグラフを開始します。

初期値: -

中断: yes

リセット: yes

.MC X 複数の列を設定します。 X は列幅です。

初期値: -

中断: yes

リセット: yes

.ND [X] ページ・フッター内に日付がないように指定します。 X は隠す日付です。

初期値: if t

中断: no

.NH X Y 番号付きヘッダーを設定します。X= レベル。 X=0 リセット、 X=S で、Y に設定。

初期値: -

中断: yes

リセット: yes

.NL ポイント・サイズをデフォルトに戻します。 troff コマンドにのみ有効です。

初期値: 10p

中断: no

.OF X 奇数ページ・フッター X を設定します (me マクロ、.tl 要求に関しては 3 個所)。

初期値: -

中断: no

.OH X 奇数ページ・ヘッダー X を設定します (me マクロ、.tl 要求に関しては 3 個所)。

初期値: -

中断: no

.P1 最初のページにヘッダーを印刷します。

初期値: if TM

中断: no

.PP パラグラフの最初の行を字下げします。

初期値: -

中断: yes

リセット: yes

.PT ページの先頭にページ・タイトルを印刷します。

初期値: %

中断: no

.PX X 索引 (目次) を印刷します。X= タイトルを抑制しません。

初期値: -

中断: yes

.QP パラグラフを引用符で囲みます (インデントおよび短縮)。

初期値: -

中断: yes

リセット: yes

.R [X] Roman フォントに戻ります。 Roman フォントで印刷します。 X がない場合は、フォント .ft1 と同じです。

初期値: on

中断: no

.RE (相対インデントの終了レベルを) 取り去ります。 .RS 要求と一緒に使用します。

初期値: 5n

中断: yes

リセット: yes

.RP [X] 公開された文書のフォーマットでタイトル・ページを印刷します。 X がない場合は、最初のページのタイトルを停止します。

初期値: -

中断: no

.RS 1 つのインデント・レベル (相対インデントの開始レベル) で右シフトを行います。 .IP 要求と一緒に使用します。

初期値: 5n

中断: yes

リセット: yes

.SG 署名行を設定します。
.SH 番号なしセクション・ヘッダーを (ボールド体で) 設定します。

初期値: -

中断: yes

リセット: yes

.SM タイプ・サイズをより小さく設定します。ポイント・サイズは 2 ずつ減少します。 troff コマンドにのみ有効です。

初期値: -

中断: no

.TA タブを、8n、16n、... (nroff) または 5n、10n、... (troff) に設定します。

初期値: 8n5n

中断: no

.TC X 目次を最後に印刷します。X= タイトルを抑制しません。

初期値: -

中断: yes

.TE tbl コマンドによって処理したテーブルを終了します。

初期値: -

中断: yes

.TH テーブルの複数ページ・ヘッダーを終了します。 .TS H 要求と一緒に使用しなければなりません。

初期値: -

中断: yes

.TL (ボールド体で、2 ポイント大きく) タイトル行を設定します。

初期値: -

中断: yes

.TM UC バークレー論文モードを設定します。

初期値: off

中断: no

.TS X テーブルを開始します。 X が H の場合、テーブルはすべてのページにヘッダーを印刷します。

初期値: -

中断: yes

リセット: yes

.UL X troff コマンドの場合でも X に下線を引きます。

初期値: -

中断: no

.UX X UNIX を設定します。初めは商標メッセージで、X が追加されます。

初期値: -

中断: no

.XA X Y 別の索引項目を設定します。 X= ページで、何もない場合は X= なし。

初期値: -

中断: yes

.XE 索引項目または一連の .IX 要求項目を終了します。

初期値: -

中断: yes

.XP パラグラフの最初の行を字下げしません。ほかの行は字下げします。

初期値: -

中断: yes

リセット: yes

.XS X Y 索引項目を開始します。 X= ページ、何もない場合は X= なし、Y= インデント。

初期値: -

中断: yes

.1C 次のページから 1 列フォーマットを開始します。

初期値: on

中断: yes

リセット: yes

.2C 2 列フォーマットを開始します。

初期値: -

中断: yes

リセット: yes

.]- refer コマンド・リファレンスの先頭を設定します。

初期値: -

中断: no

.[0 分類不可タイプのリファレンスの終わりを設定します。

初期値: -

中断: no

.[N 新聞記事の場合、N=1。 書籍の場合、N=2。書籍の記事の場合、N=3。

初期値: -

中断: no

ms レジスター

以下に、数値レジスターおよびそれらのデフォルト値を示します。

項目 説明
PS ポイント・サイズを設定します。パラグラフに有効です。デフォルトは 10 です。
VS 垂直スペーシングを設定します。パラグラフに有効です。デフォルトは 12 です。
LL 行長を設定します。パラグラフに有効です。デフォルトは 6i です。
LT タイトルの長さを設定します。次のページから有効です。デフォルトは LL レジスターの値です。
FL 脚注の長さを設定します。次の .FS 要求から有効です。デフォルトは 5.5i です。
PD パラグラフの距離を設定します。パラグラフに有効です。デフォルトは 1v (nroff の場合) または .3v (troff の場合) です。
DD 表示距離を設定します。表示に有効です。デフォルトは 1v (nroff の場合) または .5v (troff の場合) です。
PI パラグラフ・インデントを設定します。パラグラフに有効です。デフォルトは 5n です。
QI 引用インデントを設定します。次の .QP 要求から有効です。デフォルトは 5n です。
FI 脚注インデントを設定します。次の .FS 要求から有効です。デフォルトは 2n です。
PO ページ・オフセットを設定します。次のページから有効です。デフォルトは 0 (ゼロ) (nroff の場合) または 1i (troff の場合) です。
HM ヘッダー・マージンを設定します。次のページから有効です。デフォルトは 1i です。
FM フッター・マージンを設定します。次のページから有効です。デフォルトは 1i です。
FF 脚注のフォーマットを設定します。次の .FS 要求から有効です。デフォルトは 0 (ゼロ) です (1、2、3 も使用できます)。

数値レジスターの値をリセットするときは、必ず適切な単位を指定するようにしてください。 行長はただの 7 ではなく 7i に設定しますが、 これによって 1 行に 1 文字で出力されることになります。 FF レジスターを 1 に設定すると、 脚注のスーパースクリプト付けが抑制されます。 これを 2 に設定すると、さらに最初の行のインデントが抑制されます。 FF レジスターを 3 に設定すると、 脚注のパラグラフが .IP 要求のように作成されます。

以下に、ms マクロで使用できる文字列レジスターを示します。 これらの文字列レジスターは、テキスト内の任意の場所で使用できます。

項目 説明
¥*Q 左引用符 (nroff では "troff では ' ')
¥*U 右引用符 (nroff では "troff では ' ')
¥*- ハイフン (nroff では troff では -)
¥*(MO
¥*(DY 日 (現在の日付)
¥** 脚注に自動的に番号が付けられます
¥*' 揚音アクセント (文字の前)
¥*` 抑音符号 (文字の前)
¥*^ 脱字記号 (文字の前)
¥*, かぎ形記号 (文字の前)
¥*: ウムラウト (文字の前)
¥*~ ティルド (文字の前)

.AM 要求で使用可能な拡張アクセント・マーク定義を使用するときは、 これらの文字列を、アクセントを付ける文字の前ではなく後に指定します。

注:
  1. 浮動キープおよび正規キープは同じスペースに転換されるので、これらを混合できません。
  2. 日付のフォーマットは、英語 (米国) フォーマットに制限されています。

mvt および troff コマンド用 mv マクロ・パッケージ

このパッケージは、いろいろなサイズによるビュー・グラフおよび投射式スライドのタイプセットを簡略化します。 トランスペアレンシー (OHP フォイル) を作成するのに必要なフォーマット・タスクのほとんどを行えるマクロもありますが、 trofftblpicgrap コマンドのすべての機能は、 もっと難しいタスクに向いています。

出力はほとんどの端末、特に Tektronix 4014 上でプレビューすることができます。 このデバイスの場合は -rX1 フラグを指定します (このフラグは、 mvt コマンドの呼び出しのときに -D4014 フラグが指定されていると、このコマンドによって自動的に指定されます)。 ほかの端末で出力をプレビューするには、-a フラグを指定します。

mv マクロについては、以下の見出しに要約されています。

フォイル開始マクロ

以下の 9 つのマクロでは、 名前の最初の文字 (V または S) によって、 それぞれビュー・グラフかスライドかが区別されます。 2 番目の文字はそれぞれ、フォイルが正方形 (S)、 狭い幅 (w)、低い高さ (h)、 広い幅 (W)、高い高さ (H) であることを示します。 スライドは対応するビュー・グラフよりも狭くなります。 長い寸法の短い寸法に対する比率は、ビュー・グラフよりもスライドの方が大きくなります。 結果として、スライド・フォイルをビュー・グラフに使用することはできますが、 ビュー・グラフをスライド・フォイルに使用することはできません。 一方、ビュー・グラフは少し大きなテキストに適応させることができます。

項目 説明
.VS [ FoilNumber] [FoilID] [Date ] 正方形のビュー・グラフを開始します。 フォイル・サイズは 7 インチ × 7 インチです。 フォイル開始マクロは、すべての変数 (インデントやポイント・サイズなど) を初期デフォルト値にリセットしますが、 前のフォイル開始マクロから継承された FoilID 変数および Date 変数の値はリセットしません。 .VS マクロは、.A マクロも呼び出します。
.Vw, .Vh,.VW, .VH, .Sw, .Sh, .SW, .SH .VS マクロと同じですが、 これらのマクロはビュー・グラフ (V) またはスライド (S) を開始する点が異なります。開始されるビュー・グラフまたはスライドは、狭い幅 (w)、低い高さ (h)、広い幅 (W)、高い高さ (H) です。

以下のマクロをお勧めします。

  • 正方形のビュー・グラフおよびスライドの場合には .VS
  • 35 ミリのスライドの場合には .Sw (必要に応じて .Sh)。
.Vw [ FoilNumber] [FoilID] [Date ] .VS マクロと同じですが、フォイル・サイズが縦 5 インチ×横 7 インチです。
.Vh [ FoilNumber] [FoilID] [Date ] .VS マクロと同じですが、フォイル・サイズが縦 7 インチ×横 5 インチです。
.VW [ FoilNumber] [FoilID] [Date ] .VS マクロと同じですが、フォイル・サイズが縦 5.4 インチ×横 7 インチです。
.VH [ FoilNumber] [FoilID] [Date ] .VS マクロと同じですが、フォイル・サイズが縦 9 インチ×横 7 インチです。
.Sw [ FoilNumber] [FoilID] [Date ] .VS マクロと同じですが、フォイル・サイズが縦 5 インチ×横 7 インチです。
.Sh [ FoilNumber] [FoilID] [Date ] .VS マクロと同じですが、フォイル・サイズが縦 7 インチ×横 5 インチです。
.SW [ FoilNumber] [FoilID] [Date ] .VS マクロと同じですが、フォイル・サイズが縦 5.4 インチ×横 7 インチです。
.SH [ FoilNumber] [FoilID] [Date ] .VS マクロと同じですが、フォイル・サイズが縦 9 インチ×横 7 インチです。
注: .VW フォイルと .SW フォイルは縦 7 インチ×横 9 インチを表します。 しかし、通常タイプセッター用紙は横幅が 8 インチなので、 .VW フォイルと .SW フォイルは縦 5.4 インチ×横 7 インチで印刷され、ビュー・グラフとして使用する前に 9/7 のファクターで拡大する必要があります。

レベル・マクロ

項目 説明
.A [X] 最初のインデント・レベル (左マージン) の後に続くテキストを配置します。 X 変数を指定すると、先行テキストから半行スペーシングが削除されます。
.B [Mark [Size]] 2 番目のインデント・レベルの後に続くテキストを配置します。 テキストの前には指定のマーク (デフォルトは大きな中黒) が付けられます。 Size 変数は、一般の ポイント・サイズ (デフォルトは 0) を基準にして、 そのマークのポイント・サイズに対する増分または減分を指定します。 Size 変数の値を 100 にすると、 そのマークのポイント・サイズは Mark 変数のデフォルト値と同じになります。
.C [Mark [Size]] .B マクロと同じですが、3 番目のインデント・レベルとなります。 Mark 変数のデフォルト値は em ダッシュです。
.D [Mark [Size]] .B マクロと同じですが、4 番目のインデント・レベルとなります。 Mark 変数のデフォルト値は小さい中黒です。

テキスト制御マクロ

項目 説明
.I [+/-] [Indentation] [A[X]] 現在のテキスト・インデントを変更します (タイトルには影響しません)。 寸法を指定しない限り、指定のインデントの単位はインチです。 デフォルトは 0 です。Indentation 変数を指定すると、 それは増分または減分となります。 A 変数を指定すると、.A マクロが呼び出され、 X 変数 (ある場合) がこのマクロに渡されます。
.S [Size] [Length] ポイント・サイズおよび行長を設定します。 Size 変数に指定した値はポイント・サイズです (デフォルトは前の値)。 Size 変数値が 100 の場合、 ポイント・サイズは現在のフォイル開始マクロの初期 デフォルト値に復帰します。 Size 変数を指定すると、それは増分または減分となります (デフォルトは、 .VS.VH.SH マクロの場合は 18、その他のフォイル開始マクロの場合は 14 となります)。 Length 変数には行長を指定します (寸法を指定する場合以外はインチ単位で指定する。デフォルトは .Vh マクロの場合は 4.2、.Sh マクロは 3.8、 .SH マクロは 5、その他のフォイル開始マクロは 6 インチ)。
.T String String 変数値を、中央揃えの拡大されたタイトルとして印刷します。
.U String1[String2] String1 変数値に下線を引き、 String2 変数値 (指定した場合) をそれに連結します。 この操作の使用はお勧めしません。

デフォルト設定マクロ

項目 説明
.DF [Number Name]... フォントの位置を設定します。 フォイル入力テキスト内にそれを表示できません。 つまり、フォイルの入力テキストの後で、次のフォイル開始マクロの前に指定する必要があります。 指定した番号は、Name 変数で指定したフォントの位置です。.DF マクロは、1 H などの Number Name 変数の対を 4 つまで取ります。最初の Name 変数では、一般的なフォントを指定します。 例えば、.DF 1 H 2 I 3 B 4 S のように指定します。
.DV [ A] [B] [C] [ D] インデント・レベル間の垂直スペーシングを変えます。 ABCD 変数で指定した値はそれぞれ .A.B.C.D マクロのスペーシングです。 すべての非 NULL パラメーターに寸法を指定する必要があります。 NULL パラメーターを指定しても対応するスペーシングは変わりません。 デフォルト設定値は .DV .5v .5v .5v 0v です。

.S.DF.DV.U マクロを実行しても中断はありません。 .I マクロでは、複数の変数で呼び出した場合にだけ中断が生じます。 その他のマクロではすべて中断が生じます。

mv マクロ・パッケージでは、以下に示す大文字も、 それぞれ小文字の troff コマンド要求の同義語として認識されます。

  • .AD
  • .BR
  • .CE
  • .FI
  • .HY
  • .NA
  • .NF
  • .NH
  • .NX
  • .SO
  • .SP
  • .TA
  • .TI

Tm 文字列は商標記号を生成します。

環境変数

項目 説明
LANG yes または no の問い合わせに対する y に相当するロケールの値を決めます。 使用できる肯定応答は、ロケール変数 YESSTR で定義します。 LANG を設定しない場合、または空ストリングを設定した場合には、 デフォルトの C ロケールからの YESSTR が使用されます。

nroff および troff コマンド用 nroff および troff 要求

以下の nroff および troff 要求は、 指定された作業ファイルまたは標準入力に取り込まれます。 nroff および troff 要求は、 nroff または troff コマンドでファイルまたは標準入力を処理するときにフォーマット出力の特性を制御します。 nroff および troff 要求は機能ごとに以下のセクションに分けられます。

+Number として記述される数値変数は、次のように表します。

  • Number 変数自体は絶対値です。
  • +Number 変数は現在の設定値を大きくします。
  • -Number 変数は現行値に関連する変数を小さくします。
    注: すべての数値パラメーターについて、数値は ASCII アラビア数字だけを使って表します。

このコマンドの最後に記載した注は、注の内容が当てはまる特定の要求の場合について参照してください。

数値パラメーター入力

nroff および troff 要求はいずれも、 以下の表に示す追加のスケール・インジケーターとともに数値入力を受け入れます。 ここで、S は現在のタイプ・サイズ (ポイント)、 V は現在の垂直ライン・スペーシング (基本単位)、 C は公称文字幅 (基本単位) を示します。

インジケーター 意味 基本 nroff 単位数
i インチ (troff の場合はマシン依存) 240
c センチメートル 240x50/127
P パイカ = 1/6 インチ 240/6
m Em = S ポイント C
n En = Em/2 C (Em と同じ)
p ポイント = 1/72 インチ 240/72
u 基本単位 1
v 垂直ライン・スペーシング V
k 幅半角カナ C
K 幅全角漢字 C 2 つ
なし デフォルト  
注:
  1. 非漢字出力デバイスを選択した場合、en 幅が使用されます。
  2. 非漢字出力デバイスを選択した場合、em 幅が使用されます。

nroff 要求の場合、em と en は両方とも C と等しく、 出力デバイスに依存します。よく使われる値は 1/10 と 1/12 インチです。 nroff 要求の実際の文字幅は、すべてが同じである必要はなく、- > などの事前定義文字列で構成される文字には普通以上に幅の広いものがしばしばあります。

日本語サポート: nroff コマンドからの出力ではすべての漢字や一部のカタカナなど全角の日本語文字はすべて、 C 2 つと同じ固定幅になります。 一部のカタカナなど半角の日本語文字はすべて、C 1 つと同じ固定幅になります。

水平に配置された制御文字、垂直に配置された制御文字、および要求 .nr.if.ie のスケーリングは以下のとおりです。

方向                デフォルトの        要求または機能
                    単位

Horizontal          Em (m)              .ll, .in, .ta, .lt,
                                        .po, .mc, ¥h, ¥l

Vertical            Vertical line       .pl, .wh, .ch, .dt,
                    space (v)           .sp, .sv, .ne, .rt, ¥v
                                        ¥x, ¥L

Register-oriented   Basic unit (u)      .nr, .if. .ie
or Conditional

Miscellaneous       Point (p)           .ps, .vs, ¥H, ¥s

その他の要求はすべてスケール・インジケーターを無視します。 適切にスケールされた数値を既に含む数値レジスターが数値入力を提供するように解釈される場合は、 適切でないデフォルトのスケーリングが追加されるのを防ぐためユニット・スケール・インジケーター u を付加する必要があります。 Number は小数を指定することができますが、 最終的に基本単位の整数値に丸めて保管されます。

フォントおよび文字サイズの制御

項目 説明
.bd Font Number 指定されたフォントの文字を、nroff を使用するときに指定回数重ね打ちをするか、または troff を使用するときに各文字を Number -1 基本単位だけ離して 2 回印字することによってボールドにします。Number 変数を指定しない場合は、ボールド・モードはオフとなります。 Font 値は ASCII フォント名またはフォント位置でなくてはなりません。 nroff コマンドの場合、 .bd 要求のデフォルト設定は 3 3 で、 これは位置 3 にあるフォントの文字 (通常はボールド) を 3 回重ね打ちすることを指定します (つまり、合計 4 回打つ)。

フォント名そのものをフォント位置と置き換えることができます。例えば、.bd I 3 とすることができます。Number 変数は nroff コマンドの -u フラグと機能的に同じです。(ボールド・モードは文字を物理的に印字するときに有効でなくてはなりません。) この要求は、.b 通常数値レジスターの内容に影響することがあります。

ボールド・モードは、物理的な出力時にも有効であるか、再度有効にしなければなりません。 例えば、DASI 300 などのプリンターによってローカルで制御可能な場合は、 nroff コマンドのボールド・モードをオフにできません。

初期値: Off

値を指定しない場合: -

.bd S Font Number 指定されたフォントが現在のフォントである場合に特殊フォントの文字をボールドにします。 モードは、文字を物理的に印刷するときに有効でなくてはなりません。 Font 値は ASCII フォント名またはフォント位置でなくてはなりません。 モードは、物理的な出力時にも有効であるか、再度有効にしなければなりません。

初期値: Off

値を指定しない場合: -

.cs Font Number M 一定の文字スペース (幅) モードを Font 変数値 (マウントされている場合) に設定します。 各文字の幅は Number 変数を 36 em で割ることで指定した値となります。 M 変数を指定しない場合は、em の幅は文字のポイント・サイズになります。 M 変数を指定した場合は、 幅は M 変数マイナス・ポイントで指定した値となります。 実際の幅がこのスペースよりも大きい文字を含め、 該当する文字はすべてこのスペースに中央揃えされます。 指定フォントが現在のフォントである場合の特殊フォント文字も同様に扱います。 Font 値は ASCII フォント名またはフォント位置でなくてはなりません。 Number 変数を指定しない場合は、モードはオフとなります。 モードは、文字を物理的に印刷するときに有効でなくてはなりません。 この要求は nroff コマンドによって無視されます。 関連する値は現在の環境の一部です。 モードは、物理的な出力時にも有効であるか、再度有効にしなければなりません。

初期値: Off

値を指定しない場合: -

.fp Font NumberFile ] フォントの位置を指定します。 これは指定フォントが Number 変数によって指定された位置にマウントされていることを示します。 Font 変数は 1 文字か 2 文字の ASCII フォント名でなくてはなりません。
重要: Font 変数を指定しないと、 リカバリー不能エラーとなります。

.fp 要求は 3 番目のオプションの変数 File 変数を受け入れます。これは指定フォントを含むファイルの実際のパス名です。File 変数の値は任意の有効なファイル名とすることができ、 拡張文字を入れることができます。

日本語サポート: File の値は任意の有効なファイル名とすることができます。値はタイプセッターまたはプリンターに依存します。

初期値: -

値を指定しない場合: 無視されます。

.ft Font フォント・スタイルを指定フォントに変更します。 Font の値が数値の場合は、その位置にマウントされたフォントに変更します。 または、¥fFont コマンドを埋め込みます。フォント名 P は前のフォントを意味します。 Font 変数値は ASCII フォント名またはフォント位置としなければなりません。

2 文字のフォント名を使用する場合は、代替の .ft¥f の形式で指定します。関連する値は現在の環境の一部です。 値はタイプセッターまたはプリンターに依存します。

初期値: Roman

値を指定しない場合: 前の値

.ps [+/-][Number] ポイント・サイズを +/-Number 変数で指定した値に設定します。 任意の正のサイズの値を要求することができますが、無効なサイズを指定すると、 最も近い有効なサイズが使用されます。 サイズ 0 の場合は前のサイズが使用されます。 ほかに、¥sNumber または ¥s+/-Number を使用できます。Number の値が 2 桁の場合は、¥s(Number または ¥s+/-(Number を使用します。以前のバージョンの troff コマンドとの互換性を保つため、この形式は n = 1011121416182022242836 の 2 桁の値の場合に有効です。

この要求は nroff コマンドによって無視されます。 関連する値は現在の環境の一部です。

初期値: 10 ポイント

値を指定しない場合: 前の値

.ss Number スペース文字サイズを、指定の数を 36 em で割った値に設定します。 このサイズは調整したテキストの最小ワード・スペーシングです。 この要求は nroff コマンドによって無視されます。 関連する値は現在の環境の一部です。

初期値: 12/36 em

値を指定しない場合: 無視されます。

ページ制御

項目 説明
.bp [+/-][Number] 中断ページを指定します。 現行ページは排出され、新しいページが開始されます。 +/-Number 変数を指定した場合、その値は新しいページ番号になります。 .ns 要求も参照してください。

この要求は通常、.br 要求と同様の改行を生成します。 この要求の呼び出しで制御文字 " '" を ("." の代わりに) 使用すると、この中断機能は抑制されます。

初期値: Number=1

値を指定しない場合: -

.mk Register 現在の垂直位置 (または現在の逸脱の位置) を内部レジスター (現在の逸脱レベルと関連する) または指定レジスター (指定されている場合) に保管します。 Register 変数は数値レジスターの ASCII 名です。 モードまたは関連する値は現在の逸脱レベルと関連します。 詳しくは、 .rt 要求を参照してください。

初期値: なし

値を指定しない場合: Internal

.ne Number D 指定した垂直スペースが必要なことを示します。 必要なページ・スペース (Number) が次のトラップまでの距離 (D) より大きい場合、サイズ D の前方垂直スペースが発生し、トラップが生じます。 ページに残りのトラップがない場合、D 変数で指定したサイズは、 ページの下部までの距離となります。 次のトラップまでの距離 (D) が 1 つの垂直行スペース (v) より小さい場合は、トラップが生じる前に、さらに別の行が出力されることがあります。 逸脱時には、D で指定されたサイズは、逸脱トラップまでの距離 (このトラップがある場合)、または非常に大きいサイズとなります。

D の値は通常 .t Number レジスターに保存されます。モードまたは関連する値は現在の逸脱レベルと関連します。

初期値: Number=1V

値を指定しない場合: -

.pl [+/-][Number] ページ長さを +/-Number 変数値に設定します。 内部の制約は nroff コマンドでは約 136 インチですが、 troff コマンドの場合はデバイスの種類によって異なります。 troff コマンドに適切な最大値は 75 インチです。 現在のページ長さは .p レジスターで使用可能です。

初期値: 11 インチ

値を指定しない場合: 11 インチ

.pn [+/-][Number] 次のページ (作成された場合) のページ番号が +/-Number 変数で指定されたページ番号となるように指定します。 .pn 要求は、テキストを最初に印刷する前、 または改ページが起こって最初のページのページ番号に影響を与える前に行わなくてはなりません。 現在のページ番号は % レジスターにあります。

初期値: Number=1

値を指定しない場合: 無視されます。

.po [+/-][Number] ページ・オフセットを指定します。 現在の左マージンは +/-Number 変数値に設定されます。 troff コマンドの初期値では左マージンは 1 インチとなっています。 詳しくは、行長とインデントを参照してください。現在のページ・オフセットは、.o レジスターで使用可能です。

初期値: nroff コマンドの場合 0troff コマンドの場合 1

値を指定しない場合: 前の値

.rt [+/-][Number] 現在の逸脱の指定された垂直位置に上方にだけ戻ります。 +/-Number 変数値を (現在の位置と相対的に) 指定した場合、 位置はページの上部または逸脱から +/-Number で指定した値となります。 Number 変数を指定しない場合は、 位置は前の .mk 要求によって指定されます。 モードまたは関連する値は現在の逸脱レベルと関連します。

.sp 要求は、あらゆる場合に .rt 要求の代わりに使用できます。 使用するには、例えばシーケンス .mk Register . . . .spnRu を使用する場合などに、明示レジスターに保管された絶対位置までスペーシングを行います。

初期値: なし

値を指定しない場合: Internal

テキストの充てん、アジャスト、中央揃え

項目 説明
.ad Indicator 行のアジャストを開始します。 充てんモードがオンでなければ、アジャストは充てんモードがオンになるまで据え置かれます。 Indicator 変数を指定する場合は、 アジャストのタイプは以下のリストに示すように変更されます。
インジケーター
アジャストの種類
l
左マージンのみ調整します。
r
右マージンのみ調整します。
c
中央揃え。
b または n
左右マージンを調整します。
blank
アジャストしません。

アジャスト・インジケーターは、.j レジスターから入手した数値にすることもできます。

日本語サポート:

インジケーター アジャストの種類
k 禁則処理を有効にします (.ad n.ad b.ad l で無効にする)。

通常、日本語のテキスト行は、行を開始または終了する文字に関係なくマージンまで充てんされます。 禁則処理を有効にした場合、行末に左括弧がきたり、行頭に右括弧や句読点がくることを禁止します。 行が左括弧で終わる場合は、その行は短いままで左括弧は次の行の先頭に送られます。 行が右括弧や句読点で始まる場合は、直前の行を長くし、右括弧や句読点で終わるようにします。 漢字に対応していない出力デバイスで日本語の禁則処理を指定しても無効です。

関連する値は現在の環境の一部です。

初期値: Adjust、both

値を指定しない場合: Adjust

項目 説明
.br 中断を指定します。 現在作成中の行の充てんを停止し、アジャストせずに出力します。 スペース文字で始まるテキスト行と空のテキスト行 (ブランク行) も改行されます。

初期値: -

値を指定しない場合: -

.ce [Number] 現在の行長からインデントをマイナスした範囲で指定数の次の入力テキスト行を中央揃えします。 Number 変数が 0 の場合は、残りのカウントはクリアされます。 それぞれの Number 変数入力行の後で改行されます。 入力行が長すぎる場合は左寄せされます。 関連する値は現在の環境の一部です。 この要求は通常、.br 要求と同様の改行を生成します。 この要求の呼び出しで制御文字 "'" を ("." の代わりに) 使用すると、この中断機能は抑制されます。

初期値: Off

値を指定しない場合: Number=1

.fi 以降の出力行を充てんします。 .u レジスターの値は、充てんモードでは 1、非充てんモードでは 0 となります。 関連する値は現在の環境の一部です。 この要求は通常、.br 要求と同様の改行を生成します。 この要求の呼び出しで制御文字 "'" を ("." の代わりに) 使用すると、この中断機能は抑制されます。

初期値: Fill

値を指定しない場合: -

.na 非アジャスト・モードを指定します。 アジャストは行いません。右マージンはそろいません。 .ad 要求のアジャストの種類は変わりません。 充てんモードをオンにした場合は出力行は充てんされます。 関連する値は現在の環境の一部です。

初期値: なし

値を指定しない場合: -

.nf 非充てんモードを指定します。 以降の出力行の充てんも行末調整も行いません。 入力テキスト行は現在の行長に関係なく直接出力行にコピーされます。 関連する値は現在の環境の一部です。 この要求は通常、.br 要求と同様の改行を生成します。 この要求の呼び出しで制御文字 "'" を ("." の代わりに) 使用すると、この中断機能は抑制されます。

初期値: Fill

値を指定しない場合: -

垂直スペーシング

項目 説明
Blank text line 中断し、.sp1 要求と同様にブランク行を 1 行出力します。
.ls Number 行スペーシングを +/-Number 変数で指定した値に設定します。 Number -1 Vs (ブランク行) 変数値が、各出力テキスト行に追加されます。テキストまたは前に付加したブランク行がトラップ位置に達した場合は、付加されたブランク行は省略されます。 関連する値は現在の環境の一部です。

初期値: 1

値を指定しない場合: 前の値

.ns スペースなしモードを有効にします。 このモードになると、次のページ番号のない .sp および .bp 要求は禁止されます。 スペースなしモードは、1 行の出力が行われる場合に、 または .rs 要求によって解除されます。 この要求では通常中断が発生します。

初期値: スペース

値を指定しない場合: -

.os 保存した垂直スペースを出力します。 スペースなしモードは無効になります。 前の .sv 要求によって要求された垂直スペースのブロックを出力するために使用します。

初期値: -

値を指定しない場合: -

.rs スペーシングを回復します。 スペースなしモードは無効になります。 この要求では通常中断が発生します。

初期値: なし

値を指定しない場合: -

.sp Number いずれかの方向に垂直にスペースを空けます。 Number 変数値が負の場合は後方 (上方) に移動し、 ページの上部までとなります。 前方 (下方) への移動は、最も近いトラップまでになります。 スペースなしモードが有効な場合、スペーシングは行われません。 .ns 要求と .rs 要求を参照してください。 この要求は通常、.br 要求と同様の改行を生成します。 この要求の呼び出しで制御文字 "'" を ("." の代わりに) 使用すると、この中断機能は抑制されます。

初期値: -

値を指定しない場合: 1V

.sv Number 指定サイズの連続した垂直ブロックを保存します。 次のトラップまでの距離が Number 変数値より大きい場合、 指定された垂直スペースが出力されます。 スペースなしモードは無効になります。 距離が指定された垂直スペースより小さい場合は、垂直スペースはすぐには出力されませんが、後で出力するために記憶されます (.os 要求を参照)。以降の .sv 要求は記憶されている Number 変数値を上書きします。

初期値: -

値を指定しない場合: Number=1V

.vs Number 垂直ベースライン・スペーシング・サイズ VNumber 変数に設定します。 ¥x N を使用すると、一時的な余分垂直スペースを指定できます。関連する値は現在の環境の一部です。

初期値: Number 変数は、nroff コマンドの場合 1/16 インチ、troff コマンドの場合 12 ポイントです。

値を指定しない場合: 前の値

行長とインデント

項目 説明
.in [+/-]Number インデントを +/-Number 変数値に設定します。 インデントは各出力行の前に付加されます。 関連する値は現在の環境の一部です。 この要求は通常、.br 要求と同様の改行を生成します。 この要求の呼び出しで制御文字 " '" を ("." の代わりに) 使用すると、この中断機能は抑制されます。

初期値: Number=0

値を指定しない場合: 前の値

.ll [+/-]Number 行長を +/-Number 変数の値に設定します。 troff コマンドでは行長の最大 + ページ・オフセットはデバイスに依存します。 関連する値は現在の環境の一部です。

初期値: 6.5 インチ

値を指定しない場合: 前の値

.ti [+/-]Number 一時的なインデントを指定します。 次の出力テキスト行は現在のインデントに対して +/-Number 変数で指定した値の位置に字下げされます。 Number 変数値が負の場合は、現在のインデントから後方にスペーシングし、 結果のインデントの値は 0 となりますが (現在のページ・オフセットに対して)、 現在のページ・オフセットより小さくすることはできません。 一時的なインデントは要求の後の 1 出力行にのみ適用されます。 .i レジスターに書き込まれている現在のインデントの値は変わりません。

関連する値は現在の環境の一部です。 この要求は通常、.br 要求と同様の改行を生成します。 この要求の呼び出しで制御文字 " '" を ("." の代わりに) 使用すると、この中断機能は抑制されます。

初期値: -

値を指定しない場合: 無視されます。

マクロ、文字列、逸脱、位置トラップ

項目 説明
.am Macro1 [Macro2] Macro 1 に付加します。 .de 要求のバージョンを付加します。 Macro1 変数と Macro2 変数はいずれも、 1 文字または 2 文字の ASCII 文字でなくてはなりません。 Macro2 は逸脱を終了するための終了シーケンスです。

初期値: -

値を指定しない場合: .Macro2=..

.as StringName String 指定した文字列を、StringName 変数で指定した値に追加します。 .ds 要求の追加版です。 StringName 変数値は 1 文字または 2 文字の ASCII 文字でなくてはなりません。

初期値: -

値を指定しない場合: 無視されます。

.ch Macro [Number] 指定マクロのトラップ位置を Number 変数で指定した値に変更します。 Number 変数を指定しない場合は、トラップ (ある場合) は除去されます。 Macro 変数値は 1 文字または 2 文字の ASCII 文字でなくてはなりません。

初期値: -

値を指定しない場合: -

.da [Macro] 指定したマクロに従って逸脱し、 .di 要求のバージョンを付加します。 Macro 変数は 1 文字または 2 文字の ASCII 文字でなくてはなりません。 モードまたは関連する値は現在の逸脱レベルと関連します。

初期値: -

値を指定しない場合: 現在の逸脱を終了します。

.de Macro1 [Macro2] Macro1 変数で指定した値を定義または再定義します。 マクロの内容は次の入力行から始まります。 入力行はコピー・モードで .Macro2 で始まる行で定義が停止されるまでコピーされます。 Macro2 変数がない場合、定義は ".." で始まる行で停止されます。停止するマクロが異なるか、含まれる定義ターミネーターが隠されている場合、 マクロには .de 要求を組み込むことができます。 ".." は "¥¥ ." として隠すことができます。"¥¥ ." は "¥..." としてコピーされ、再び ".." として読み取られます。Macro1 変数と Macro2 変数はそれぞれ、 1 文字または 2 文字の ASCII 文字でなくてはなりません。

初期値: -

値を指定しない場合: .Macro2=..

.di [Macro] 出力を指定マクロに逸脱します。 通常のテキスト処理は、ページ・オフセットを除き逸脱時に行われます。 .di または .da 要求が変数なしであった場合に逸脱は終了します。 このような特殊な要求は、逸脱をネストした場合は表示されません。 Macro 変数は 1 文字または 2 文字の ASCII 文字でなくてはなりません。 モードまたは関連する値は現在の逸脱レベルと関連します。

初期値: -

値を指定しない場合: End

.ds StringName String StringName 変数で指定した文字列に String 変数で指定した値が含まれるように定義します。 String の最初の二重引用符は最初に空白を入れるために削除されます。 StringName 変数は 1 文字または 2 文字の ASCII 文字でなくてはなりません。
.ds StringName ^A <SetNumber>  <MessageNumber>  [^A”<DefaultMessage> “] [^A<Argument> ^B<Argument> ^B <Argument>...] 言語に依存しない文字列定義のためにメッセージ・カタログを使用できるように、 代替の .ds 構文を提供します。

ロケール特定のカタログ内のメッセージ SetNumber および MessageNumber に基づき、 メッセージ・カタログはコピー・モードで読み取られ、対応するメッセージは StringName 変数に入れられます。 メッセージ・セットとメッセージ番号を指定する初期シーケンスは下位互換性のために省略可能です。 ASCII コード Control-A (^A) を使用して、メッセージ識別、 デフォルト・メッセージ、オプションの引数リストを区切ります。 ASCII コード Control-B (^B) を使用して、 個別のオプションの引数リストを区切ります。

次の例では、


.ds {c ^A2 41^A”ERROR: (%1$s) input line ¥
%2$s“ ^A¥n(.F^B¥n(.c

2 はメッセージ・セット番号です。

41 はメッセージ番号です。

引用符内のテキスト (". . .") はデフォルト・メッセージです。

¥n(.F は現在の入力ファイル名です。

¥n(.c は入力ファイルから読み取る行数です。

troff コマンドを以下の条件で実行する場合を考えます。

  • セット 2 および番号 41 のメッセージがデフォルト・メッセージと一致する。
  • 現在の入力ファイルは paper.doc である。
  • .ds 指示は入力ファイルの 124 行目にある。

この場合、文字列 {c は次のように定義されます。

ERROR: (paper.doc)input line 123

ほかの例を以下に示します。

.ds {c ^A2 41
/* Without optional default message */

.ds {c ^A2 41^A”ERROR: (%1$s) input file ¥
%2$s“ /* Without optional arguments */
 

セット番号とメッセージ番号をともに 0 に設定した場合は、 現在の日付が現在の地域のフォーマットで戻ります。 ユーザー定義の日付フォーマット文字列はデフォルト・メッセージ・フィールドに定義することができます。 ユーザー定義のフォーマット文字列は、strftime 関数 Technical Reference: Base Operating System and Extensions のセクションに概要が記載されている変換の仕様に適合していなくてはなりません。

次の例を示します。


.ds DT^A0 0

この例では、現在日付が English U.S ロケールで July 10, 1991 の場合、 DT7/10/91 と定義されます。

.ds DT^A0 0^A”Today is %B %d, %Y“

現在日付が English U.S ロケールで July 10, 1991 の場合、 DTToday is July 10, 1991 と定義されます。

2 番目の構文メソッドは一般的に使用するためのものではありません。 内部で生成されるメッセージの国際化対応を容易にするためシステムに付属の nroff および troff マクロ・ファイルに使用します。

初期値: -

値を指定しない場合: 無視されます。

.dt Number Macro 指定マクロを開始するために、現在の逸脱の Number 変数で指定された位置に逸脱トラップをインストールします。 ほかの .dt 要求は逸脱トラップを定義し直します。 変数を指定しない場合は、逸脱トラップは除去されます。 Macro 変数は 1 文字または 2 文字の ASCII 文字でなくてはなりません。 モードまたは関連する値は現在の逸脱レベルと関連します。

初期値: -

値を指定しない場合: Off

.em Macro すべての入力が終了したときに指定マクロを呼び出します。 最後に処理したファイルの終わりに指定マクロの内容がある場合と同じように実行されます。 指定マクロは 1 文字または 2 文字の ASCII 文字でなくてはなりません。

初期値: なし

値を指定しない場合: なし

.it Number Macro Number 変数で指定したテキスト入力行数を読み取った後に (制御行または要求行は数えません) 指定マクロを呼び出すように入力行カウント・トラップを設定します。 テキストは、インライン・テキスト、あるいは明示的 (インライン・コールによる) または暗示的 (トラップによる) に呼び出したマクロによって提供されるテキストとすることができます。 Macro 変数は 1 文字または 2 文字の ASCII 文字でなくてはなりません。 関連する値は現在の環境の一部です。

初期値: -

値を指定しない場合: Off

.rm Name 指定した要求、マクロ、文字列を除去します。 Name 変数値が名前リストから除去され、関連する記憶スペースが解放されます。 以降のリファレンスは無効になります。 Name 変数は 1 文字または 2 文字の ASCII 文字でなくてはなりません。

初期値: -

値を指定しない場合: 無視されます。

.rn Name1 Name2 Name1 変数で指定した要求、マクロ、文字列を、Name2 変数で指定した値に変更します。 Name1 および Name2 変数値は 1 文字または 2 文字の ASCII 文字でなくてはなりません。

初期値: 無視されます。

値を指定しない場合: -

.wh Number Macro Number 変数で指定したページ位置に指定マクロを呼び出すためにトラップをインストールします。 Number 変数に負の値を指定した場合は、ページの最後の行から数えるものと解釈します。 Number 変数で指定したページ位置に以前に埋め込んだマクロは、Macro 変数値に置換されます。 Number 変数が 0 の場合は、ページの上部を示します。 Macro 変数を指定しない場合は、Number 変数で指定されたページ位置にある最初のトラップが除去されます (ある場合)。 Macro 変数は 1 文字または 2 文字の ASCII 文字でなくてはなりません。

初期値: -

値を指定しない場合: -

数値レジスター

項目 説明
.af Register Indicator Indicator 変数で指定したフォーマットを指定レジスターに割り当てます。 Register 変数は 1 文字または 2 文字の ASCII 文字でなくてはなりません。 使用可能なフォーマット Indicator 変数値は以下のとおりです。
インジケーター
番号の順序
1
0,1,2,3,4,5, . . .
001
000,001,002,003,004,005, . . .
i
0,i,ii,iii,iv,v, . . .
I
0,I,II,III,IV,V, . . .
a
0,a,b,c, . . . ,z,aa,ab, . . . ,zz,aaa, . . .
A
0,A,B,C, . . . ,Z,AA,AB, . . . ,ZZ,AAA, . . .

N 桁のアラビア形式インジケーター (例えば 000000001) は、N 桁のフィールド幅を意味します。 読み取り専用レジスターと幅機能は常にアラビア数値を扱います。

日本語サポート: 次の値は日本語の漢数字出力のフォーマットのための文字幅を指定します。

k
数字は漢数字としてフォーマットされます。 非漢字コード・セットを指定している場合にこれを要求すると、警告メッセージが出力され、 1 フォーマットが使用されます。

初期値: Arabic

値を指定しない場合: -

.nr Register +/-Number1 Number2 以前の値 (ある場合) に対して、+/-Number 変数で指定した値を指定レジスターに割り当てます。 自動増分の増分値は Number2 変数値に設定されます。 Register 変数は 1 文字または 2 文字の ASCII 文字でなくてはなりません。

初期値: -

値を指定しない場合: -

.rr Register 指定レジスターを除去します。 多数のレジスターを動的に作成する場合、新しいレジスターのための内部記憶スペースを再度確保するために必要のないレジスターを除去することが必要になる場合があります。 Register 変数は 1 文字または 2 文字の ASCII 文字でなくてはなりません。

初期値: -

値を指定しない場合: -

タブ、リーダー、フィールド

項目 説明
.fc Delimiter Indicator フィールド区切り文字を指定区切り文字に設定します。 埋め込みインジケーターはスペース文字または指定インジケーターに設定されます。 変数を設定しない場合は、フィールドの機能はオフになります。 Delimiter 変数値と Indicator 変数値は ASCII 文字でなくてはなりません。

初期値: Off

値を指定しない場合: Off

.lc Character リーダー繰り返し文字を指定文字に設定するか、指定を取り消します。 Character 変数値は 1 文字の ASCII 文字でなくてはなりません。 関連する値は現在の環境の一部です。

初期値: .

値を指定しない場合: なし

.ta Stop [Type]... タブ・ストップを設定します。デフォルトのタブ・ストップは、nroff コマンドの場合 8 文字おきに、 troff コマンドの場合 1/2 インチおきに設定されます。 スペースで区切ると、複数の StopType の対を指定できます。+ (正符号) が前に付いた値は前のストップ値に対する増分として扱われます。

指定するタブの種類は、タブ・ストップでテキストをどのようにアジャストするかを決定します。 Type 変数値は以下のとおりです。

Type
調整
R
右寄せ
C
中央揃え
blank
左寄せ

関連する値は現在の環境の一部です。

初期値: nroff コマンドの場合 8 en、troff コマンドの場合 0.5 インチ

値を指定しない場合: なし

.tc Character タブ繰り返し文字を指定文字に設定するか、指定を取り消します。 Character 変数値は 1 文字の ASCII 文字でなくてはなりません。 関連する値は現在の環境の一部です。

初期値: なし

値を指定しない場合: なし

入出力規則および文字変換

項目 説明
.cc Character 基本的な制御文字を指定文字に設定するか、"." にリセットします。Character 変数値は 1 文字の ASCII 文字でなくてはなりません。 関連する値は現在の環境の一部です。

初期値: .

値を指定しない場合: .

.cu [Number] .ul 要求の応用で、各文字に下線を引き、 影響を受ける入力行で行の中断が起こらないようにします。 つまり、.cu 要求に続く各出力スペースは、 埋め込みができないスペースと似ています。 .cu 要求は troff コマンドの .ul 要求と同じです。 関連する値は現在の環境の一部です。

初期値: Off

値を指定しない場合: Number=1

.c2 Character 改行なし制御文字を指定文字に設定するか、"'" にリセットします。Character 変数値は 1 文字の ASCII 文字でなくてはなりません。 関連する値は現在の環境の一部です。

初期値: '

値を指定しない場合: '

.ec Character エスケープ文字を ¥ (円記号) か、 または Character 変数で指定した値 (ある場合) に設定します。 Character 変数値は 1 文字の ASCII 文字でなくてはなりません。

初期値: ¥

値を指定しない場合: ¥

.eo エスケープ機能をオフにします。

初期値: On

値を指定しない場合: -

.lg [Number] Number 変数値が指定されていないか、0 でない場合、 連字 (ligature) モードを有効にします。 Number 変数値が 0 の場合は、連字モードが無効になります。 Number 変数値が 2 の場合は、2 文字の連字だけが自動的に呼び出されます。 要求、マクロ、文字列、レジスター、ファイル名の場合と、コピー・モードの場合、連字モードは禁止されます。 この要求は nroff コマンドでは無効です。

初期値: On (troff コマンドの場合)

値を指定しない場合: On

.tr Character1 Character2 Character3 Character4 特に Character1 変数で指定した文字値を Character2 変数値に、Character3 変数で指定した文字値を Character4 変数値に変換します。 奇数の文字数を指定する場合は、最後の文字がスペース文字にマップされます。 整合性を保つため、特定の変換が入力時から出力時まで有効でなくてはなりません。 指定する文字はすべて ASCII 文字でなくてはなりません。 .tr 要求を設定し直すには、この要求の後に前の変数を指定します。

例えば、次の.tr 要求は、


.tr aAbBc<C,> 

次のように入力してリセットすることができます。

.tr aabbcc

これは論理出力まで有効でなくてはなりません。

初期値: なし

値を指定しない場合: -

.ul [Number] nroff コマンドの場合、Number 変数で指定した数の入力テキスト行に下線を引きます (troff コマンドの場合はイタリック体にします)。実際には下線付きのフォントに切り替え、現在のフォントを後で復元するために保存します。 .ul 要求が有効なとき、ほかのフォントの変更が有効になりますが、 復元可能なのは最後の変更だけです。 .tl 要求で生成した出力はフォント変更による影響を受けますが、 Number 変数値は減分されません。 詳しくは、3 部からなるタイトルを参照してください。指定した値が 1 より大きい場合、トラップ・コール・マクロがそのスパン内にテキスト行を提供するリスクがあります。 環境切り替えによりこれを防止することができます。

関連する値は現在の環境の一部です。

初期値: Off

値を指定しない場合: Number=1

.uf Font フォント・セットに Font 変数で指定した値まで下線を引きます。 nroff コマンドの場合、 Font 変数は 1 の位置 (初期には Times Roman) とすることはできません。 Font 変数は ASCII フォント名でなくてはなりません。

初期値: Italic

値を指定しない場合: Italic

ハイフン処理

項目 説明
.hc Character ハイフン処理インジケーター文字を、Character 変数で指定した値か、 デフォルトに設定します。 インジケーターは出力には表示されません。 Character 変数値は 1 文字の ASCII 文字でなくてはなりません。 関連する値は現在の環境の一部です。

初期値: ¥%

値を指定しない場合: ¥%

.hw Word1... 負符号を埋め込むことによって、ワードの中のハイフンを付けるポイントを指定します。 最後に s が付くワードも含めるものとします。 つまり、dig-itdig-its も含みます。 このリストは最初と各接尾部の削除後に検査されます。 使用可能なスペースは 1024 文字で、約 50 から 100 ワードになります。

初期値:

値を指定しない場合: 無視されます。

.hy Number 指定した値が 1 に等しいかそれより大きい場合、自動ハイフン処理を有効にします。 指定した値が 0 に等しい (.nh 要求に等しい) 場合、自動ハイフン処理を無効にします。 指定した値が 2 の場合は、最後の行は (トラップを発生させる行) ハイフン処理が行われません。 指定した値が 4 または 8 の場合は、それぞれワードの最後または最初の 2 文字は分割されません。 これらの値は、加算されます。例えば値が 14 の場合、3 つの制約すべて (2 と等しい数、4 と等しい数、8 と等しい数) を呼び出します。

関連する値は現在の環境の一部です。

初期値: ハイフン処理を行わない。

値を指定しない場合: ハイフン処理を行う。

.nh 自動ハイフン処理を行いません。 関連する値は現在の環境の一部です。

初期値: ハイフン処理を行わない。

値を指定しない場合: -

3 部からなるタイトル

項目 説明
.lt [+/-][Number] +/-Number 変数で指定したタイトル値の長さを設定します。 行長とタイトル長さは独立しています。 インデントはタイトルには適用されませんが、ページ・オフセットは適用されます。 関連する値は現在の環境の一部です。

初期値: 6.5 インチ

値を指定しない場合: 前の値

.pc Character ページ番号文字を指定文字に設定するか、除去します。 ページ番号レジスターは % のままです。 Character 変数値は 1 文字の ASCII 文字でなくてはなりません。

初期値: %

値を指定しない場合: Off

.tl 'Left'Center'Right' LeftCenterRight 変数によって指定された文字列を現在のタイトル長さでそれぞれ左寄せ、中央揃え、右寄せします。 文字列は空でもよく、重ねることができます。 ページ番号文字 (初期値は %) がいずれかのフィールドにある場合は、 % レジスターに割り当てられたフォーマットを持つ現在のページ番号と置き換えられます。 文字列に表示されない ASCII 文字は文字列区切り文字として使用することができます。

初期値: -

値を指定しない場合: -

出力行番号付け

項目 説明
.nm [+/-] [Number] [M] [S] [I] 行番号モードを有効にします。 M 変数を指定した場合、M 変数値の倍数である行番号だけが印刷されます。 M 変数値を指定しない場合、各行番号が出力されます (デフォルトは M=1)。 行番号モードが有効な場合、3 桁のアラビア数字とスペース 1 個が出力テキスト行の前に付加されます。 したがって、テキスト行は 4 桁のスペースで相対位置設定されますが、行長は保持されます。 S 変数を指定すると、行番号とテキストの間に表示するスペースの桁数が指定されます (デフォルトは S=1)。 I 変数を指定すると、行番号の前に字下げするスペース数が指定されます (デフォルトは I=0)。

関連する値は現在の環境の一部です。

初期値: -

値を指定しない場合: Off

.nn Number 行番号付けを中止します。 指定された行番号は番号付けされません。 関連する値は現在の環境の一部です。

初期値: -

値を指定しない場合: Number=1

入力の条件付き受け入れ

Condition 変数は以下の 1 文字の名前のいずれかを指定します。

項目 説明
o 現在のページ番号が奇数の場合
e 現在のページ番号が偶数の場合
t フォーマッターが troff コマンドの場合
n フォーマッターが nroff コマンドの場合
.if Condition Anything Condition 変数で指定した値が真の場合は、Anything 変数で指定した値を入力として受け入れます。複数行の場合は ¥{Anything¥} を使用します。
.if !Condition Anything Condition 変数で指定した値が偽の場合は、Anything 変数で指定した値を入力として受け入れます。
.if Number Anything Number 変数で指定した値が 0 より大きいことを表現に指定した場合、Anything 変数で指定した値を入力として受け入れます。
.if !Number Anything Number 変数で指定した値が 0 より小さいか等しいことを表現に指定した場合、Anything 変数で指定した値を入力として受け入れます。
.if 'String1'String2' Anything String1 変数値が String2 変数値と同じである場合、Anything 変数で指定した値を入力として受け入れます。 String1 変数と String2 変数に指定されていない非ブランクの ASCII 文字は区切り文字として使用することができます。
.if !'String1'String2' Anything String1 変数値が String2 変数値と同じでない場合、Anything 変数で指定した値を入力として受け入れます。 String1 変数と String2 変数に指定されていない非ブランクの ASCII 文字は区切り文字として使用することができます。
.el Anything if/else 条件の else の部分を指定します。
.ie Condition Anything Condition 変数の値に応じて、if/else 条件の if の部分を指定します。前の形式の .if 要求とともに使用することができます。

環境の切り替え

項目 説明
.ev Environment 指定環境に切り替えます。 Environment 変数で指定した値は 0、1、2 でなくてはなりません。 切り替えはプッシュダウン方式で行い、前の環境を回復する場合は、特定の参照によるのではなく .ev 要求を使って行います。

初期値: Environment=0

値を指定しない場合: 前の値

標準入力からの挿入

項目 説明
.ex nroff コマンドまたは troff コマンドを終了します。 テキスト処理はすべての入力が終了したときと同じように停止します。

初期値: -

値を指定しない場合: -

.rd Prompt 1 行に 2 つの改行文字が見つかるまで標準入力からの挿入を読み取ります。 標準入力がユーザーのキーボードの場合、指定プロンプト (または ASCII BEL 文字) がユーザーの端末に書き出されます。 .rd 要求はマクロと同じように働き、追加の変数を Prompt 変数の後に指定することができます。

初期値: -

値を指定しない場合: Prompt=ASCII BEL 文字

入出力ファイルの切り替え

項目 説明
.cf File 指定ファイルの内容をそのまま troff コマンド出力ファイルにこの時点で書き込みます。 ファイルの動作によって現在の水平および垂直位置を回復しない限り問題が発生します。

初期値: -

値を指定しない場合: -

.lf Number File 現在行番号 (Number 変数で指定した番号) と現在のファイル (File 変数で指定したファイル) の troff コマンドの解釈を、エラー・メッセージで使用できるように訂正します。

初期値: -

値を指定しない場合: -

.nx File 指定ファイルを入力ファイルとして使用します。 現在のファイルは終了したものと見なし、入力は直ちに指定ファイルに切り替えます。

初期値: -

値を指定しない場合: ファイルの終わり

.pi Program 出力を指定プログラムに送ります。 この要求は印刷が行われる前に発行しなければなりません。 変数は指定プログラムに送られません。

初期値: -

値を指定しない場合: -

.so File ソース・ファイルを切り替えます。 一番上の入力 (ファイル読み取り) レベルは指定ファイルに切り替わります。 このファイルが終了すると、入力は再び元のファイルからとなります。 .so 要求はネストすることができます。

.so 要求があった場合、指定ファイルの処理は直ちに実行されます。 元のファイルの処理 (例えば、有効なマクロなど) は中止されます。

ファイルは、.so 要求によって呼び出される前に必要に応じて処理しなければなりません。 eqntblpicgrap コマンドは、.so 要求によってオブジェクト・ファイルを処理するために使用されません。

初期値: -

値を指定しない場合: -

その他

項目 説明
.ab Text Text 変数で指定した値を診断出力 (通常は端末) に出力し、処理を中止して終了します。 テキストがない場合は、メッセージ User Abort が出力され、出力バッファーがフラッシュされます。この要求は対話型デバッグで出力を強制するために使用します。
.ab ^A<SetNumber> <MessageNumber>  [^A”<Default> “]  [^A<Argument> ^B<Argument> ^B<Argument>...] 言語に依存しない異常終了メッセージのためメッセージ・カタログを使用することができるように代替構文を提供します。 診断出力 (通常は端末) にパラメーターで指定された適切なメッセージを出力し、それ以上の処理を実行せずに終了します。 パラメーターがない場合、次のようなメッセージ・カタログが出力されます。
troff: User Abort, line no. file filename

出力バッファーはフラッシュします。 この要求は対話型デバッグで出力を強制するために使用します。

ロケール特定のカタログ内のメッセージ SetNumber 変数および MessageNumber 変数に基づいて、 メッセージ・カタログがコピー・モードで読み取られ、 対応するメッセージがユーザーの端末に書き出されます。 メッセージ・セットとメッセージ番号を指定する初期シーケンスは下位互換性のために省略可能です。 ASCII コード Control-A (^A) を使用して、メッセージ識別、 デフォルト・メッセージ、オプションの引数リストを区切ります。 ASCII コード Control-B (^B) を使用して、 個別のオプションの引数リストを区切ります。

次の例では、

.ab ^A2 42^A”Processing has been terminated ¥
 at line %1$s.“^A¥n(c.

2 はメッセージ・セット番号です。

42 はメッセージ番号です。

引用符内のテキスト "..." はデフォルト・メッセージです。

¥n(c. は、入力ファイルから読み取る行数です。

troff コマンドを次の条件で実行する場合を考えてみます。

  • セット 2 および番号 42 のメッセージがデフォルト・メッセージと一致する。
  • .ab 指示は入力ファイルの 124 行目にある。

次のメッセージがユーザーの端末に表示されます。

Processing has been terminated at line 123.

初期値: -

値を指定しない場合: ユーザー・キャンセル

.Dt Parameter nroff または troff 要求内で日付を戻すためのフォーマットを定義します。 デフォルトでは、オプションの Parameter を指定しないと、 LC_TIME カテゴリーの現在のロケール設定によって指定されたロケール特定の日付のフォーマットが使用されます。 これは strftime"%x" フォーマット指定子に対応しています。Parameter は、strftime 関数 Technical Reference: Base Operating System and Extensions で使用されるフォーマット文字列と同じフォーマット文字列です。 フォーマット指定子の完全なリストについては、この関数を参照してください。

例えば、次の例では、

.Dt ”%A, %B %d, %Y (%T)“

英語圏のロケールに次の出力が提供されます。

Thursday, January 31, 1991 (10:40:00)

%A フォーマットはロケール特定の曜日名と置き換えられます。 %B フォーマットはロケール特定の月名と置き換えられます。 %d フォーマットは 2 桁フォーマットの (月のうちの) 日と置き換えられます。 %Y フォーマットは 10 進数の西暦年と置き換えられます。 %T フォーマットは 10 進数の時間 (24 時間制)、分、秒と置き換えられます。 このフォーマットは、うるう秒と二重うるう秒に対応します。

.fl 出力バッファーをフラッシュします。 この要求は通常、.br 要求と同様の改行を生成します。 この要求の呼び出しで制御文字 " '" を ("." の代わりに) 使用すると、この中断機能は抑制されます。

初期値: -

値を指定しない場合: -

.ig Macro 入力行を無視します。 .ig 要求は .de 要求と同じように働きますが、入力は破棄されます。 詳しくは、マクロ、文字列、逸脱、位置トラップを参照してください。入力はコピー・モードで読み取られ、自動的に増分されるレジスターは影響を受けます。 Macro 変数は 1 文字または 2 文字の ASCII 文字でなくてはなりません。

初期値: -

値を指定しない場合: .Macro=..

.mc [Character] [N] 指定文字を、空白でない各テキスト行 (.tl 要求で作成したものを除く) の後のマージンの右に指定距離 (N) の位置に表示するマージン文字として使用します。出力行が長すぎる場合は (非充てんモードで発生することがある)、文字が行に付加されます。 N 変数を指定しない場合は前の N 変数を使用します。 最初の N 変数は、nroff コマンドの場合 0.2 インチで、 troff コマンドの場合 1 em です。

関連する値は現在の環境の一部です。

初期値: nroff の場合 2 インチ、troff の場合 1 em

値を指定しない場合: Off

.pm [Character] マクロを出力します。 すべての定義済みマクロおよび文字列の名前とサイズはユーザーの端末に出力されます。 ASCII 英数字を変数として指定した場合、サイズの合計だけが出力されます。 サイズは 128 文字の単位で指定します。

初期値: -

値を指定しない場合: すべて

.sy Command [Flags] 指定したコマンドは実行されますが、その出力はこの時点ではキャプチャーされません。 指定コマンドの標準入力はクローズされます。 出力は後で処理するため出力ファイルに明示的に保存しなければなりません。 多くの場合、.sy 指示の後には、直前のコマンドの結果を組み込むために .so 指示が続きます。

次に例を示します。

.sy date > /tmp/today
Today is
.so /tmp/today

初期値: -

値を指定しない場合: -

.tm String 指定した文字列がユーザー端末に出力されます。
.tm ^A<SetNumber> <MessageNumber>  [^A”<DefaultMessage> “]  [^A<Argument> ^B <Argument> ^B<Argument> ...] ロケール特定のカタログ内のメッセージ・セット番号およびメッセージ番号に基づいて、 メッセージ・カタログがコピー・モードで読み取られ、対応するメッセージがユーザーの端末に書き出されます。 メッセージ・セットとメッセージ番号を指定する初期シーケンスは下位互換性のために省略可能です。 ASCII コード Control-A ^A を使用して、メッセージ識別、 デフォルト・メッセージ、オプションの引数リストを区切ります。 ASCII コード Control-B ^B は、個々のオプションの引数リストを区切ります。

次の例では、

.tm ^A2 23^A”The typesetter is %1$s.On line 
%2$s.“^A¥*(.T^B¥n(c.

2 はメッセージ・セット番号です。

23 はメッセージ番号です。

引用符内のテキスト "..." はデフォルト・メッセージです。

¥*(.T は、-T の値に対する troff の最初の引数です。

¥n(c. は、入力ファイルから読み取る行数です。

troff コマンドを次の条件で実行する場合を考えてみます。

  • セット 2 および番号 23 のメッセージがデフォルト・メッセージと一致する。
  • コマンド・ラインに、デバイス PSC-T オプションを使用した troff を指定する。
  • .tm 指示は入力ファイルの 539 行目にある。

次のメッセージがユーザーの端末に表示されます。

The typesetter is psc. On line 538.

ロケール特定のメッセージ・カタログは /usr/lib/nls/msg/$LANG/macros.cat にあります。

初期値: -

値を指定しない場合: 改行

注:

以下の注は nroff 要求と troff 要求に該当します。 該当する要求内で番号で参照します。

  1. .L 文字列レジスターにはすべてのカテゴリーの現在のプログラム・ロケール値が入っています。
  2. .m 文字列レジスターには LC_MESSAGES カテゴリーのロケール値が入っています。
  3. .t 文字列レジスターには LC_TIME カテゴリーのロケール値が入っています。
  4. .L.t.m 文字列レジスターは特定の環境値にアクセスできますが、その他の環境変数にアクセスする場合さらに一般的な方法を使用することができます。 例えば TED 環境変数をエクスポートする場合、次の troff コマンドは、
    .sy echo .ds z $TED >x
    .so x
    .sy rm x

z 文字列レジスターに $TED の値が入るように設定します。

環境変数

項目 説明
LC_ALL すべてのロケール・カテゴリーに使用するロケールを指定します。 ほかのロケール環境変数の設定はオーバーライドされます。
LC_MESSAGES LC_MESSAGES カテゴリーのロケール値を指定します。 これは、LC_ALL 環境変数が設定されていない場合に使用します。
LC_TIME LC_TIME カテゴリーのロケール値を指定します。 これは、LC_ALL 環境変数が設定されていない場合に使用します。
LANG すべてのロケール・カテゴリーに使用するロケール値を指定します。 これは上記の環境変数のいずれも設定されていない場合に使用します。 この環境変数はロケールを指定するために最もよく使われます。

ファイル

項目 説明
/usr/share/lib/tmac/tmac.* 標準マクロ・ファイルを指すポインターが入っています。
/usr/share/lib/macros/* 標準マクロ・ファイルを示します。
/usr/share/lib/tmac/tmac.an man マクロ・パッケージを指すポインターが入っています。
/usr/share/lib/macros/an man マクロ・パッケージが入っています。
/usr/share/lib/tmac/tmac.e ファイル me マクロ定義ファイルが入っています。
/usr/share/lib/me ディレクトリー マクロ定義ファイルが入っています。
/usr/share/lib/tmac/tmac.m mm マクロ・パッケージを指すポインターが入っています。
/usr/share/lib/macros/mmn mm マクロ・パッケージが入っています。
/usr/share/lib/macros/mmt mm マクロ・パッケージが入っています。
/usr/share/lib/tmac/tmac.ptx マクロ・パッケージを指します。
/usr/share/lib/macros/ptx マクロ・パッケージが入っています。
/usr/share/lib/tmac/tmac.x マクロ定義ファイルが入っています。
/usr/share/lib/ms ms マクロ定義が入っています。
/usr/share/lib/tmac/tmac.v マクロ定義が入っています。
/usr/share/lib/macros/vmca マクロ定義が入っています。
/usr/lib/nls/msg/$LANG/macros.cat mmmemsmv マクロ・パッケージのロケール特定のメッセージ・カタログが入っています。
/usr/lib/font/dev*/* フォント幅テーブルが入っています。
/var/tmp/trtmp* 一時ファイルを示します。