1 .\" Copyright (c) 1991, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
13 .\" 3. All advertising materials mentioning features or use of this software
14 .\" must display the following acknowledgement:
15 .\" This product includes software developed by the University of
16 .\" California, Berkeley and its contributors.
17 .\" 4. Neither the name of the University nor the names of its contributors
18 .\" may be used to endorse or promote products derived from this software
19 .\" without specific prior written permission.
21 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 .\" @(#)mdoc.7 8.2 (Berkeley) 12/30/93
35 .\" $Id: mdoc.7,v 1.8 1998/12/04 00:51:17 jkoshy Exp $
37 .\" The December 30, 1993 version
38 .\" Modified by David A. Wheeler (dwheeler@ida.org) on 1999-07-11
39 .\" to conform to Linux.
42 .\"*******************************************************************
44 .\" This file was generated with po4a. Translate the source file.
46 .\"*******************************************************************
48 .\" Japanese Version Copyright (c) 2000 NAKANO Takeo all rights reserved.
49 .\" Translated Fri 14 Jan 2000 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
50 .\" Updated 2008-07-31 by Kentaro Shirakata <argrath@ub32.org>
68 man ページに用いられる内容ベース・ドメインベースのマクロである。
69 以下ではクイックリファレンスとしてマクロの名前とその意味をリストする。 このパッケージの利用法に関する詳細な説明は、 チュートリアル用の見本である
73 これは Linux の文書で通常用いられているマクロパッケージとは異なる。 しかし広く用いられているいくつかのプログラムの文書で、
78 マクロは 2 つのグループに分けて説明する。 最初のグループは構造や物理的なページレイアウトに関するマクロである。 2 つめはマニュアルドメインマクロ
79 (manual domain macro) や一般テキストドメインマクロ (general text domain macro) で、
83 フォーマットパッケージと差別化しているものである。
86 正しいマニュアルページを生成するためには、これらの 3 つのマクロを この順番で書く必要がある。
87 .Bl -tag -width "xxxx.Os OPERATINGxSYSTEM [version/release]" -compact
88 .It Li "\&.Dd " Ar "Month day, year"
90 .It Li "\&.Dt " Ar "DOCUMENT_TITLE [section] [volume]"
92 .It Li "\&.Os " Ar "OPERATING_SYSTEM [version/release]"
97 セクションヘッダ、段落の終わり、リスト、表示など。
98 .Bl -tag -width flag -compact
100 セクションのヘッダ。 正しいヘッダは、現れる順に:
101 .Bl -tag -width "RETURN VALUE" -compact
113 一般的な説明。オプションやパラメータの説明も含む。
123 通常セクション 4 のデバイスインターフェースの診断用。
125 セクション 2 や 3 のエラーやシグナル処理。
131 標準が適用されていない場合は、 歴史的な内容を与えるべきである。
142 (D-one) Display-one インデントしてテキストを一行表示。
144 (D-ell) Displey-one literal。 インデントしてリテラルなテキストを一行表示。
147 .Bl -tag -width "xoffset string " -compact
158 .It Fl offset Ar string
162 .Bl -tag -width indent-two -compact
172 揃えブロックを右から 2 インチの位置に残す。
191 リスト開始。 リストまたはコラムを生成する。オプションは以下:
192 .Bl -tag -width flag -compact
194 .Bl -column ".Fl bullet" -compact
195 .It Fl bullet Ta 中黒のアイテムリスト
196 .It Fl item Ta ラベルなしリスト
197 .It Fl enum Ta 数値付きリスト
198 .It Fl tag Ta タグラベル付きリスト
199 .It Fl diag Ta "診断リスト (diagnostic list)"
200 .It Fl hang Ta ぶらさがりラベルリスト
201 .It Fl ohang Ta 飛び出しラベルリスト
202 .It Fl inset Ta ラベル付きリストの挿入・継続
205 .Bl -tag -width "xcompact " -compact
209 ディスプレイ開始 (begin-display) を見よ。
226 .Sh マニュアルドメインマクロと一般テキストドメインマクロ
227 マニュアルドメインマクロと一般テキストドメインマクロとが 他と異なっているのは、 呼びだし可能マクロ (callable macro) の内部では、
228 そのほとんどがパーズされるという点である。 例えば以下のように変換される:
229 .Bl -tag -width ".Op Fl s Ar filex" -offset indent
230 .It Li "\&.Op Fl s Ar file"
237 に与えられたオプションがパーズされ、 中身の呼びだし可能なマクロである
241 に対して作用する。そして次に中身の呼びだし可能なマクロ
245 に作用する。呼びだし可能であるがパースされないマクロや、 その逆のマクロも存在する。このようなマクロは以下の
251 特に記述がなければ、マニュアルドメインマクロは共通の書式をとる:
253 .Dl \&.Va argument [\ .\ ,\ ;\ :\ (\ )\ [\ ]\ argument ...\ ]
256 句読文字 (punctuation character) の開き・閉じは、
257 それらが一度に単一の文字で現れた場合のみそのように解釈される。 文字列
259 は、句読区切りとはみなされず、その前に空白文字があれば
260 その文字とともに、また呼び出したマクロが用いるフォントで出力される。 引数リスト
263 つの連続した閉じ句読文字と解釈され、 それぞれの前にある空白文字は、各文字や (もしあれば) その前にある 引数との間には出力されない。
266 によってエスケープできる。 例えば以下の左の文字列は右のように変換される。
267 .Bl -tag -width "&.Ar file1\ , file2\ , file3\ )\ ." -offset indent
268 .It Li "\&.Ar file1\ , file2\ , file3\ )\ ."
270 .Ar file1 , file2 , file3 ) .
274 .Bl -column Name Parsed Callable\(dq -compact
275 .It Em "名前 Parsed Callable 説明"
276 .It Li \&Ad Ta Yes Ta Yes Ta "アドレス (このマクロは使わない方が良い)"
277 .It Li \&An Ta Yes Ta Yes Ta 著者の名前
278 .It Li \&Ar Ta Yes Ta Yes Ta コマンドライン引数
279 .It Li \&Cd Ta \&No Ta \&No Ta "設定の宣言 (セクション 4 のみ)"
280 .It Li \&Cm Ta Yes Ta Yes Ta コマンドライン引数の修正子
281 .It Li \&Dv Ta Yes Ta Yes Ta "定義済み変数 (ソースコード)"
282 .It Li \&Er Ta Yes Ta Yes Ta "エラー番号 (ソースコード)"
283 .It Li \&Ev Ta Yes Ta Yes Ta 環境変数
284 .It Li \&Fa Ta Yes Ta Yes Ta 関数の引き数
285 .It Li \&Fd Ta Yes Ta Yes Ta 関数の宣言
286 .It Li \&Fn Ta Yes Ta Yes Ta "関数呼びだし (.Fo と .Fc も)"
287 .It Li \&Ic Ta Yes Ta Yes Ta インタラクティブなコマンド
288 .It Li \&Li Ta Yes Ta Yes Ta リテラルなテキスト
289 .It Li \&Nm Ta Yes Ta Yes Ta コマンドの名前
290 .It Li \&Op Ta Yes Ta Yes Ta "オプション (.Oo と .Oc も)"
291 .It Li \&Ot Ta Yes Ta Yes Ta "古い形式の関数型 (Fortran のみ)."
292 .It Li \&Pa Ta Yes Ta Yes Ta パス名またはファイル名
293 .It Li \&St Ta Yes Ta Yes Ta "標準 (\-p1003.2, \-p1003.1, \-ansiC のどれか)"
294 .It Li \&Va Ta Yes Ta Yes Ta 変数の名前
295 .It Li \&Vt Ta Yes Ta Yes Ta "変数の型 (Fortran のみ)"
296 .It Li \&Xr Ta Yes Ta Yes Ta マニュアルページの相互参照
299 .Bl -column Name Parsed Callable\(dq -compact
300 .It Em "名前 Parsed Callable 説明"
301 .It Li \&%A Ta Yes Ta \&No Ta 参考文献の著者
302 .It Li \&%B Ta Yes Ta Yes Ta 参考文献の書籍タイトル
303 .It Li \&%\&C Ta \&No Ta \&No Ta "参考文献の出版地 (街)"
304 .It Li \&%\&D Ta \&No Ta \&No Ta 参考文献の日付
305 .It Li \&%J Ta Yes Ta Yes Ta 参考文献の雑誌名
306 .It Li \&%N Ta \&No Ta \&No Ta 参考文献の号数
307 .It Li \&%\&O Ta \&No Ta \&No Ta 参考文献の補助情報
308 .It Li \&%P Ta \&No Ta \&No Ta 参考文献のページ
309 .It Li \&%R Ta \&No Ta \&No Ta 参考文献のリポート名
310 .It Li \&%T Ta Yes Ta Yes Ta 参考文献の記事タイトル
311 .It Li \&%V Ta \&No Ta \&No Ta 参考文献の巻数
312 .It Li \&Ac Ta Yes Ta Yes Ta アングルクォートの閉じ
313 .It Li \&Ao Ta Yes Ta Yes Ta アングルクォートの開き
314 .It Li \&Ap Ta Yes Ta Yes Ta アポストロフィ
315 .It Li \&Aq Ta Yes Ta Yes Ta アングルクォート
316 .It Li \&At Ta \&No Ta \&No Ta Tn "AT&T UNIX"
317 .It Li \&Bc Ta Yes Ta Yes Ta ブラケットクォートの閉じ
318 .It Li \&Bf Ta \&No Ta \&No Ta フォントモードの開始
319 .It Li \&Bo Ta Yes Ta Yes Ta ブラケットクォートの開き
320 .It Li \&Bq Ta Yes Ta Yes Ta ブラケットクォート
321 .It Li \&Bx Ta Yes Ta Yes Ta Bx .
322 .It Li \&Db Ta \&No Ta \&No Ta "デバッグ (デフォルトは \*qoff\*q)"
323 .It Li \&Dc Ta Yes Ta Yes Ta ダブルクォートの閉じ
324 .It Li \&Do Ta Yes Ta Yes Ta ダブルクォートの開き
325 .It Li \&Dq Ta Yes Ta Yes Ta ダブルクォート
326 .It Li \&Ec Ta Yes Ta Yes Ta エンクローズ文字列引用の閉じ
327 .It Li \&Ef Ta \&No Ta \&No Ta フォントモードの終了
328 .It Li \&Em Ta Yes Ta Yes Ta "強調 (traditional English)."
329 .It Li \&Eo Ta Yes Ta Yes Ta エンクローズ文字列引用の開き
330 .It Li \&Fx Ta \&No Ta \&No Ta Tn "FreeBSD operating system"
331 .It Li \&No Ta Yes Ta Yes Ta "通常のテキスト (効果なし)"
332 .It Li \&Ns Ta Yes Ta Yes Ta スペース無し
333 .It Li \&Pc Ta Yes Ta Yes Ta 括弧クォートの閉じ
334 .It Li \&Pf Ta Yes Ta \&No Ta 前置文字
335 .It Li \&Po Ta Yes Ta Yes Ta 括弧クォートの開き
336 .It Li \&Pq Ta Yes Ta Yes Ta 括弧クォート
337 .It Li \&Qc Ta Yes Ta Yes Ta ダブルストレートクォートの閉じ
338 .It Li \&Ql Ta Yes Ta Yes Ta クォートされたリテラル
339 .It Li \&Qo Ta Yes Ta Yes Ta ダブルストレートクォートの閉じ
340 .It Li \&Qq Ta Yes Ta Yes Ta ダブルストレートクォートの閉じ
341 .It Li \&Re Ta \&No Ta \&No Ta 参考文献の終了
342 .It Li \&Rs Ta \&No Ta \&No Ta 参考文献の開始
343 .It Li \&Rv Ta \&No Ta \&No Ta "返り値 (セクション 2, 3 のみ)"
344 .It Li \&Sc Ta Yes Ta Yes Ta シングルクォートの閉じ
345 .It Li \&So Ta Yes Ta Yes Ta シングルクォートの開き
346 .It Li \&Sq Ta Yes Ta Yes Ta シングルクォート
347 .It Li \&Sm Ta \&No Ta \&No Ta "スペースモード (デフォルトは \*qon\*q)"
348 .It Li \&Sx Ta Yes Ta Yes Ta セクションの相互参照
349 .It Li \&Sy Ta Yes Ta Yes Ta "シンボリック (traditional English)."
350 .It Li \&Tn Ta Yes Ta Yes Ta "Trade または型名 (small Caps)."
351 .It Li \&Ux Ta Yes Ta Yes Ta Ux
352 .It Li \&Xc Ta Yes Ta Yes Ta 拡張引数リストの閉じ
353 .It Li \&Xo Ta Yes Ta Yes Ta 拡張引数リストの開き
355 .\" .It Sy \&Hf Ta \&No Ta \&No Ta "Include file with header"
358 で終わる名前のマクロは、引数リストの残りの項目をクォートする。
360 で終わる名前のマクロは一行以上にわたる入力のクォートを開始し、 これは対応する名前の
363 囲みマクロはネストでき、引数は 8 つまで取れる。
371 は変則である。 拡張リストマクロはマクロの引数が
376 .\" The following does not apply on Linux:
377 .\" .Sh CONFIGURATION
378 .\" For site specific configuration of the macro package,
380 .\" .Pa /usr/src/share/tmac/README .
381 UR マクロ (URI/URL ハイパーテキスト参照の開始), UE マクロ (終了), UN マクロ (参照用ターゲットの指定) も利用できる。
386 .Bl -tag -width tmac.doc-ditroff -compact
388 マニュアルドメインマクロと一般テキストドメインマクロ。
389 .It Pa tmac/doc-common
391 .It Pa tmac/doc-nroff
395 .It Pa tmac/doc-ditroff
411 の一部である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。