JM プロジェクトは、主に Linux 関連のマニュアルページの日本語ページを翻訳・公開しています。
... 用パッケージである -mdoc マクロパッケージを使って UNIX マニュアルページを書くための完全なリファレンスです。 前身である -man7 パッケージは、フォントの操作や ... 他の写植方法の詳細は個々の作者に任せ、 ページのレイアウトを取り扱ってきました。 -mdoc では、ページレイアウトマクロは タイトル、セクションのヘッダ、ディスプレイ、リストのマクロからなる ページ構造領域 を形成しています。本質的にこれらの要素は ... キスト領域の 2 つの領域があります。 一般テキスト領域は、テキストの一部をクォートしたり強調したりと いったような作業を実行するマクロとして定義されています。 マニュアル領域はコマンドやルーチン、それに UNIX の関連ファイルを記述するための日常使用されるインフォ ... ... ムのヘッダーファイルにより 公開される定義を制御することができる。 注意: 機能検査マクロを機能させるには、機能検査マクロの定義を 「どのヘッダーファイルのインクルードよりも前で」行わなければならない。 これを実現す ... るには、 コンパイルコマンドで指定する方法 ( cc -DMACRO=value ) と、ソースコード内で必要なマクロの定義を どのヘッダーのインクルードよりも前で行う方法がある。どのヘッダーファイルをインクルードするよりも前にこれらのマクロを ... できるからである。そのため、例えば、以下の例では、ヘッダー < abc.h > 自身が < xyz.h > をインクルードしていると、 _GNU_SOURCE マクロの定義は全く効果がないかもしれない (このようなインクルードは POSIX では明示的に認められている)。 #include < abc.h > #define ... ... ... ] [ files ... ] 解説 groff でマニュアルページを生成するのに使用される man マクロは、James Clark が書きました。 このドキュメントは、パッケージ中の各マクロの使い方を、短くまとめたものです。 オプション man マ ... プションの場合、 ページを 1, 2, 2a, 2b, 2c というように割り振ります。 使用法 このセクションは、マニュアルページ用に使用可能なマクロについて 述べています。さらにカスタマイズしたい場合は、 man.local ファイル中に追加のマクロおよびリクエストを置いてください。 ... 置かれます)。 extra3 はヘッダ行の中央に置かれます。 HTML 出力用には、ヘッダおよびフッタは完全に取り除かれます。 さらに、このマクロは改ページします。新しい行番号は、再度 1 に なります (コマンドラインで `-rC1' オプションが指定されている場合を 除きます)。こ ... ... れのマクロパッケージは、 そのパッケージの tmac ファイル と呼ばれるファイル中にマクロおよび定義を格納しています。 tmac という名前は、 ` ... るいは少数のディレクトリ内に 保管されています。 名称付け 古くからある roff システムには、奇妙な名称付けの体系が ありました。 マクロパッケージの名称が m で始まっている場合には、この文字は省略されました。例えば、 マニュアルページ用のマクロパッケージ man は ... an と呼ばれ、そのパッケージのマクロファイルは tmac.an と呼ばれました (現在のバージョンの groff では、このファイルは代りに an.tmac と呼ばれることに注意してくださ ... ... のもありますし、 開き括弧 ( に続いて符合化され長さの一定なものや、角括弧 [ と ] で括られているものもあります。 roff 言語は、マクロなど、言語拡張機能を書くための柔軟な手段を 提供しています。 マクロ定義を解釈する際に、roff システムは コピーモード と呼ばれる ... ては groff info ファイルおよび groff_tmac (5) を参照してください。 roff ソースファイルを読むのはこれよりは簡単です。 すべてのマクロ定義部分で 2 重になっているバックスラッシュを 1 つに置き換えればよいだけです。 groff 要素 roff 言語の要素は、テキストファイル ... 関数や単語中の整形要素です。 ユーザは独自の整形コマンドを .de リクエストを使って定義することができます。 これらのコマンドは マクロ と呼ばれていますが、実際にはリクエストとまったく同様に使われます。 マクロパッケージは groff 言語で書かれた定義済みのマクロ ... ... ページは GNU バージョンの ms マクロの解説をします。 このマクロは、groff 文書整形システムの一部分です。 この groff ms マクロは、4.3 BSD Unix ms マクロの文書化さ ... 能しないとしてももっともでしょう。 • タイプライタ様のデバイスには、サポートはありません。 • バークレイ方言、特に、 TM や CT マクロは、実装されていません。 • groff ms では、 カットマーク は提供しません。 • 重複した行送りは許されません (代わりに、大きな垂直 ... • エラー処理の方針については、groff ms は、沈黙したままエラーを無視 したりせず、エラーを検出してレポートします。 groff ms マクロは、GNU troff の多くの機能を利用しています。 したがって、これは他のいかなる troff によっても使用できません。 ベル研の方言は、 ... ... する。 as は、他のプログラムによって生成された出力をアセンブルすることを 目的としているので、アセンブラを手で書くときに便利なマクロや条件文といった 一般的な機能を持っていない。 gasp は、これらの (as にはない) 機能を提供する。 オプション -a, --alternate 別 ... のマクロ文法を使用する。 -c CHAR , --commentchar CHAR CHAR をコメント文字として使う。デフォルトのコメント文字は ` ! ' である。 -d, - ... --copysource コメントとしてソースの行を出力する。 -u, --unreasonable 無制限の (「非現実的な」) ネスト展開を許可する。 他のマクロの定義の中に gasp のマクロを定義できる時、 プリプロセッサは通常、sanity チェックを含める。 プログラムが 1000 回以上のネストさ ... ... れています。 しかし、以下のような制限があります: • ベル研の方言は実装されていません。 • マクロ OK 及び PM は実装されていません。 • groff mm は、カットマークをサポートしません。 mm は、国際化されて設計されています。 そ ... のため、各国語対応用の短いマクロファイルを書き換えて、 英語のテキストを好みの言語対応に置き換えることができます。 mmse を例として用いてください。 大域変数の ... 初期化後に locale か lang _locale という ファイルを読み込みます。そのため、企業名などについてのマクロを ローカライズすることができます。 このマニュアルでは、角括弧は省略可能な引数を表示するのに用いられます。 数値レジスタと文字 ... ... 書システムは、整形用言語、マクロパッケージ、 プリプロセッサ、出力デバイス用ポストプロセッサ、 ユーザ用フロントエンドプログラム、そして変換ツールから 構成され ... べてについて 簡潔な説明をしています。 roff を使用したドキュメントは、普通のテキストファイルを整形用 要素で修飾したものです。 マクロパッケージの 1 つを使って高品質のドキュメントを書くのは とても簡単なことです。 マクロパッケージは高水準プログラミング言語のよ ... ものであり、 それに対して素の roff 言語は C やアセンブラのような低水準言語に たとえられます。 roff 言語は低水準のリクエスト、マクロ定義、エスケープシーケンス、 文字列変数、数値レジスタまたはサイズレジスタ、そして C のような 制御構造を提供する完全なプログラ ... ... -E エラーメッセージを一切出力しません。 -z フォーマットした結果を出力しません。 -C 互換モードにします。 -d cs -d name = s マクロ c または name を文字列 s と定義します。 c は 1 文字のマクロ名です。 -f fam fam をデフォルトのフォントファミリとして使用しま ... す。 -m name マクロファイル name .tmac を読み込みます。見つからなければ、かわりに tmac. name を試みます。 まず最初に -M コマンドラインオプション ... .sy , .pi . そうでなければ、セキュリティのためにこれらの危険性のあるリクエストは 禁止されています。また現在のディレクトリをマクロ検索パスに加えます。 -R troffrc と troffrc-end を読みません。 -n num 最初のページ番号を num とします。 -o list list で指定し ... 日本語の文書やマニュアルを配布している個人/プロジェクトへのリンクです。