.\" 2007-05-30 created by mtk, using text from old man.7 plus
.\" rewrites and additional text.
.\"
-.\" Japanese Version Copyright (c) 2007 Akihiro MOTOKI
-.\" all rights reserved.
-.\" Translated 2007-06-13, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.54
-.\" Updated 2007-07-04, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.59
-.\" Updated 2007-09-03, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.64
-.\" Updated 2008-08-09, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.05
-.\"
-.TH MAN-PAGES 7 2008-10-28 "Linux" "Linux Programmer's Manual"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH MAN\-PAGES 7 2008\-10\-28 Linux "Linux Programmer's Manual"
.SH 名前
-man-pages \- Linux の man ページを書く際の決まり事
+man\-pages \- Linux の man ページを書く際の決まり事
.SH 書式
-.B man
-.RI [ section ]
-.I title
+\fBman\fP [\fIsection\fP] \fItitle\fP
.SH 説明
-このページでは、
-Linux \fIman-pages\fP プロジェクトのマニュアルページを書く際に
-従うべき決まり事について説明する。
-Linux \fIman-pages\fP は Linux のマニュアルページの
-セクション 2, 3, 4, 5, 7 から構成されている。
-このページで説明されている決まり事は、他のプロジェクトの
-マニュアルページを書く作者にも役立つことだろう。
+このページでは、 Linux \fIman\-pages\fP プロジェクトのマニュアルページを書く際に 従うべき決まり事について説明する。 Linux
+\fIman\-pages\fP は Linux のマニュアルページの セクション 2, 3, 4, 5, 7 から構成されている。
+このページで説明されている決まり事は、他のプロジェクトの マニュアルページを書く作者にも役立つことだろう。
.SS マニュアルページのセクション
.PP
マニュアルのセクションは、習慣的に以下のような定義が用いられている:
-.TP 10
-.B 1 コマンド (プログラム)
+.TP 10
+\fB1 コマンド (プログラム)\fP
シェルの中からユーザが実行できるコマンド。
-.TP
-.B 2 システムコール
+.TP
+\fB2 システムコール\fP
カーネルが処理しなければならない関数。
-.TP
-.B 3 ライブラリコール
-.I libc
-の関数の大部分。
-.TP
-.B 4 スペシャルファイル (デバイス)
-.I /dev
-以下にあるファイル。
-.TP
-.B 5 ファイルのフォーマットと規約
-.I /etc/passwd
-などの人が読めるファイルのフォーマット。
-.TP
-.B 6 ゲーム
-.TP
-.B 7 約束事その他
+.TP
+\fB3 ライブラリコール\fP
+\fIlibc\fP の関数の大部分。
+.TP
+\fB4 スペシャルファイル (デバイス)\fP
+\fI/dev\fP 以下にあるファイル。
+.TP
+\fB5 ファイルのフォーマットと規約\fP
+\fI/etc/passwd\fP などの人が読めるファイルのフォーマット。
+.TP
+\fB6 ゲーム\fP
+.TP
+\fB7 約束事その他\fP
様々な事柄の概要、慣習、プロトコル、文字集合の規格、その他雑多なこと。
-.TP
-.B 8 システム管理コマンド
-.BR mount (8)
-のような root のみが実行可能なコマンド。
+.TP
+\fB8 システム管理コマンド\fP
.\" .TP
-.\" .B 9 カーネルルーチン
-.\" このマニュアルセクションは廃止された。
-.\" かつてはここに Linux カーネルのドキュメントを置くのが良いことだと
-.\" 考えられていた。しかし、文書化されたものは非常に少なく、
-.\" またそれらもすでに古いものとなってしまった。
-.\" カーネル開発者にとって、もっとよい情報源が他にあるだろう。
+.\" .B 9 Kernel routines
+.\" This is an obsolete manual section.
+.\" Once it was thought a good idea to document the Linux kernel here,
+.\" but in fact very little has been documented, and the documentation
+.\" that exists is outdated already.
+.\" There are better sources of
+.\" information for kernel developers.
+\fBmount\fP(8) のような root のみが実行可能なコマンド。
.SS マクロパッケージ
-新しいマニュアルページは
-.BR man (7)
-で説明されている
-.B groff an.tmac
-パッケージを使って記述すべきである。
-この方針は一貫性の確保が主な理由である。既存の Linux のマニュアルページ
-の圧倒的多数がこれらのマクロを使って記述されている。
+新しいマニュアルページは \fBman\fP(7) で説明されている \fBgroff an.tmac\fP パッケージを使って記述すべきである。
+この方針は一貫性の確保が主な理由である。既存の Linux のマニュアルページ の圧倒的多数がこれらのマクロを使って記述されている。
.SS ソースファイルの配置に関する決まり事
-マニュアルページのソースコードの 1行の長さは
-可能な限り 75文字を越えないようにしてほしい。
-こうすることで、パッチをメール本文に載せて送る場合に、
+マニュアルページのソースコードの 1行の長さは 可能な限り 75文字を越えないようにしてほしい。 こうすることで、パッチをメール本文に載せて送る場合に、
メールクライアントによる行折り返しを回避することができる。
-新しい文は行頭から開始する。
-これにより、パッチの内容を確認しやすくなる。
-パッチは文単位であることが多いからである。
+新しい文は行頭から開始する。 これにより、パッチの内容を確認しやすくなる。 パッチは文単位であることが多いからである。
.SS タイトル行
man ページの最初の行は \fBTH\fP コマンドにすべきである。
.RS
.sp
-.B \&.TH
-.I "title section date source manual"
+\fB\&.TH\fP \fItitle section date source manual\fP
.sp
.RE
個々の説明:
.RS
-.TP 10
-.I title
-man ページのタイトル。全部大文字で記載する (例:
-.IR MAN-PAGES )。
-.TP
-.I section
-man ページが属するセクション番号 (例:
-.IR 7 )。
-.TP
-.I date
-最新のリビジョンの日付\(emman ページに変更を加えたときには
-必ずこれを変更すること。
-これが最も一般的なバージョン管理方法である。
-日付は YYYY-MM-DD の形式で記載すべきである。
-.TP
-.I source
+.TP 10
+\fItitle\fP
+man ページのタイトル。全部大文字で記載する (例: \fIMAN\-PAGES\fP)。
+.TP
+\fIsection\fP
+man ページが属するセクション番号 (例: \fI7\fP)。
+.TP
+\fIdate\fP
+最新のリビジョンの日付\(emman ページに変更を加えたときには 必ずこれを変更すること。 これが最も一般的なバージョン管理方法である。 日付は
+YYYY\-MM\-DD の形式で記載すべきである。
+.TP
+\fIsource\fP
コマンド、関数、システムコールの出自。
-数少ないセクション 1 と 8 のページの場合、おそらく単に
-.I GNU
-とだけ書くことが多いだろう。
+数少ないセクション 1 と 8 のページの場合、おそらく単に \fIGNU\fP とだけ書くことが多いだろう。
-システムコールの場合、単に
-.I "Linux"
-とだけ書く。
-(以前の慣習では、マニュアルページを記載した/内容を確認したカーネルの
-バージョン番号を記載していた。しかし、バージョン番号が実際の内容と
-一致していることはなく、そのためバージョン番号がないよりも
-おそらく悪い形になっていた。
-今後は、バージョン番号を含めるのは避けること。)
+システムコールの場合、単に \fILinux\fP とだけ書く。 (以前の慣習では、マニュアルページを記載した/内容を確認したカーネルの
+バージョン番号を記載していた。しかし、バージョン番号が実際の内容と 一致していることはなく、そのためバージョン番号がないよりも
+おそらく悪い形になっていた。 今後は、バージョン番号を含めるのは避けること。)
-glibc のライブラリコールや
-その他の一般的な GNU ライブラリのライブラリコールの場合、
-単に
-.IR "GNU C Library" ", " GNU
+glibc のライブラリコールや その他の一般的な GNU ライブラリのライブラリコールの場合、 単に \fIGNU C Library\fP, \fIGNU\fP
と書くか、空の文字列を使う。
-セクション 4 のページでは
-.I "Linux"
-を使う。
+セクション 4 のページでは \fILinux\fP を使う。
-よくわからない場合は、
-.I Linux
-とか
-.I GNU
-と書いておく。
-.TP
-.I manual
-マニュアルのタイトル (例:
-\fIman-pages\fP パッケージのセクション 2 および 3 のページの場合には、
-.I "Linux Programmer's Manual"
-を使うこと)。
+よくわからない場合は、 \fILinux\fP とか \fIGNU\fP と書いておく。
+.TP
+\fImanual\fP
+マニュアルのタイトル (例: \fIman\-pages\fP パッケージのセクション 2 および 3 のページの場合には、 \fILinux
+Programmer's Manual\fP を使うこと)。
.RE
.SS マニュアルページのセクション
-昔から使われてきたセクション名を以下のリストに示す。
-これらを使うと良いだろう。
-一般的に、マニュアルページは、少なくとも
-.B 色つき
-のセクションを持つのが望ましい。
-新しくマニュアルページを作成する際には、だいたい以下のリストに示した
-順序でセクションを配置するようにしてもらいたい。
+昔から使われてきたセクション名を以下のリストに示す。 これらを使うと良いだろう。 一般的に、マニュアルページは、少なくとも \fB色つき\fP
+のセクションを持つのが望ましい。 新しくマニュアルページを作成する際には、だいたい以下のリストに示した 順序でセクションを配置するようにしてもらいたい。
.in +0.5i
.nf
+.\" May 07: Few current man pages have an ERROR HANDLING section,,,
+.\" ERROR HANDLING,
+.\" May 07: Almost no current man pages have a USAGE section,,,
+.\" USAGE,
+.\" DIAGNOSTICS,
+.\" May 07: Almost no current man pages have a SECURITY section,,,
+.\" SECURITY,
+.\" AUTHORS sections are discouraged
+.\" AUTHORS [Discouraged]
\fB名前\fP
\fB書式\fP
設定 [通常はセクション 4 のみ]
オプション [通常はセクション 1, 8 のみ]
終了ステータス [通常はセクション 1, 8 のみ]
返り値 [通常はセクション 2, 3 のみ]
-.\" May 07: Few current man pages have an ERROR HANDLING section,,,
-.\" エラー処理
エラー [たいていはセクション 2, 3 のみ]
-.\" May 07: Almost no current man pages have a USAGE section,,,
-.\" 利用法
-.\" 診断メッセージ
-.\" May 07: Almost no current man pages have a SECURITY section,,,
-.\" セキュリティ
環境変数
ファイル
バージョン [通常はセクション 2, 3 のみ]
注意/備考
バグ
例
-.\" 著者 セクションは非推奨である
-.\" 著者
\fB関連項目\fP
.fi
.in
-「伝統的に使われてきた見出しが使える場合には、それを使ってほしい。」
-この種の一貫性を保つことで、情報を理解しやすくなるからである。
-どうしても必要な場合には、理解しやすくなるように独自の見出しを
-作ってもよい (特にセクション 4 や 5 のページではこうした方が
-わかりやすくなる)。ただし、そうする前に、伝統的な見出しを使い、
-そのセクション内にサブセクション (\fI.SS\fP) を設けることで
+「伝統的に使われてきた見出しが使える場合には、それを使ってほしい。」 この種の一貫性を保つことで、情報を理解しやすくなるからである。
+どうしても必要な場合には、理解しやすくなるように独自の見出しを 作ってもよい (特にセクション 4 や 5 のページではこうした方が
+わかりやすくなる)。ただし、そうする前に、伝統的な見出しを使い、 そのセクション内にサブセクション (\fI.SS\fP) を設けることで
対応できないか考えてほしい。
-以下のリストでは、上記のセクションのそれぞれの内容について
-詳しく説明する。
-.TP 14
-.B 名前 (NAME)
-そのマニュアルページの名前。
-\fB.SH NAME\fP コマンドの行が従うべき大事な点については
-.BR man (7)
-を参照してほしい。
-.TP
-.B 書式 (SYNOPSIS)
-コマンドや関数のインターフェースを簡潔に記述する。
-コマンドに対しては、コマンドや引き数 (オプション) の文法を書く。
-そのまま書くテキストにはボールド体を用い、置き換える引き数には
-イタリック体を用いる。省略可能なオプションはブラケット ([]) で囲い、
-選択肢は縦棒 (|) で区切り、繰り返しには省略符号 (...) を書く。
-関数に対しては、必要なデータ宣言や
-.B #include
-指定を書き、関数宣言を続ける。
+以下のリストでは、上記のセクションのそれぞれの内容について 詳しく説明する。
+.TP 14
+\fB名前 (NAME)\fP
+そのマニュアルページの名前。 \fB.SH NAME\fP コマンドの行が従うべき大事な点については \fBman\fP(7) を参照してほしい。
+.TP
+\fB書式 (SYNOPSIS)\fP
+コマンドや関数のインターフェースを簡潔に記述する。 コマンドに対しては、コマンドや引き数 (オプション) の文法を書く。
+そのまま書くテキストにはボールド体を用い、置き換える引き数には イタリック体を用いる。省略可能なオプションはブラケット ([]) で囲い、 選択肢は縦棒
+(|) で区切り、繰り返しには省略符号 (...) を書く。 関数に対しては、必要なデータ宣言や \fB#include\fP 指定を書き、関数宣言を続ける。
-ヘッダファイルから関数 (や変数) の定義を得るために
-機能検査マクロ (feature test macro) を定義しなければならない場合、
-書式 (SYNOPSIS) に必要な機能検査マクロを記載すべきである。
-機能検査マクロについては
-.BR feature_test_macros (7)
-で説明されている。
.\" FIXME . Say something here about compiler options
-.TP
-.B CONFIGURATION
-デバイスの設定詳細。
-通常、このセクションは 4 章のマニュアルページでのみ登場する。
-.TP
-.B 説明 (DESCRIPTION)
-プログラム・関数・フォーマットの動作・目的を説明する。
-ファイルや標準入力をどのように処理し、標準出力や標準エラー出力を
-どのように生成するかといったことについて述べる。
-内部動作や実装の詳細については省略する
-(ただしそれが動作の理解にどうしても必要なら別)。
-通常の場合について記述する。
-プログラムのコマンドライン・オプションの説明には、
-.B オプション
-のセクションを用いる。
-.\" 入力にある種の文法があったり、複雑なサブコマンドがある場合は、
-.\" それらは
-.\" .B 利用法
-.\" のセクションに分離することを考えるとよい
-.\" .RB ( 説明
-.\" のセクションには概要だけを置くようにする)。
-.TP
-.B オプション (OPTIONS)
-プログラムが受け付けるコマンドライン・オプションと、
-その場合プログラムの振舞いがどう変わるかを説明する。
-このセクションはセクション 1 と 8 のマニュアルページにだけ登場すべきである。
+ヘッダファイルから関数 (や変数) の定義を得るために 機能検査マクロ (feature test macro) を定義しなければならない場合、 書式
+(SYNOPSIS) に必要な機能検査マクロを記載すべきである。 機能検査マクロについては \fBfeature_test_macros\fP(7)
+で説明されている。
+.TP
+\fBCONFIGURATION\fP
+デバイスの設定詳細。 通常、このセクションは 4 章のマニュアルページでのみ登場する。
+.TP
+\fB説明 (DESCRIPTION)\fP
+.\" If there is some kind of input grammar or complex set of subcommands,
+.\" consider describing them in a separate
+.\" .B USAGE
+.\" section (and just place an overview in the
+.\" .B DESCRIPTION
+.\" section).
+プログラム・関数・フォーマットの動作・目的を説明する。 ファイルや標準入力をどのように処理し、標準出力や標準エラー出力を
+どのように生成するかといったことについて述べる。 内部動作や実装の詳細については省略する (ただしそれが動作の理解にどうしても必要なら別)。
+通常の場合について記述する。 プログラムのコマンドライン・オプションの説明には、 \fBオプション\fP のセクションを用いる。
+.TP
+\fBオプション (OPTIONS)\fP
.\" .TP
-.\" .B 利用法 (USAGE)
-.\" コマンドなどが実装している副言語 (sublanguage) の文法を記述する。
-.TP
-.B 終了ステータス (EXIT STATUS)
-プログラムの終了ステータスの値と、それらの値に対応する状況を列挙する。
-このセクションはセクション 1 と 8 のマニュアルページにだけ登場すべきである。
-.TP
-.B 返り値 (RETURN VALUE)
-セクション 2 と 3 のページの場合、このセクションに
-ライブラリルーチンが呼び出し元に返す値のリストを記載する。
+.\" .B USAGE
+.\" describes the grammar of any sublanguage this implements.
+プログラムが受け付けるコマンドライン・オプションと、 その場合プログラムの振舞いがどう変わるかを説明する。 このセクションはセクション 1 と 8
+のマニュアルページにだけ登場すべきである。
+.TP
+\fB終了ステータス (EXIT STATUS)\fP
+プログラムの終了ステータスの値と、それらの値に対応する状況を列挙する。 このセクションはセクション 1 と 8
+のマニュアルページにだけ登場すべきである。
+.TP
+\fB返り値 (RETURN VALUE)\fP
+セクション 2 と 3 のページの場合、このセクションに ライブラリルーチンが呼び出し元に返す値のリストを記載する。
それらの値が返された場合の状態に対する説明も書く。
-.TP
-.B エラー (ERRORS)
-セクション 2 と 3 のマニュアルページでは、
-エラーが発生した場合に
-.I errno
-に設定される可能性がある値のリストを記載する。
-リストには、エラーの値とエラーの原因についての情報を書く。
-「エラーリストはアルファベット順にすべきである。」
-.TP
-.B 環境変数 (ENVIRONMENT)
+.TP
+\fBエラー (ERRORS)\fP
+セクション 2 と 3 のマニュアルページでは、 エラーが発生した場合に \fIerrno\fP に設定される可能性がある値のリストを記載する。
+リストには、エラーの値とエラーの原因についての情報を書く。 「エラーリストはアルファベット順にすべきである。」
+.TP
+\fB環境変数 (ENVIRONMENT)\fP
プログラムや関数に影響する環境変数をリストし、それらの効果を書く。
-.TP
-.B ファイル (FILES)
-プログラムや関数が用いるファイルを列記する。
-例えば、設定ファイル、起動ファイル、プログラムが直接操作するファイルなどである。
-これらのファイルのファイル名はフルパスで記載し、
-ディレクトリの部分はユーザーの好みに合わせて
-インストール処理で変更できるようにする。
-多くのプログラムではデフォルトのインストール先は
-.I /usr/local
-である。したがってベースとなるマニュアルページでも
-.I /usr/local
-が使われていることが多いだろう。
+.TP
+\fBファイル (FILES)\fP
.\" May 07: Almost no current man pages have a DIAGNOSTICS section;
.\" "RETURN VALUE" or "EXIT STATUS" is preferred.
.\" .TP
-.\" .B 診断メッセージ (DIAGNOSTICS)
-.\" ごく一般的なエラーメッセージの概要と、
-.\" それらをどう扱うかについて述べる。プログラムの実行時に現れる
-.\" システムエラーメッセージや致命的シグナルを全部説明する必要はない。
-.\" ただしそれらがプログラムに対して
-.\" 何らかの特殊な意味を持っている場合は別である。
+.\" .B DIAGNOSTICS
+.\" gives an overview of the most common error messages and how to
+.\" cope with them.
+.\" You don't need to explain system error messages
+.\" or fatal signals that can appear during execution of any program
+.\" unless they're special in some way to the program.
.\"
.\" May 07: Almost no current man pages have a SECURITY section.
.\".TP
-.\" .B セキュリティ (SECURITY)
-.\" セキュリティ関連の話題・問題について述べる。
-.\" 避けるべき設定や環境・セキュリティ上の問題を引き起こすコマンド
-.\" などについて警告する。それらが明らかでない場合には、これは特に重要である。
-.\" セキュリティに関する話題は、必ずしも独立したセクションにする必要はない。
-.\" もし理解しやすければ、セキュリティの情報は他のセクション
-.\" (例えば
-.\" .B 説明
-.\" や
-.\" .B 利用法
-.\" など) に書いてもよい。
-.\" しかし、セキュリティの情報はどこかには書いておいてほしい!
-.TP
-.B バージョン (VERSIONS)
-システムコールやライブラリ関数が登場したり、動作の重要な変更が行われた、
-Linux カーネルや glibc のバージョンについての簡潔な概要。
-一般に、全ての新しいインターフェイスは、マニュアルページに
-「バージョン」の節を設けるべきである。
-残念なことに、多くの既存のマニュアルページにこの情報は含まれていない
-(これらのページが書かれた時点ではそのようなポリシーはなかったからである)。
-これを改善するパッチは歓迎されるが、
-新しいコードを書くプログラマの観点からすれば、
-おそらくこの情報が重要になるのは、
-Linux 2.4 以降で追加されたカーネルインターフェイス (カーネル 2.2 からの変更) と
-glibc バージョン 2.1 以降で追加されたライブラリ関数 (glibc 2.0 からの変更)
-についてのみであろう。
+.\".B SECURITY
+.\"discusses security issues and implications.
+.\"Warn about configurations or environments that should be avoided,
+.\"commands that may have security implications, and so on, especially
+.\"if they aren't obvious.
+.\"Discussing security in a separate section isn't necessary;
+.\"if it's easier to understand, place security information in the
+.\"other sections (such as the
+.\" .B DESCRIPTION
+.\" or
+.\" .B USAGE
+.\" section).
+.\" However, please include security information somewhere!
+プログラムや関数が用いるファイルを列記する。 例えば、設定ファイル、起動ファイル、プログラムが直接操作するファイルなどである。
+これらのファイルのファイル名はフルパスで記載し、 ディレクトリの部分はユーザーの好みに合わせて インストール処理で変更できるようにする。
+多くのプログラムではデフォルトのインストール先は \fI/usr/local\fP である。したがってベースとなるマニュアルページでも
+\fI/usr/local\fP が使われていることが多いだろう。
+.TP
+\fBバージョン (VERSIONS)\fP
+システムコールやライブラリ関数が登場したり、動作の重要な変更が行われた、 Linux カーネルや glibc のバージョンについての簡潔な概要。
+一般に、全ての新しいインターフェイスは、マニュアルページに 「バージョン」の節を設けるべきである。
+残念なことに、多くの既存のマニュアルページにこの情報は含まれていない (これらのページが書かれた時点ではそのようなポリシーはなかったからである)。
+これを改善するパッチは歓迎されるが、 新しいコードを書くプログラマの観点からすれば、 おそらくこの情報が重要になるのは、 Linux 2.4
+以降で追加されたカーネルインターフェイス (カーネル 2.2 からの変更) と glibc バージョン 2.1 以降で追加されたライブラリ関数
+(glibc 2.0 からの変更) についてのみであろう。
-.BR syscalls (2)
-マニュアルページにも、いろいろなシステムコールが初めて登場した
-カーネルバージョンについての情報が書かれている。
-.TP
-.B 準拠 (CONFORMING TO)
-そのマニュアルページで説明している関数やコマンドに関連する
-標準規格や慣習について記載する。
-セクション 2 や 3 のページでは、このセクションで
-システムコールや関数が準拠する POSIX.1 のバージョンと、
-C99 で規定されているかに触れるべきである。
-(SUS, SUSv2, XPG などの他の標準規格や、SVr4 や 4.xBSD の実装標準に
-ついては、説明しているコールがこれらの規格で規定されており
-POSIX.1 の現行バージョンで規定されていない場合以外は、
-あまり深く気にする必要はない。)
-.RB ( standards (7)
-参照。)
+\fBsyscalls\fP(2) マニュアルページにも、いろいろなシステムコールが初めて登場した カーネルバージョンについての情報が書かれている。
+.TP
+\fB準拠 (CONFORMING TO)\fP
+そのマニュアルページで説明している関数やコマンドに関連する 標準規格や慣習について記載する。 セクション 2 や 3 のページでは、このセクションで
+システムコールや関数が準拠する POSIX.1 のバージョンと、 C99 で規定されているかに触れるべきである。 (SUS, SUSv2, XPG
+などの他の標準規格や、SVr4 や 4.xBSD の実装標準に ついては、説明しているコールがこれらの規格で規定されており POSIX.1
+の現行バージョンで規定されていない場合以外は、 あまり深く気にする必要はない。) (\fBstandards\fP(7) 参照。)
-そのコールがどの標準にも基づいていないが、
-他のシステムで広く存在する場合は、その旨を記載すること。
-そのコールが Linux 固有の場合は、その旨を記載すること。
+そのコールがどの標準にも基づいていないが、 他のシステムで広く存在する場合は、その旨を記載すること。 そのコールが Linux
+固有の場合は、その旨を記載すること。
-(そうなっているページが多いが) このセクションの内容が標準のリスト
-だけの場合、リストの最後にピリオド (\(aq.\(aq) を置くこと。
-.TP
-.B 注意 (NOTES)
-その他の注意点を書く。
-セクション 2 と 3 のマニュアルページでは、
-\fILinux での注意 (Linux Notes)\fP や \fIglibc での注意 (Glibc Notes)\fP
-という名前のサブセクション (\fBSS\fP) を設けると便利なこともある。
-.TP
-.B バグ (BUGS)
+(そうなっているページが多いが) このセクションの内容が標準のリスト だけの場合、リストの最後にピリオド (\(aq.\(aq) を置くこと。
+.TP
+\fB注意 (NOTES)\fP
+その他の注意点を書く。 セクション 2 と 3 のマニュアルページでは、 \fILinux での注意 (Linux Notes)\fP や \fIglibc
+での注意 (Glibc Notes)\fP という名前のサブセクション (\fBSS\fP) を設けると便利なこともある。
+.TP
+\fBバグ (BUGS)\fP
制限・知られている欠陥や不便な点、その他不思議な動作などを書く。
-.TP
-.B 例 (EXAMPLE)
-この関数・ファイル・コマンドをどのように使うかを示した
-ひとつまたは複数の例を記述する。
-サンプルプログラムを書く際の詳細は
+.TP
+\fB例 (EXAMPLE)\fP
+この関数・ファイル・コマンドをどのように使うかを示した ひとつまたは複数の例を記述する。 サンプルプログラムを書く際の詳細は
以下の「サンプルプログラム」の節を参照のこと。
-.TP
-.B 著者 (AUTHORS)
-文書またはプログラムの著者を列記する。
-.B 著者セクションは極力使用しないこと。
-一般的には、著者のリストを各ページに撒き散らさない方がよい
-(時間がたつと、作者のリストは膨大になる可能性がある)。
-マニュアルページを新規に書いたり、大幅に修正を行った場合には、
-ソースファイルにコメントとして著作権表示を追加すること。
-あなたがデバイスドライバの作者で、バグを報告するためのアドレスを
+.TP
+\fB著者 (AUTHORS)\fP
+文書またはプログラムの著者を列記する。 \fB著者セクションは極力使用しないこと。\fP 一般的には、著者のリストを各ページに撒き散らさない方がよい
+(時間がたつと、作者のリストは膨大になる可能性がある)。 マニュアルページを新規に書いたり、大幅に修正を行った場合には、
+ソースファイルにコメントとして著作権表示を追加すること。 あなたがデバイスドライバの作者で、バグを報告するためのアドレスを
載せたい場合は、「バグ」セクションの後ろにこのセクションを配置すること。
-.TP
-.B 関連項目 (SEE ALSO)
-関連するマニュアルページを、コンマ区切りのリストで、
-セクション番号順に、セクション内ではアルファベット順で記載する。
-可能なら関連する他の文書も書く。
-慣習では、このセクションは最後に置く。
-リストの末尾にピリオドを置かないこと。
+.TP
+\fB関連項目 (SEE ALSO)\fP
+関連するマニュアルページを、コンマ区切りのリストで、 セクション番号順に、セクション内ではアルファベット順で記載する。 可能なら関連する他の文書も書く。
+慣習では、このセクションは最後に置く。 リストの末尾にピリオドを置かないこと。
.SS フォントの慣習
.PP
-関数に対しては、引き数には常にイタリック体を用いる。
-「たとえ書式 (SYNOPSIS) セクションであっても、このルールに従う」
+関数に対しては、引き数には常にイタリック体を用いる。 「たとえ書式 (SYNOPSIS) セクションであっても、このルールに従う」
関数の他の部分はボールドを指定する:
.PP
-.BI " int myfunction(int " argc ", char **" argv );
+\fB int myfunction(int \fP\fIargc\fP\fB, char **\fP\fIargv\fP\fB);\fP
.PP
引き数名といった変数名はイタリック体を指定すべきである。
.PP
-ファイル名 (パス名、または
-.I /usr/include
-ディレクトリ内のファイルへの参照) は常にイタリック体にする (例:
-.IR <stdio.h> )。
-ただし、書式 (SYNOPSIS) セクションは例外で、
-インクルードファイルはボールドにする (例:
-.BR "#include <stdio.h>" )。
-.I /usr/include
-以下の標準のインクルードファイルを参照する際は、
-通常の C 言語と同様に山括弧でヘッダファイルを囲ぬで指定する (例：
-.IR <stdio.h> )。
+ファイル名 (パス名、または \fI/usr/include\fP ディレクトリ内のファイルへの参照) は常にイタリック体にする (例:
+\fI<stdio.h>\fP)。 ただし、書式 (SYNOPSIS) セクションは例外で、 インクルードファイルはボールドにする (例:
+\fB#include <stdio.h>\fP)。 \fI/usr/include\fP 以下の標準のインクルードファイルを参照する際は、 通常の
+C 言語と同様に山括弧でヘッダファイルを囲ぬで指定する (例： \fI<stdio.h>\fP)。
.PP
-通常、大文字で表現する特殊マクロはボールドで表す (例えば
-.BR MAXINT )。
-例外として NULL はボールドにしない。
+通常、大文字で表現する特殊マクロはボールドで表す (例えば \fBMAXINT\fP)。 例外として NULL はボールドにしない。
.PP
-エラーコードのリストを列挙する時には、コードはボールドで表す
-(このリストには通常
-.B \&.TP
-マクロを用いる)。
+エラーコードのリストを列挙する時には、コードはボールドで表す (このリストには通常 \fB\&.TP\fP マクロを用いる)。
.PP
-完全なコマンドは、長い場合には、例に示すように
-字下げした行にコマンドだけを記載すべきである。
+完全なコマンドは、長い場合には、例に示すように 字下げした行にコマンドだけを記載すべきである。
.in +4n
.nf
-man 7 man-pages
+man 7 man\-pages
.fi
.in
-コマンドが短い場合は、
-.I "man 7 man-pages"
-のようにイタリック体で文中に埋め込んで記載してもよい。
-この場合、コマンド内の適切な位置に、改行できないスペース ("\e\ ")
-を使うとよいかもしれない。
-コマンドオプションも
-.I \-l
+コマンドが短い場合は、 \fIman 7 man\-pages\fP のようにイタリック体で文中に埋め込んで記載してもよい。
+この場合、コマンド内の適切な位置に、改行できないスペース ("\e\ ") を使うとよいかもしれない。 コマンドオプションも \fI\-l\fP
のようにイタリック体で記載すべきである。
.PP
-式は、専用の字下げした行に記載しない場合、イタリック体を指定すること。
-繰り返しになるが、式を通常の文中に埋め込む場合にも、
+式は、専用の字下げした行に記載しない場合、イタリック体を指定すること。 繰り返しになるが、式を通常の文中に埋め込む場合にも、
改行できないスペースを使うとよいだろう。
.PP
-そのマニュアルページの説明対象への参照は、ボールドで名前を記載する。
-対象が関数 (つまり、セクション 2 や 3 のページ) の場合、
-名前の後ろにローマンフォント (通常のフォント) で丸括弧の対を続ける。
-例えば、
-.BR fcntl (2)
-のマニュアルページでは、説明対象への参照は
-.BR fcntl ()
-のように記載する。
-マニュアルページのソースファイルには次のように記載するのが望ましい:
+そのマニュアルページの説明対象への参照は、ボールドで名前を記載する。 対象が関数 (つまり、セクション 2 や 3 のページ) の場合、
+名前の後ろにローマンフォント (通常のフォント) で丸括弧の対を続ける。 例えば、 \fBfcntl\fP(2) のマニュアルページでは、説明対象への参照は
+\fBfcntl\fP() のように記載する。 マニュアルページのソースファイルには次のように記載するのが望ましい:
.nf
.BR fcntl ()
.fi
-("\\fB...\\fP()" よりも、この形式を使うこと。
-これにより、マニュアルページのソースファイルを解釈するツールを
-書くのが簡単になる。)
+("\efB...\efP()" よりも、この形式を使うこと。 これにより、マニュアルページのソースファイルを解釈するツールを 書くのが簡単になる。)
.PP
-別のマニュアルページへの参照は、ボールドで名前を記載し、
-それに続けてセクション番号を「必ず」書く。セクション番号は
-ローマンフォント (通常のフォント) で書き、スペースは入れない
-(例:
-.BR intro (2))。
-マニュアルページのソースファイルには次のように記載するのが望ましい:
+別のマニュアルページへの参照は、ボールドで名前を記載し、 それに続けてセクション番号を「必ず」書く。セクション番号は ローマンフォント
+(通常のフォント) で書き、スペースは入れない (例: \fBintro\fP(2))。 マニュアルページのソースファイルには次のように記載するのが望ましい:
.nf
.BR intro (2)
.fi
-(相互参照にセクション番号を含めておくと、
-.B man2html
-といったツールがページ間のハイパーリンクを適切に生成できる。)
-.SS 綴り (spelling)
-リリース 2.59 からだが、
-.I man-pages
-はアメリカ英語の綴りの慣習に従っている。
-新しいページやパッチは全てこの慣習に従って下さい。
+(相互参照にセクション番号を含めておくと、 \fBman2html\fP といったツールがページ間のハイパーリンクを適切に生成できる。)
+.SS "綴り (spelling)"
+リリース 2.59 からだが、 \fIman\-pages\fP はアメリカ英語の綴りの慣習に従っている。 新しいページやパッチは全てこの慣習に従って下さい。
.SS サンプルプログラムとシェルのセッション
-マニュアルページには、システムコールやライブラリ関数の使い方を示す
-サンプルプログラムを含めることができる。
-その際には、以下の点に留意すべきである。
-.TP 3
+マニュアルページには、システムコールやライブラリ関数の使い方を示す サンプルプログラムを含めることができる。 その際には、以下の点に留意すべきである。
+.TP 3
*
サンプルプログラムは C で記載すること。
-.TP
+.TP
*
-サンプルプログラムは、
-インタフェースについて文章で簡単に説明できる以上のことを示す場合にだけ
-必要かつ有用である。インタフェースを呼び出す以外に何もしないサンプル
-プログラムは普通はほとんど役に立たない。
-.TP
+サンプルプログラムは、 インタフェースについて文章で簡単に説明できる以上のことを示す場合にだけ
+必要かつ有用である。インタフェースを呼び出す以外に何もしないサンプル プログラムは普通はほとんど役に立たない。
+.TP
*
-サンプルプログラムはかなり短めにすること
-(100行未満が望ましく、50行未満が理想的である)。
-.TP
+サンプルプログラムはかなり短めにすること (100行未満が望ましく、50行未満が理想的である)。
+.TP
*
-サンプルプログラムでは、システムコールやライブラリ関数を呼び出した後で
-エラーチェックを行うこと。
-.TP
+サンプルプログラムでは、システムコールやライブラリ関数を呼び出した後で エラーチェックを行うこと。
+.TP
*
-サンプルプログラムは完結していて、
-\fIcc\ \-Wall\fP
-でコンパイルした際に警告なしでコンパイルできること。
-.TP
+サンプルプログラムは完結していて、 \fIcc\ \-Wall\fP でコンパイルした際に警告なしでコンパイルできること。
+.TP
*
-可能かつ適切な場合には、サンプルプログラムで
-入力により動作を変化させるなどの実験を行うとよい
-(理想的には、コマンドライン引き数や、プログラムが読み込む入力データ
-経由で、動作を変化させるのがよい)。
-.TP
+可能かつ適切な場合には、サンプルプログラムで 入力により動作を変化させるなどの実験を行うとよい
+(理想的には、コマンドライン引き数や、プログラムが読み込む入力データ 経由で、動作を変化させるのがよい)。
+.TP
*
-サンプルプログラムは、K&R (Kernighan and Ritchie) スタイルで書き、
-字下げはスペース 4文字で行う。
-(ソースコードで TAB 文字を使うのは避けること。)
+サンプルプログラムは、K&R (Kernighan and Ritchie) スタイルで書き、 字下げはスペース 4文字で行う。 (ソースコードで
+TAB 文字を使うのは避けること。)
.PP
-サンプルプログラムがどんな風になっていればよいかの例については、
-.BR wait (2)
-と
-.BR pipe (2)
-を参照すること。
+サンプルプログラムがどんな風になっていればよいかの例については、 \fBwait\fP(2) と \fBpipe\fP(2) を参照すること。
-プログラムの使い方や他のシステムの特徴を示すためにシェルのセッション例
-を含める場合、ユーザの入力文をボールドにして、システムが生成する
+プログラムの使い方や他のシステムの特徴を示すためにシェルのセッション例 を含める場合、ユーザの入力文をボールドにして、システムが生成する
出力と区別できるようにすること。
.SS 構造体の定義、シェルのセッションログなどの字下げ
-構造体の定義やシェルのセッションログなどを本文中に記載する際は、
-スペース 4個分の字下げを行う (つまり、ブロックを
-.I ".in\ +4n"
-と
-.I ".in"
-で囲む)。
+構造体の定義やシェルのセッションログなどを本文中に記載する際は、 スペース 4個分の字下げを行う (つまり、ブロックを \fI.in\ +4n\fP と
+\&\fI.in\fP で囲む)。
.SH 例
-.I man-pages
-パッケージに含まれるマニュアルページの体裁の標準的な例については、
-.BR pipe (2)
-と
-.BR fcntl (2)
+\fIman\-pages\fP パッケージに含まれるマニュアルページの体裁の標準的な例については、 \fBpipe\fP(2) と \fBfcntl\fP(2)
を参照すること。
.SH 関連項目
-.BR man (1),
-.BR man2html (1),
-.BR groff (7),
-.BR groff_man (7),
-.BR man (7),
-.BR mdoc (7)
+\fBman\fP(1), \fBman2html\fP(1), \fBgroff\fP(7), \fBgroff_man\fP(7), \fBman\fP(7),
+\fBmdoc\fP(7)
OSDN Git Service
