[src/trunk]: src/lib/libc/gen Fix Nd; use In instead of Fd; grammar fixes.

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/5383b8987352
branches:  trunk
changeset: 551676:5383b8987352
user:      wiz <wiz%NetBSD.org@localhost>
date:      Wed Sep 10 09:16:45 2003 +0000

description:
Fix Nd; use In instead of Fd; grammar fixes.

diffstat:

 lib/libc/gen/randomid.3 |  31 +++++++++++++++----------------
 1 files changed, 15 insertions(+), 16 deletions(-)

diffs (90 lines):

diff -r e0ce3b58ca93 -r 5383b8987352 lib/libc/gen/randomid.3
--- a/lib/libc/gen/randomid.3   Wed Sep 10 08:44:31 2003 +0000
+++ b/lib/libc/gen/randomid.3   Wed Sep 10 09:16:45 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: randomid.3,v 1.1 2003/09/09 22:10:34 itojun Exp $
+.\"    $NetBSD: randomid.3,v 1.2 2003/09/10 09:16:45 wiz Exp $
 .\"
 .\" Copyright (C) 2003 WIDE Project.
 .\" All rights reserved.
@@ -34,10 +34,10 @@
 .Nm randomid
 .Nm randomid_new ,
 .Nm randomid_delete ,
-.Nd make a copy of a struct passwd
+.Nd provide pseudo-random data stream without repetitions
 .Sh SYNOPSIS
-.Fd #include <sys/types.h>
-.Fd #include <randomid.h>
+.In sys/types.h
+.In randomid.h
 .Ft u_int32_t
 .Fn randomid "randomid_t ctx"
 .Ft randomid_t
@@ -53,30 +53,29 @@
 .Fa ctx
 is the context which holds internal state for the random number generator.
 .Pp
-To initialize context
+To initialize a context,
 .Fa randomid_new
 is used.
 .Fa bits
-specifies the bitwidth of value generated by
+specifies the bitwidth of the value generated by
 .Fn randomid .
-Currently 32, 20 and 16 are supported.
+Currently 32, 20, and 16 are supported.
 .Fa timeo
-specifies reinitialization interval in seconds.
+specifies the reinitialization interval in seconds.
 .Fa timeo
 has to be bigger than
 .Dv RANDOMID_TIMEO_MIN .
-Return value of
 .Fa randomid_new
-is a dynamically-allocated memory region allocated by
+returns a dynamically-allocated memory region allocated by
 .Xr malloc 3 .
 .Pp
 .Fn randomid_delete
 will
 .Xr free 3
-the internal state,
+the internal state
 .Fa ctx .
 .Pp
-Same number may appear after two reinitialization events of the internal state,
+The same number may appear after two reinitialization events of the internal state,
 .Fa ctx .
 Reinitialization happens when the random number generator cycle is exhausted,
 or
@@ -92,7 +91,7 @@
 .Fa timeo
 seconds
 .Pc ,
-therefore same data will not appear until after 36000 calls to
+therefore the same data will not appear until after 36000 calls to
 .Fn randomid
 .Po
 or after 2 times
@@ -111,8 +110,8 @@
 .\"
 .Sh EXAMPLES
 .Bd -literal -offset indent
-#include <sys/types.h>
-#include <randomid.h>
+#include \*[Lt]sys/types.h\*[Gt]
+#include \*[Lt]randomid.h\*[Gt]
 
 u_int32_t
 genid(void)
@@ -129,7 +128,7 @@
 .Fn randomid_new
 returns
 .Dv NULL
-on error and set the external variable
+on error and sets the external variable
 .Va errno .
 .\"
 .Sh SEE ALSO