.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
-.TH MAN\-PAGES 7 2013\-06\-21 Linux "Linux Programmer's Manual"
+.TH MAN\-PAGES 7 2013\-07\-24 Linux "Linux Programmer's Manual"
.SH 名前
man\-pages \- Linux の man ページを書く際の決まり事
.SH 書式
.\" SECURITY,
.\" AUTHORS sections are discouraged
.\" AUTHORS [Discouraged]
-\fBNAME\fP
-\fBSYNOPSIS\fP
-CONFIGURATION [Normally only in Section 4]
-\fBDESCRIPTION\fP
-OPTIONS [Normally only in Sections 1, 8]
-EXIT STATUS [Normally only in Sections 1, 8]
-RETURN VALUE [Normally only in Sections 2, 3]
-ERRORS [Typically only in Sections 2, 3]
-ENVIRONMENT
-FILES
-ATTRIBUTES [Normally only in Sections 2, 3]
-VERSIONS [Normally only in Sections 2, 3]
-CONFORMING TO
-NOTES
-BUGS
-EXAMPLE
-\fBSEE ALSO\fP
+\fB名前\fP
+\fB書式\fP
+設定 [通常はセクション 4 のみ]
+\fB説明\fP
+オプション [通常はセクション 1, 8 のみ]
+終了ステータス [通常はセクション 1, 8 のみ]
+返り値 [通常はセクション 2, 3 のみ]
+エラー [たいていはセクション 2, 3 のみ]
+環境変数
+ファイル
+属性 [通常はセクション 2, 3 のみ]
+バージョン [通常はセクション 2, 3 のみ]
+準拠
+注意/備考
+バグ
+例
+\fB関連項目\fP
.fi
.in
プログラム・関数・フォーマットの動作・目的を説明する。 ファイルや標準入力をどのように処理し、標準出力や標準エラー出力を
どのように生成するかといったことについて述べる。 内部動作や実装の詳細については省略する (ただしそれが動作の理解にどうしても必要なら別)。
通常の場合について記述する。 プログラムのコマンドライン・オプションの説明には、 \fBオプション\fP のセクションを用いる。
+
+When describing new behavior or new flags for a system call or library
+function, be careful to note the kernel or C library version that introduced
+the change. The preferred method of noting this information for flags is as
+part of a \fB.TP\fP list, in the following form (here, for a new system call
+flag):
+.RS 22
+.TP
+ \fBXYZ_FLAG\fP (since Linux 3.7)
+Description of flag...
+.RE
+.IP
+Including version information is especially useful to users who are
+constrained to using older kernel or C library versions (which is typical in
+embedded systems, for example).
.TP
\fBオプション (OPTIONS)\fP
.\" .TP
\fI/usr/local\fP が使われていることが多いだろう。
.TP
\fB属性 (ATTRIBUTES)\fP
-A summary of various attributes of the function(s) documented on this page,
-broken into subsections. The following subsections are defined:
+そのページで説明している関数の種々の属性の概要を、サブセクションに分けて説明する。以下のサブセクションが定義されている。
.sp
.RS
.TP
\fBマルチスレッディング (pthreads(7) 参照)\fP
-This subsection notes attributes relating to multithreaded applications:
+このサブセクションでは、マルチスレッドアプリケーションに関連する属性について説明する。
.RS
.IP * 3
-Whether the function is thread\-safe.
+その関数がスレッドセーフかどうか。
.IP *
-Whether the function is a cancellation point.
+その関数が取り消しポイント (cancellation point) かどうか。
.IP *
-Whether the function is async\-cancel\-safe.
+その関数が非同期で安全にキャンセルできるか (async\-cancel\-safe かどうか)。
.RE
.IP
-Details of these attributes can be found in \fBpthreads\fP(7).
+これらの属性の詳細は \fBpthreads\fP(7) で説明されている。
.RE
.TP
\fBバージョン (VERSIONS)\fP
\fBman\fP(1), \fBman2html\fP(1), \fBgroff\fP(7), \fBgroff_man\fP(7), \fBman\fP(7),
\fBmdoc\fP(7)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。