'\" te
.\" Copyright (c) 2009, 2011, Oracle and/or its affiliates. All rights reserved.
.TH troff 1 "2011 年 8 月 17 日" "SunOS 5.11" "ユーザーコマンド"
.SH 名前
troff \- ドキュメントのタイプセットと清書
.SH 形式
.LP
.nf
\fBtroff\fR [\fB-a\fR] [\fB-f\fR] [\fB-F\fR\fIdir\fR] [\fB-i\fR] [\fB-m\fR\fIname\fR] [\fB-n\fR\fIN\fR] [\fB-o\fR\fIlist\fR] [\fB-r\fR\fIaN\fR] 
     [\fB-s\fR\fIN\fR] [\fB-u\fR\fIN\fR] [\fB-z\fR] [\fIfilename\fR]...
.fi

.SH 機能説明
.sp
.LP
\fBtroff\fR は、 \fIfilename\fR 引数で指定されたファイル群中のテキストを、 タイプセット用またはレーザープリンタでの印刷用に 清書します。\fBtroff\fR への入力ファイルの中身は、 清書用の要求とマクロを含んだテキストです。\fIfilename\fR 引数が省略された場合、 \fBtroff\fR は標準入力から読み込みます。複数のファイル名も指定可能で、そのうちの 1 つとして標準入力を指定したければ、該当する位置にハイフン (–) を記述します。\fI\fR
.SH オプション
.sp
.LP
以下のオプションがサポートされています。任意の順序で指定できますが、 すべてのオプションは先頭の \fIfilename\fR より前に指定してください。
.sp
.ne 2
.mk
.na
\fB\fB-a\fR\fR
.ad
.RS 11n
.rt  
\fBASCII\fR の近似形式で清書した出力を標準出力に書き出します。(注: 最近はほとんど使用されない \fB/usr/bin/ta\fR コマンドを使うと、\fBASCII\fR の未完版も通常端末上に出力されます。)
.RE

.sp
.ne 2
.mk
.na
\fB\fB-f\fR\fR
.ad
.RS 11n
.rt  
最終ページを出力したあと、トレーラページを印刷しないか、 またはポストプロセッサが装置の制御権を放棄しないようにします。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-F\fR\fIdir\fR \fR
.ad
.RS 11n
.rt  
フォント幅や端末テーブルを検索するディレクトリとして、 システムのデフォルトディレクトリの代わりに \fIdir\fR を使用します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-i\fR\fR
.ad
.RS 11n
.rt  
指定した入力ファイルをすべて処理したあと、 標準入力を読み込みます。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-m\fR\fIname\fR\fR
.ad
.RS 11n
.rt  
入力の \fIfilename\fR の前に、マクロファイル \fB/usr/share/lib/tmac/\fR\fIname\fR を付加します。なお、 マクロパッケージへの参照の多くは、 通常、 名前の先頭に \fIm\fR を含みます。たとえば \fBman\fR(5) マクロは、 \fB/usr/share/lib/tmac/an\fR 中に存在しています。マクロディレクトリを変更したければ、環境変数 \fBTROFFMACS\fR の値として希望するパスを設定してください。なお、パス名の最後に必ずスラッシュ ( / ) を付加するよう注意してください。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-n\fR\fIN\fR \fR
.ad
.RS 11n
.rt  
出力される先頭ページのページ番号を \fIN\fR に設定します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-o\fR\fIlist\fR \fR
.ad
.RS 11n
.rt  
特定のページだけを印刷出力したい場合、 \fIlist\fR 引数を使ってそのページ番号のリストを指定します。リスト中では項目をコンマで区切って記述し、 各項目として単一のページ番号または番号の範囲を記述できます。範囲指定には 3 つの形式があり、\fIN\fR\fB–\fR\fIM\fR はページ番号 \fIN\fR から \fIM\fR までを表し、先頭項目として指定する \fB–\fR\fIN\fR は先頭ページからページ \fIN\fR までを表し、最終項目として指定する \fIN\fR\fB–\fR はページ \fIN\fR から最終ページまでを表します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-q\fR\fR
.ad
.RS 11n
.rt  
\fBnroff\fR では静寂モードを示すオプションです。\fBtroff\fR では無視されます。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-r\fR\fIaN\fR \fR
.ad
.RS 11n
.rt  
レジスタ \fIa\fR の値として \fIN\fR を設定します。a は常に 1 文字の名前です。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-s\fR\fIN\fR \fR
.ad
.RS 11n
.rt  
\fIN\fR ページを出力するごとに 写真植字機を停止させます。機器の種類によっては、 \fBtroff\fR がトレーラページを出力するのでカセットを 交換することができます。機器のスタートボタンを押せば 印刷が再開できます。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-u\fR\fIN\fR\fR
.ad
.RS 11n
.rt  
ポジション 3 にマウントされているフォント用の ボールド（太文字）化ファクタ値を \fIN\fR に設定します。\fIN\fR 引数を省略すると、ボールド化ファクタ値は 0 に設定されます。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-z\fR\fR
.ad
.RS 11n
.rt  
清書した出力結果を印刷しません。つまり診断メッセージや \fB\&.tm\fR 要求を使って出力されたメッセージだけが印刷されます。
.RE

.SH オペランド
.sp
.LP
次のオペランドを指定できます。
.sp
.ne 2
.mk
.na
\fB\fIfilename\fR\fR
.ad
.RS 12n
.rt  
\fBtroff\fR によって処理されるテキストを含むファイル
.RE

.SH ファイル
.sp
.ne 2
.mk
.na
\fB\fB/tmp/trtmp\fR \fR
.ad
.RS 27n
.rt  
一時ファイル
.RE

.sp
.ne 2
.mk
.na
\fB\fB/usr/share/lib/tmac/*\fR \fR
.ad
.RS 27n
.rt  
標準マクロファイル
.RE

.sp
.ne 2
.mk
.na
\fB\fB/usr/lib/font/*\fR \fR
.ad
.RS 27n
.rt  
マウントされている代替 \fBtroff\fR フォント用のフォント幅テーブル
.RE

.sp
.ne 2
.mk
.na
\fB\fB/usr/share/lib/nterm/*\fR \fR
.ad
.RS 27n
.rt  
\fBnroff\fR 用の端末駆動テーブル
.RE

.SH 属性
.sp
.LP
属性についての詳細は、マニュアルページの \fBattributes\fR(5) を参照してください。
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
属性タイプ属性値
_
使用条件text/doctools
.TE

.SH 関連項目
.sp
.LP
\fBchecknr\fR(1), \fBcol\fR(1), \fBeqn\fR(1), \fBman\fR(1), \fBnroff\fR(1), \fBtbl\fR(1), \fBattributes\fR(5), \fBman\fR(5), \fBme\fR(5), \fBms\fR(5)
.SH 注意事項
.sp
.LP
\fBtroff\fR は 7 ビット \fBASCII\fR に基づいて設計されているので、8 ビットクリーンではありません。
.sp
.LP
以前のドキュメントでは、数値レジスタ \fByr\fR を\fB現在の年の末尾の 2 桁\fRであると説明していましたが、これは正しくありません。\fByr\fR は、実際には 1900 年以来の年数を示します。2099 年までの、現在の年号の末尾の 2 桁を正しく獲得するには、次の文字列レジスタ \fByy\fR の定義をドキュメントに含めると、2 桁の年号を表示するために使用できます。\fByr\fR の代わりに、別の 1 つまたは 2 つの文字をレジスタ名として使用できます。
.sp
.in +2
.nf
\&.\e" definition of new string register yy--last two digits of year
\&.\e" use yr (# of years since 1900) if it is < 100
\&.ie \en(yr<100 .ds yy \en(yr
\&.el \e{             .\e" else, subtract 100 from yr, store in ny
\&.nr ny \en(yr-100
\&.ie \en(ny>9 \e{     .\e" use ny if it is two digits
\&.ds yy \en(ny
\&.\e" remove temporary number register ny
\&.rr ny \e}
\&.el \e{.ds yy 0
\&.\e" if ny is one digit, append it to 0
\&.as yy \en(ny
\&.rr ny \e} \e}
.fi
.in -2