.TH LOLCAT 6 "February 21, 2013"
.\" Please adjust this date whenever revising the manpage.
.SH NAME
lolcat \- rainbow coloring for text

.SH SYNOPSIS
.B lolcat
.RI [ options ] " " [ files ] " " ...

.SH DESCRIPTION
This manual page documents briefly the
.B lolcat
command.
.PP
\fBlolcat\fP is a program that concatenates files, or standard input, to
standard output (like the generic \fBcat\fP), and adds rainbow coloring to it.

.SH OPTIONS

.TP
\fB\-p\fP \fIf\fP, \fB\-\-spread=\fIf\fP
Inclination of the rainbow stripes (character widths per line hight; high
values (>1000) give almost horizonal stripes, low values (0.1) almost vertical
ones; default: 3.0).
.TP
\fB\-F\fP \fIf\fP, \fB\-\-freq=\fIf\fP
Frequency of the rainbow (low values around 0.0001 give almost monochromous
screens; default: 0.1).
.TP
\fB\-S\fP \fIi\fP, \fB\-\-seed=\fIi\fP
Initial value for the random number generator; 0 means automatic (default: 0).
.TP
\fB\-a\fP, \fB\-\-animate\fP
Fade every line through an animation before printing the next one.
.TP
\fB\-d\fP \fIi\fP, \fB\-\-duration=\fIi\fP
Duration of the animation (number of steps before showing next line; default: 12)
.TP
\fB\-s\fP \fIi\fP, \fB\-\-speed=\fIi\fP
Speed of the animation (frame rate, ie. number of steps per second; default: 20)
.TP
\fB\-f\fP, \fB\-\-force\fP
Force color even when stdout is not a tty
.TP
.B \-v, \-\-version
Show version of lolcat.
.TP
.B \-h, \-\-help
Show summary of options.

.SH EXAMPLES

Typical combinations of \fBlolcat\fP include other programs that generate text:

Large colorful words can be written like this:

.IP
.EX
echo "KTHXBAI" | toilet | lolcat
.EE
.
.P

Cows are popular, come in all colors, and tell random epigrams:

.IP
.EX
fortune | cowsay | lolcat \-a
.EE
.
.P

.SH SEE ALSO
.BR cat (1),
.BR toilet (1),
.BR fortune (6),
.BR cowsay (6)
.br
.SH AUTHOR
lolcat was written by Moe <moe@busyloop.net>.
.PP
This manual page was written by chrysn <chrysn@fsfe.org>,
for the Debian project (and may be used by others).