d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
e383ec74e5
freebsd-dev/usr.bin/random/random.6

121 lines
3.9 KiB
Groff
Raw Normal View History

Bring in the 4.4 Lite games directory, modulo man page changes and segregation of the x11 based games. I'm not going to tag the originals with bsd_44_lite and do this in two stages since it's just not worth it for this collection, and I've got directory renames to deal with that way. Bleah. Submitted by: jkh
1994-09-04 04:03:31 +00:00
.\" Copyright (c) 1994
.\" The Regents of the University of California. All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
Drop advertising clause in manpages. It was done a long time ago for the source code. Discussed with: core
2010-12-06 19:12:51 +00:00
.\" 3. Neither the name of the University nor the names of its contributors
Bring in the 4.4 Lite games directory, modulo man page changes and segregation of the x11 based games. I'm not going to tag the originals with bsd_44_lite and do this in two stages since it's just not worth it for this collection, and I've got directory renames to deal with that way. Bleah. Submitted by: jkh
1994-09-04 04:03:31 +00:00
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" @(#)random.6 8.2 (Berkeley) 3/31/94
$Id$ -> $FreeBSD$
1999-08-27 23:37:10 +00:00
.\" $FreeBSD$
Bring in the 4.4 Lite games directory, modulo man page changes and segregation of the x11 based games. I'm not going to tag the originals with bsd_44_lite and do this in two stages since it's just not worth it for this collection, and I've got directory renames to deal with that way. Bleah. Submitted by: jkh
1994-09-04 04:03:31 +00:00
.\"
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
.Dd February 15, 2020
Bring in the 4.4 Lite games directory, modulo man page changes and segregation of the x11 based games. I'm not going to tag the originals with bsd_44_lite and do this in two stages since it's just not worth it for this collection, and I've got directory renames to deal with that way. Bleah. Submitted by: jkh
1994-09-04 04:03:31 +00:00
.Dt RANDOM 6
mdoc(7) police: removed HISTORY info from the .Os call.
2001-07-10 10:42:19 +00:00
.Os
Bring in the 4.4 Lite games directory, modulo man page changes and segregation of the x11 based games. I'm not going to tag the originals with bsd_44_lite and do this in two stages since it's just not worth it for this collection, and I've got directory renames to deal with that way. Bleah. Submitted by: jkh
1994-09-04 04:03:31 +00:00
.Sh NAME
.Nm random
.Nd random lines from a file or random numbers
.Sh SYNOPSIS
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 12:06:19 +00:00
.Nm
Fixed SYNOPSIS. Expanded stdin/stdout definitions. Ordered the SEE ALSO references. Moved some chat from the BUGS section to freebsd-chat@. Removed ``cvs log'' material from the HISTORY section.
2003-02-23 01:44:14 +00:00
.Op Fl elrUuw
Update random(6) to have the ability to randomize a file/stdin based off of lines or words. See the man page for details. Reviewed by: markm MFC after: 3 days
2003-02-11 19:32:18 +00:00
.Op Fl f Ar filename
Bring in the 4.4 Lite games directory, modulo man page changes and segregation of the x11 based games. I'm not going to tag the originals with bsd_44_lite and do this in two stages since it's just not worth it for this collection, and I've got directory renames to deal with that way. Bleah. Submitted by: jkh
1994-09-04 04:03:31 +00:00
.Op Ar denominator
.Sh DESCRIPTION
.Nm Random
Fixed SYNOPSIS. Expanded stdin/stdout definitions. Ordered the SEE ALSO references. Moved some chat from the BUGS section to freebsd-chat@. Removed ``cvs log'' material from the HISTORY section.
2003-02-23 01:44:14 +00:00
has two distinct modes of operations.
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
The default is to read lines from standard input and write them to standard
output with a probability of 1.0 /
Update random(6) to have the ability to randomize a file/stdin based off of lines or words. See the man page for details. Reviewed by: markm MFC after: 3 days
2003-02-11 19:32:18 +00:00
.Ar denominator .
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
.Ar ( denominator
is a real number greater than or equal to 1.0.)
Update random(6) to have the ability to randomize a file/stdin based off of lines or words. See the man page for details. Reviewed by: markm MFC after: 3 days
2003-02-11 19:32:18 +00:00
The default
Bring in the 4.4 Lite games directory, modulo man page changes and segregation of the x11 based games. I'm not going to tag the originals with bsd_44_lite and do this in two stages since it's just not worth it for this collection, and I've got directory renames to deal with that way. Bleah. Submitted by: jkh
1994-09-04 04:03:31 +00:00
.Ar denominator
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
for this mode of operation is 2.0, giving each line a 50% chance of
Update random(6) to have the ability to randomize a file/stdin based off of lines or words. See the man page for details. Reviewed by: markm MFC after: 3 days
2003-02-11 19:32:18 +00:00
being displayed.
.Pp
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
The second mode of operation, selected with the
.Fl f Ar filename
option, reads the specified file and outputs the randomized contents to
Fixed SYNOPSIS. Expanded stdin/stdout definitions. Ordered the SEE ALSO references. Moved some chat from the BUGS section to freebsd-chat@. Removed ``cvs log'' material from the HISTORY section.
2003-02-23 01:44:14 +00:00
standard output.
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
The contents can be randomized in units of lines (split on newline characters)
or in units of words (split on space characters as determined by
.Xr isspace 3 . )
Update random(6) to have the ability to randomize a file/stdin based off of lines or words. See the man page for details. Reviewed by: markm MFC after: 3 days
2003-02-11 19:32:18 +00:00
The default
.Ar denominator
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
for this mode of operation is 1.0, which displays every line.
Bring in the 4.4 Lite games directory, modulo man page changes and segregation of the x11 based games. I'm not going to tag the originals with bsd_44_lite and do this in two stages since it's just not worth it for this collection, and I've got directory renames to deal with that way. Bleah. Submitted by: jkh
1994-09-04 04:03:31 +00:00
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl e
If the
.Fl e
option is specified,
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 12:06:19 +00:00
.Nm
Bring in the 4.4 Lite games directory, modulo man page changes and segregation of the x11 based games. I'm not going to tag the originals with bsd_44_lite and do this in two stages since it's just not worth it for this collection, and I've got directory renames to deal with that way. Bleah. Submitted by: jkh
1994-09-04 04:03:31 +00:00
does not read or write anything, and simply exits with a random
exit value of 0 to
.Ar denominator
\&- 1, inclusive.
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
In this mode,
.Ar denominator
must be less than or equal to 256.
Update random(6) to have the ability to randomize a file/stdin based off of lines or words. See the man page for details. Reviewed by: markm MFC after: 3 days
2003-02-11 19:32:18 +00:00
.It Fl f Ar filename
The
.Fl f
option is used to specify the
.Ar filename
Fixed SYNOPSIS. Expanded stdin/stdout definitions. Ordered the SEE ALSO references. Moved some chat from the BUGS section to freebsd-chat@. Removed ``cvs log'' material from the HISTORY section.
2003-02-23 01:44:14 +00:00
to read from.
Standard input is used if
.Ar filename
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
is
.Sq - .
Update random(6) to have the ability to randomize a file/stdin based off of lines or words. See the man page for details. Reviewed by: markm MFC after: 3 days
2003-02-11 19:32:18 +00:00
.It Fl l
Randomize the input via newlines (the default).
Bring in the 4.4 Lite games directory, modulo man page changes and segregation of the x11 based games. I'm not going to tag the originals with bsd_44_lite and do this in two stages since it's just not worth it for this collection, and I've got directory renames to deal with that way. Bleah. Submitted by: jkh
1994-09-04 04:03:31 +00:00
.It Fl r
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
Do not buffer output.
Fixed SYNOPSIS. Expanded stdin/stdout definitions. Ordered the SEE ALSO references. Moved some chat from the BUGS section to freebsd-chat@. Removed ``cvs log'' material from the HISTORY section.
2003-02-23 01:44:14 +00:00
.It Fl U
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
Reuse any given line or word when creating a randomized output.
Update random(6) to have the ability to randomize a file/stdin based off of lines or words. See the man page for details. Reviewed by: markm MFC after: 3 days
2003-02-11 19:32:18 +00:00
.It Fl u
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
Do not select the same line or word from a file more than once (the default).
Fixed SYNOPSIS. Expanded stdin/stdout definitions. Ordered the SEE ALSO references. Moved some chat from the BUGS section to freebsd-chat@. Removed ``cvs log'' material from the HISTORY section.
2003-02-23 01:44:14 +00:00
This does not guarantee uniqueness if there are two of the
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
same tokens in the input.
Update random(6) to have the ability to randomize a file/stdin based off of lines or words. See the man page for details. Reviewed by: markm MFC after: 3 days
2003-02-11 19:32:18 +00:00
.It Fl w
Randomize words separated by
.Xr isspace 3
instead of newlines.
Bring in the 4.4 Lite games directory, modulo man page changes and segregation of the x11 based games. I'm not going to tag the originals with bsd_44_lite and do this in two stages since it's just not worth it for this collection, and I've got directory renames to deal with that way. Bleah. Submitted by: jkh
1994-09-04 04:03:31 +00:00
.El
.Sh SEE ALSO
Fixed SYNOPSIS. Expanded stdin/stdout definitions. Ordered the SEE ALSO references. Moved some chat from the BUGS section to freebsd-chat@. Removed ``cvs log'' material from the HISTORY section.
2003-02-23 01:44:14 +00:00
.Xr fortune 6
Sort sections.
2005-01-18 08:57:18 +00:00
.Sh HISTORY
The
functionality to randomizing lines and words was added in 2003 by
use .Mt to mark up email addresses consistently (part1) PR: 191174 Submitted by: Franco Fichtner <franco@lastsummer.de>
2014-06-20 09:40:43 +00:00
.An Sean Chittenden Aq Mt seanc@FreeBSD.org .
Update random(6) to have the ability to randomize a file/stdin based off of lines or words. See the man page for details. Reviewed by: markm MFC after: 3 days
2003-02-11 19:32:18 +00:00
.Sh BUGS
random(6): Re-add undocumented support for floating point denominators And document it in the manual page. PR: 244139 Submitted by: Keith White <kwhite AT site.uottawa.ca> (earlier version)
2020-02-15 19:13:37 +00:00
This tool is a remnant of the "games" collection formerly part of
.Fx
base.
It probably should have been removed to ports with the rest of that collection.
It does not have a coherent purpose and the motivation for it to be a core base
utility is nonobvious.
.Pp
Fixed SYNOPSIS. Expanded stdin/stdout definitions. Ordered the SEE ALSO references. Moved some chat from the BUGS section to freebsd-chat@. Removed ``cvs log'' material from the HISTORY section.
2003-02-23 01:44:14 +00:00
No index is used when printing out tokens from the list which
makes it rather slow for large files (10MB+).
Reference in New Issue Copy Permalink