OSDN Git Service

(split) LDP: Update the version to 3.53 in PO files
[linuxjm/LDP_man-pages.git] / draft / man7 / man-pages.7
index 04173d3..bb6c3bf 100644 (file)
@@ -32,7 +32,7 @@
 .\" 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 書式
@@ -194,6 +194,21 @@ Programmer's Manual\fP を使うこと)。
 プログラム・関数・フォーマットの動作・目的を説明する。 ファイルや標準入力をどのように処理し、標準出力や標準エラー出力を
 どのように生成するかといったことについて述べる。 内部動作や実装の詳細については省略する (ただしそれが動作の理解にどうしても必要なら別)。
 通常の場合について記述する。 プログラムのコマンドライン・オプションの説明には、 \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
@@ -408,6 +423,6 @@ TAB 文字を使うのは避けること。)
 \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/ に書かれている。