.\"                              hey, Emacs:   -*- nroff -*-
.\" rl is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; see the file COPYING.  If not, write to
.\" the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.TH RL 1 "March 2001"
.\" Please update the above date whenever this man page is modified.
.SH NAME
rl \- Select a random line from stdin or file.
.SH SYNOPSIS
.B rl
.RI [ OPTION ]...
.RI [ FILE ]...
.SH DESCRIPTION
\fBrl\fP reads lines from either stdin or any specified file and picks out one line at random per file and outputs it.
.PP
It does this with a single pass and a low memory footprint.
This is done by only storing the line to be returned.
.SH OPTIONS
\fBrl\fP accepts the following options:
.TP
.B \-c, \-\-count=N
Select the number of lines to output.
.TP
.B \-h, \-\-help
Show summary of options.
.TP
.B \-v, \-\-version
Show version of program.
.SH COPYRIGHT
Copyright \(co 2001 Arthur de Jong <arthur@ch.twi.tudelft.nl>.
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.