(split) LDP: Update drafts based on LDP 3.52 release

[linuxjm/LDP_man-pages.git] / draft / man3 / random.3

diff --git a/draft/man3/random.3 b/draft/man3/random.3
index 4a29a5d..f32f750 100644 (file)
--- a/draft/man3/random.3
+++ b/draft/man3/random.3
@@ -35,7 +35,7 @@
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH RANDOM 3 2010\-09\-20 GNU "Linux Programmer's Manual"
+.TH RANDOM 3 2013\-04\-19 GNU "Linux Programmer's Manual"
 .SH 名前
 random, srandom, initstate, setstate \- 乱数を生成する関数
 .SH 書式
@@ -78,12 +78,21 @@ _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOP
 \fBinitstate\fP()  または \fBsetstate\fP()  が 次に呼び出されるまで、乱数の生成に使用される。 \fIstate\fP は
 \fBinitstate\fP()  を用いて最初に初期化されているか、 以前に呼び出した \fBsetstate\fP()  の結果でなければならない。
 .SH 返り値
-\fBrandom\fP()  関数は 0 と \fBRAND_MAX\fP の間の値を返す。 \fBsrandom\fP()  関数は値を返さない。
-\fBinitstate\fP()  関数は直前の状態配列へのポインタを返す。 \fBsetstate\fP()  関数は直前の状態配列へのポインタを返し、
-エラーの場合は NULL を返す。
+The \fBrandom\fP()  function returns a value between 0 and \fBRAND_MAX\fP.  The
+\fBsrandom\fP()  function returns no value.
+
+The \fBinitstate\fP()  function returns a pointer to the previous state array.
+On error, \fIerrno\fP is set to indicate the cause.
+
+On success, \fBsetstate\fP()  returns a pointer to the previous state array.
+On error, it returns NULL, with \fIerrno\fP set to indicate the cause of the
+error.
 .SH エラー
 .TP 
 \fBEINVAL\fP
+\fBsetstate\fP() の引き数 \fIstate\fP が NULL であった。
+.TP 
+\fBEINVAL\fP
 \fBinitstate\fP()  で8バイトよりも小さい状態配列を指定した。
 .SH 準拠
 4.3BSD, POSIX.1\-2001.
@@ -102,9 +111,14 @@ T. Vetterling; New York: Cambridge University Press, 2007, 3rd ed.)
 より理論的な議論については Donald E. Knuth の \fIThe Art of Computer Programming\fP, volume 2
 (Seminumerical Algorithms), 2nd ed.; Reading, Massachusetts: Addison\-Wesley
 Publishing Company, 1981 の第 3 章 (乱数) を見よ。ここでは、 たくさんの実用的な話題についても深く網羅されている。
+.SH バグ
+.\" http://sourceware.org/bugzilla/show_bug.cgi?id=15380
+According to POSIX, \fBinitstate\fP()  should return NULL on error.  In the
+glibc implementation, \fIerrno\fP is (as specified) set on error, but the
+function does not return NULL.
 .SH 関連項目
 \fBdrand48\fP(3), \fBrand\fP(3), \fBrandom_r\fP(3), \fBsrand\fP(3)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.51 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。