date and time created 94/03/31 08:50:48 by bostic

SCCS-vsn: games/random/random.6 8.1

diff --git a/usr/src/games/random/random.6 b/usr/src/games/random/random.6
new file mode 100644 (file)
index 0000000..05e7be9
--- /dev/null
+++ b/usr/src/games/random/random.6
@@ -0,0 +1,43 @@
+.\" Copyright (c) 1994
+.\"    The Regents of the University of California.  All rights reserved.
+.\"
+.\" %sccs.include.redist.man%
+.\"
+.\"     @(#)random.6   8.1 (Berkeley) %G%
+.\"
+.Dd 
+.Dt RANDOM 6
+.Os BSD 4
+.Sh NAME
+.Nm random
+.Nd random lines from a file or random numbers
+.Sh SYNOPSIS
+.Nm random
+.Op Fl er
+.Op Ar number
+.Sh DESCRIPTION
+.Nm Random
+reads lines from the standard input and copies them to the standard
+output with a probability of 1/number.
+The default value for
+.Ar number
+is 2.
+.Pp
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl e
+If the
+.Fl e
+option is specified,
+.Nm random
+does not read or write anything, and simply exits with a random
+exit value of 0 to
+.Ar number
+\&- 1, inclusive.
+.It Fl r
+The
+.Fl r
+option guarantees that the output is unbuffered.
+.El
+.Sh SEE ALSO
+.Xr fortune 6