manページ  — GROFF_TMAC

groff_tmac - roff 清書システム内にあるマクロファイル

解説 GROFF マクロパッケージ man\~ページ 完全パッケージ 特殊パッケージ 名称付け 取り込み マクロの記述 コピーイン (copy-in) モード ドラフトモード マクロ定義のための助言 転換 (diversion) 関連ファイル 環境変数 作者 関連項目

groff は、すべての古典マクロパッケージ、いくつかの完全パッケージ、 そしていくつかの特殊な用途の補助パッケージを提供しています。 主要なマクロパッケージは同時に複数個使用できないことに注意してください。 例えば

や

は失敗します。

man	UNIX マニュアルページ (man ページ) 用の古典マクロパッケージです。 これはとても便利で使いやすいものです。 groff_man(7) を参照してください。
doc
mdoc
	man ページ用のもう 1 つのマクロパッケージで、 主に BSD システムで使用されています。 これはたくさんの新しい機能を提供していますが、 man ページの標準ではありません。 groff_mdoc(7) を参照してください。

この節のパッケージは、どのような種類の文書 (本をまるごとでさえ) も 執筆できる完全なマクロの組を提供します。 これらは機能的には類似しています。 どれを使用するかは、好みの問題です。

me	古典的な me マクロパッケージです。 groff_me(7) を参照してください。
mm	半古典的な mm マクロパッケージです。 groff_mm(7) を参照してください。
mom	新しい mom マクロパッケージです。 これは groff でのみ利用できます。 これは他のパッケージを元にしていないため、 自由に設計することができます。 したがって、これは非常によい、現代的なマクロパッケージになると 期待されています。 groff_mom(7) を参照してください。
ms	古典的な ms マクロパッケージです。 groff_ms(7) を参照してください。

この節のマクロパッケージは、単独で使用するように意図されたものではなく、 他のマクロパッケージや素の groff に特殊な機能を追加するために 使用されるものです。

papersize
	このマクロファイルは既に起動時に troff が読み込み済なので、明示的に呼び出す必要はありません。 コマンドラインオプション  -dpaper=]size] で 用紙サイズを設定するインタフェースを提供しています。 size に指定可能な値は、DESC ファイルでの定義済の papersize 値 (小文字だけです。 詳細は groff_font(5) を参照してください) ですが a7-d7 は指定できません。 文字 l (エル) を後に付けると、ランドスケープの向きを意味します。 例: a4, c3l, letterl 。
	ドライバ固有の DESC ファイルのデフォルト用紙長や向きに優先させるためには、 ほとんどの出力ドライバで追加のコマンドラインスイッチ -p および -l が必要となります。 例えば、ランドスケープの向きの A4 用紙に PS 出力を行う場合次のようにします:
pspic	このマクロでは、PostScript 画像を文書に取り込むために、1 個のマクロ PSPIC が提供されています。 PS 画像の取り込みをサポートする出力デバイス -Tps, -Tdvi, -Thtml でのみ意味があります。 ファイルは自動的にロードされます。 構文: amp;.PSPIC [-L|-R|-I n] file [width [height]]
	file は画像を含むファイルの名前、 width と height は画像の望みの幅と高さです。 width と height の引数には、スケール指示子を付けられます。 デフォルトのスケール指示子は i です。 このマクロは、x および y 方向に画像を一様にスケールしますので、画像は幅 width も高さ height も越えません。 デフォルトで、画像は水平位置の中央に置かれます。 -L および -R のオプションは、それぞれ画像を左寄せおよび右寄せにします。 -I オプションは、画像を n だけインデントします (デフォルトのスケール指示子は m です)。
tty-char
	tty デバイス用に、troff の標準文字や groff のいくつかの文字の定義を 上書きします。 貧弱な機器で処理できるようにするため、 通常の tty 形式のものと比べて、見た目を意図的に落しています。
www	インターネット (World Wide Web) ページで使用されている HTML フォーマットで知られている要素を追加します。 これには URL リンクやメールアドレスが含まれます。 groff_www(7) を参照してください。

古くからある roff システムには、 オプションを解釈する部分の過度に単純化された設計のせいで 奇妙な名称付けの体系がありました。 マクロパッケージは、常にオプション を用いて指定されていました。 このオプションの後に、区切りの空白もなしに直接引数が続くと、 1 つのマイナスに続く長い名前のオプションに見えます。 これは、コンピュータの石器時代には驚くべきことでした。 これをマクロパッケージの名前に対して実際に動くようにするため、 すべての古典的なマクロパッケージには の文字で始まる名前がつけられており、 この文字はマクロファイルの名前からは省略されていました。

例えば、man ページ用のマクロパッケージは man と呼ばれますが、このマクロファイルは tmac.an でした。 したがって、これは引数 an をオプション に指定すること、もしくは短く と指定することで有効にできました。

同様の理由で、 で始まらないマクロパッケージには、文書化の際や会話において、先頭に が付けられていました。 例えば、 tmac.doc に対応するパッケージでは、より適切な名前は doc であるのに関わらず、文書中では mdoc と呼ばれていました。 なぜなら、オプションとその引数との間の空白を省略すると、 このパッケージを有効にするコマンドラインオプションは と表されるからです。

すべての状況に対処するため、現在のバージョンの groff(1) では、この虐げられてきたマクロパッケージに対して、先頭に が付くものと付かないものの 2 つのマクロファイルを提供することによって、 両方の名称付け体系をうまく扱うことができます。 したがって groff では、 man マクロパッケージは以下の 4 つの方法のうちの 1 つで指定することができます:

最近のパッケージで で始まらないものは、文書化の際に追加の を使用しません。 例えば、 www マクロパッケージは次の 2 つの方法のうちの 1 つのみで指定できます:

明らかに -mmwww のようなものは意味をなしません。

古典的な troff の持つ 2 番目の奇妙な特徴は、マクロファイルに tmac.name のような名前を付けることです。 現代的なオペレーティングシステムでは、ファイルの種類は接尾辞、 つまりファイル名の拡張子によって指定されます。 先ほどと同様に、groff は、 anything のみが指定された場合 anything.tmac と tmac.anything のどちらも検索することによって、この状況に対処します。

システムでどのマクロパッケージが利用可能であるかを調べる最も簡単な方法は、 man ページ groff(1) 、もしくは tmac ディレクトリの内容を確認することです。

groff では、マクロパッケージのほとんどは groff_name](7) という man ページで説明されています。 古典的パッケージについては、先頭に がついています。

groff がマクロを読む込むフェーズを、roff では コピーインモード と言います。 これは、C 言語でプログラムを開発する時の C プリプロセッサが処理を 行うフェーズに似ています。

このフェーズでは、groff はすべてのバックスラッシュを解釈します。 これは、マクロ本体のすべてのエスケープシーケンスが解釈され、 それぞれの値に置き換えられることを意味します。 変化しない表現であれば、これは望まれた動作ですが、 マクロ呼び出しのたびに変化するかもしれない文字列やレジスタは、 値を評価しないように保護しなくてはなりません。 これは、エスケープシーケンスの先頭にあるバックスラッシュを 二重にすることでとても容易に行うことができます。 位置パラメータにとって、この二重化は最も重要です。 例として、マクロに渡された引数の情報を端末に表示するには、 例えば以下のような `.print_args' という名前のマクロを定義します。

このマクロが次のように呼ばれると、

以下のようなテキストが端末に表示されます:

arg1 arg2

では、マクロ定義中の各バックスラッシュを解析してみましょう。 位置パラメータと引数の数は、各マクロ呼び出しで変化するので、 先頭のバックスラッシュは二重化しなければなりません。 よって、 [rs][rs]$* と [rs][rs][.$] となります。 同様にマクロ名にもこれを適用します。 なぜなら、別名で呼ばれるかも知れないからです。 したがって、 [rs][rs]$0 となります。

一方、 midpart は文字列定数であり変化しないので、 [rs]*[midpart] は二重化しません。 [rs]f エスケープシーケンスは、テキスト中のフォントを設定する 定義済み groff 要素です。 もちろん、この動作も変化しないので [rs]f[I] と [rs]f[] は二重化しません。

エスケープ機構を一時的に無効にすると、マクロを記述するのは簡単になります。 groff では、マクロ定義を .eo と .ec リクエストの組で囲むことで無効にすることができます。 するとマクロ定義の本体は、通常の文書部分と同じようになります。 ここで通常の文書部分とは、リクエストやマクロ、文字列、 レジスタなどの呼び出しで拡張されたテキストのことです。 例えば、上記のコードは以下のように簡単に書くことができます。

よくないことに、ドラフトモードは常に使えるわけではありません。 これは通常のマクロを定義するには十分ですが、ドラフトモードは 間接的に定義された文字列やレジスタなどの高度な応用には使えません。 最もよい方法は、すべてのマクロをドラフトモードで定義してテストをし、 そして最後の段階としてバックスラッシュを二重化することです。 .eo リクエストを外すのを忘れないようにしてください。

	すべての行をドットで始めるようにします。 例えば、テキスト行に groff リクエスト .nop を使用したり、先頭がドットのテキスト行も扱うあなた独自のマクロを書きます。
	コピーインモードでもドラフトモードでも動作するように、 コメントマクロを記述するようにします。 なぜなら、ドラフトモードではエスケープが無効になるので、 通常のコメントが使用された時、問題が起こるかも知れないからです。 例えば、以下のマクロは単に引数を無視するので、 コメント行のように動作してしまいます。
	長いマクロ定義中では、コメント行や構造化のための空行を たくさん使用するようにします。
	読みやすくするために、リクエストやマクロ呼び出しに対して groff のインデント機能を使用するようにします (先頭のドットの後に、任意の空白を置けます)。

転換は、非常に高度なプログラミング構造を実現するために使用されます。 これらは C プログラミング言語における大きなデータ構造へのポインタに 似ていますが、その使用方法はとても異なっています。

過度に単純化された形式では、転換は複数行の文字列ですが、 転換の能力は、それがマクロ中で動的に使用された時に現れます。 転換内に保持された情報は、転換をちょうどマクロのように呼び出すことで 取り出すことができます。

転換に関して起こるほとんどの問題は、転換は常に完全な行を 扱うのだという事実を意識することで避けることができます。 行バッファがフラッシュされてない時に転換が使用された場合、 奇妙な結果が生成されます。 このことを知らないと、多くの人が転換を使いものにならないと 思ってしまいます。 転換が動作することを保証するには、 改行を適切な場所で入れることが必要です。 安全のために、転換に関するものはすべて、1 対の改行の間に入れます。 例えば、 .br リクエストを多用します。 この規則は、転換の定義の中と外の両方、 そしてすべての転換の呼び出しに適用するのがよいでしょう。 これは少しやりすぎですが、これでちゃんと動作します。

[もし現在行の途中までを無視して転換を行う必要がある時には、 現在行の途中までを保存するのに環境を使用するか、または .box リクエストを使用するか、もしくはこの両方を使用します]

転換の最も強力な特徴は、あるマクロ定義中で転換を開始し、 他のマクロ中で転換を終えることです。 すると、このマクロの組のそれぞれの呼び出しの間のすべてが 転換に格納され、マクロ中で操作することができます。

tmac の機構を完全に使用するためには、すべてのマクロの名前は name.tmac と名付けなければなりません。 古典パッケージのように tmac.name も同様に可能ですが、使用しない方がよいでしょう。

マクロファイルは tmac ディレクトリ に保持されています。 tmac パス は、これらのコロン区切りのリストで構成されます。

マクロファイルの検索手順は以下のように (この順で) 行われます:

	troff/groff の -M コマンドラインオプションで指定されたディレクトリ
	環境変数で与えられたディレクトリ
	カレントディレクトリ (安全でないモードの時のみ。これは -U コマンドラインスイッチで有効になります)
	ホームディレクトリ
	プラットフォーム特有のディレクトリ。 このインストールでは /usr/share/tmac です。
	サイト特有 (プラットフォーム非依存) のディレクトリ。 このインストールでは /usr/share/tmac です。
	主要の tmac ディレクトリ。 このインストールでは /usr/share/tmac です。

追加された tmac ディレクトリのコロン区切りのリストで、
	このリストからマクロファイルを探します。 詳細は、前の節を参照してください。

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

この文書は、FDL (GNU Free Documentation License) バージョン 1.1 か それ以降のものに基づいて配布されています。 あなたは、システム上に FDL のコピーを受け取っているはずですが、 これは からもオンラインでも入手可能です。

この文書は groff 、すなわち GNU roff 配布物の一部です。 これは によって書かれ、 によって保守されています。