roff 清書システムは、整形用言語、マクロパッケージ、 プリプロセッサ、出力デバイス用ポストプロセッサ、 ユーザ用フロントエンドプログラム、そして変換ツールから 構成されています。
今日、最も一般的な roff システムはフリーソフトウェアでの 実装である groff (`GNU roff') です。groff より前の実装は「古典」 (1973 年まで遡ります) と呼ぶことにします。
groff は、古典である祖先のシステムと下位互換性がありますが、数多くの 拡張がされており、今もなお進化し続けています。 ほとんどすべての計算機システムで利用できるため、今日では事実上の roff 標準となっています。
その古さにもかかわらず、roff は今日でも広く使用されています。 例えば、UNIX システムのマニュアルページ (manページ) は roff で書かれています。 テキストデバイスに対する roff 出力は、いまだに並ぶもののないほど優れて います。グラフィカルな出力も他のフリーの清書プログラムと同等の品質を 持っていますし、ものによっては商用システムのものよりも優れているときも あります。
このドキュメントでは概要のみを示し、詳細なドキュメントについては ポインタを示します。
このドキュメントは維持されておらず、時代遅れになっている可能性が あります。正確なドキュメントが必要なら groff info ファイルを 参照してください。これには詳細で現実に即した正確なリファレンス情報が 含まれています。
groff 言語 のすべての部分について記述されたドキュメントの一次情報源は groff info ファイルです。 groff(7) マニュアルページでは、定義済みの言語要素すべてについて 簡潔な説明をしています。
roff を使用したドキュメントは、普通のテキストファイルを整形用 要素で修飾したものです。 マクロパッケージの 1 つを使って高品質のドキュメントを書くのは とても簡単なことです。 マクロパッケージは高水準プログラミング言語のようなものであり、 それに対して素の roff 言語は C やアセンブラのような低水準言語に たとえられます。
roff 言語は低水準のリクエスト、マクロ定義、エスケープシーケンス、 文字列変数、数値レジスタまたはサイズレジスタ、そして C のような 制御構造を提供する完全なプログラミング言語です。
この言語の要素についていくらか説明が必要でしょう。 リクエストは、C, C++ のようなプログラミング言語によって定義された 基本的な整形用コマンドです。それに対して、マクロは roff 言語で 記述された整形用コマンドです。 ドキュメントの著者は、リクエストとマクロを使う際の違いに 気づくことはないでしょう。どちらもドット . 始まりの単独行で記述されます。 ただし、望むならば、ユーザは独自のマクロを定義できます。
エスケープシーケンスはインライン要素で、バックスラッシュ \ で始まります。これらはさまざまな機能を実装するのに 使われます。それには、 ( を用いた非 ASCII 文字の挿入、 * を用いた文字列の内容の挿入、 n を用いたレジスタ変数の挿入、 f を用いたフォントの変更、 " を用いた文中のコメント、 \ のような特殊な制御文字のエスケープ、 その他多くの機能が含まれます。
これらのプログラムは groff 実装でもまだ存在しますが、通常は groff と呼ばれるプログラムを通してアクセスされます。 これによって、古くからの機能を 1 つのプログラムに結合し、拡張 できるのです。 groff には多くのコマンドラインオプションがあります。その大部分が troff からもらい受けたものです。 このオプションの密林から逃れるべく、ユーザフレンドリなユーティリティ grog (`groff guess' からとられた名前です) が作成されました。 これは、どの引数を使うべきかを、ドキュメントから推測して、適切な コマンドラインを表示します。 完璧なものではありませんが、取り掛かりには良いでしょう。
これらのプリプロセッサはそれぞれ独自の言語を定義しており、 プリプロセッサに通されると、roff コードに変換されます。 ですので、これらの言語で書かれた部分は roff ドキュメントに 埋め込んであっても良いのです。 こうした拡張ドキュメントは、実際のフォーマッタにかけられる前に、 対応する 1 つ以上のプリプロセッサに通されます。
プリプロセッサプログラムは、プリプロセッサ用に 限定されているドキュメントの部分を抽出し、変換します。 プリプロセッサは、 それらのプログラム名を使った UNIX パイプラインで呼び出すことも、 もしくは groff オプションで自動的に呼び出すこともできます。
| ||||||||||||||||||
ドキュメントが使用するマクロパッケージは、 フォーマッタのコマンドラインオプション -m で指定し、例えば troff -m name や groff -m name とします。 マクロパッケージの命名およびその置き場所についての一般的な詳細は groff_tmac(5) にあります。
古くからある有名なマクロパッケージは man, mandoc, mdoc がマニュアルページ用、そして me, ms, mm が書籍、記事、そして手紙用です。 これらのコレクションのほかにも、groff はさまざまな用途の 新しいマクロパッケージを提供しており、その数は増加しています。 例えば、他のファイル形式を統合したり変換したりするものです。
古典的なマクロパッケージは、パッケージ名を拡張子にとります。 例えば、 me マクロパッケージを使ったドキュメントは file.me となり、 mm マクロパッケージに対しては file.mm 、 ms マクロパッケージに対しては file.ms 、 pic ファイルに対しては file.pic といった具合です。
最後に、ローカルのマクロディレクトリ /usr/share/tmac は、サイト固有のマクロとパッケージ用に提供されます。 デフォルトでは、メインのマクロディレクトリの前にここが検索されます。
このドキュメントは FDL (GNU Free Documentation License) バージョン 1.1 以降の条項のもとに配布されています。FDL のコピーをシステム上に 持っているはずです。また、これはオンライン
でも入手可能です。定義済みの groff 言語要素についても groff(7) マニュアルページに記載があります。
フォーマッタおよびそのラッパについては groff(1), grog(1), nroff(1), troff(1) に記載があります。
出力デバイス用のポストプロセッサについては grodvi(1), grohtml(1), grolbp(1), grolj4(1), grops(1), grotty(1) に記載があります。
標準プリプロセッサについては eqn(1), grn(1), grap(1), pic(1), refer(1), soelim(1), tbl(1) に記載があります。
マクロパッケージについてのマニュアルページには groff_tmac(5), groff_man(7), groff_markup(7), groff_mdoc(7), groff_mdoc.samples(7), groff_me(7), groff_mm(7), groff_mmroff(7), groff_ms(7) が含まれています。
次のようなユーティリティが利用できます: addftinfo(1), afmtodif(1), hpftodit(1), indxbib(1), lookbib(1), pfbtops(1), tfmtodit(1), gxditview(1) です。
roff システムの GNU 実装についての詳細は groff_char(7), groff_font(7), groff_out(7) および groff ソース配布物のメインディレクトリ内の README ファイルを参照してください。 groff 開発グループとの連絡の取り方や参加の仕方についての 詳細も載っています。
古典的な ドキュメントは今でもオンラインで入手可能です。 特に有益なのが、かのフリーである UNIX 7 用のベル研オリジナルの 会報です。これは http://cm.bell-labs.com/cm/cs/cstr.html にあります。そして、故 Richard S. Stevens のコレクションが http://www.kohala.com/start/troff/ にあります。