.\" Copyright (C) 1999-2001  bjk <bjk@arbornet.org>
.\"
.\" This program 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; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
.TH randtype 1 "randtype"

.SH NAME
randtype \- Output characters or lines at random intervals

.SH SYNOPSIS
.B randtype
[
.B \-l
] [
.B \-d ,|.<string> [ \-k ]
] [
.B \-t <ms,mult>
] [
.B \-w <string> [ \-c ms,mult ]
] [
.B \-r s1,s2[:...]
] [
.B \-n <string>
] [
.B \-q <int>
] [
.B \-m <int>
] [
.B file ...
]

.SH DESCRIPTION
.PP
.B randtype
reads input from either standard input or from a file and outputs each
character or line at random intervals. If multiple files are specified, each
is read in sequence.

.SH OPTIONS
.PP
.B randtype
recognizes the following command line options:
.TP
.B \-c ms,mult
For optional use with the \-w option, this has the same microsecond and
multiplier value format as the \-t option. The default for this option is
specified at compile time.
.TP
.B \-d string
Output everything before (left) or after (right) the specified string
immediately. The string must begin with either ',' or '.' which specifies the
direction, left or right, respectively.
.TP
.B \-h
Print a summary of the command line options and exit.
.TP
.B \-k
Suppress output of the string specified by the dump string option.
.TP
.B \-l
Output lines rather than characters. Only the \-t and \-q options are valid when
using this option, all other options are ignored.
.TP
.B \-m int
Generate random mistakes. The int value is how many times to compare and match
the next character and a randomly generated character.
.TP
.B \-n chars
Output the specified characters immediately with no random waiting.
.TP
.B \-r s1,s2[:...]
Replace the string s1 with string s2. You can specify multiple replacements by
separating them with a ':'.
.TP
.B \-q int
Quit the program after this many seconds.
.TP
.B \-t ms,mult
This option refines the random delay of output. The value of the argument is
separated by a comma with the first argument being a microsecond and the
second being a multiplier of a random number between 0 and the microsecond. A
character-per-second effect can, for example, be made by setting the
microsecond to 0 and the multiplier to 1000000. The default for this option is
specified at compile time.
.TP
.B \-v
Display version information and exit.
.TP
.B \-w chars
The inverse of the \-n option; this option waits on the specified
characters. Use the \-c option to refine the random delay of output.

.SH EXAMPLE
.PP
randtype \-t 13,16000 \-d ",*MAGIC*" \-k \-n '\naou' filename

.SH SEE ALSO
.PP
\fBrandom\fP(3), \fBsrandom\fP(3), \fBalarm\fP(2), \fBselect\fP(2)

.SH AUTHOR
.PP
This program was created by bjk <bjk@arbornet.org> and
released under the terms of the GNU General Public License version 2 or later.