1 files changed, 135 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/ppmrainbow.1 b/upstream/debian-bookworm/man1/ppmrainbow.1
new file mode 100644
index 00000000..1fd51454
--- /dev/null
+++ b/upstream/debian-bookworm/man1/ppmrainbow.1
@@ -0,0 +1,135 @@
+\
+.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
+.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
+.\" the corresponding HTML page on the Netpbm website, generate a patch
+.\" against that, and send it to the Netpbm maintainer.
+.TH "Ppmrainbow User Manual" 1 "12 November 2014" "netpbm documentation"
+
+.SH NAME
+
+ppmrainbow - Generate a rainbow
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBppmrainbow\fP
+
+[\fB-width=\fP\fInumber\fP] [\fB-height=\fP\fInumber\fP]
+[\fB-tmpdir=\fP\fIdirectory\fP] [\fB-norepeat\fP] [\fB-verbose\fP] \fIcolor\fP ...
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+
+\fBppmrainbow\fP generates a PPM image that fades from one color to
+another to another from left to right, like a rainbow.
+.PP
+If you want a vertical or other non-horizontal rainbow, run the output
+through \fBpnmrotate\fP or \fBpamflip\fP.
+.PP
+One use for such a rainbow is to compose it with another image
+under a transparency mask in order to add a rainbow area to another image.
+In fact, you can make rainbow-colored text by using \fBpbmtext\fP,
+\fBpamcomp\fP, and \fBppmrainbow\fP.
+.PP
+\fBpgmramp\fP does a similar thing for grayscale images.
+.PP
+If you just want an image containing all the possible colors (for some
+kind of processing; not to look at), see \fBpamseq\fP.
+
+
+.UN arguments
+.SH ARGUMENTS
+.PP
+\fIcolor\fP ... is the list of colors, in order from left to right,
+to go into the rainbow.
+.PP
+The first color is added again on the right end of the image unless you
+specify the \fB-norepeat\fP option.  This means you can concatenate multiple
+copies (tile, as with \fBpnmtile\fP) to make a continuous larger image.
+.PP
+\fIcolor\fP is as described for
+the 
+.UR libnetpbm_image.html#colorname
+argument of the \fBpnm_parsecolor()\fP library routine
+.UE
+\&.
+
+
+.UN options
+.SH OPTIONS
+.PP
+All options can be abbreviated to their shortest unique prefix.
+You may use two hyphens instead of one to designate an option.  You
+may use either white space or equals signs between an option name and
+its value.
+
+
+.TP
+\fB-width \fP\fInumber\fP
+The width in pixels of the output image.
+.sp
+Default is 600.
+
+.TP
+\fB-height \fP\fInumber\fP
+The height in pixels of the output image.
+.sp
+Default is 8.
+
+.TP
+\fB-norepeat\fP
+     
+This option makes \fBppmrainbow\fP end the rainbow with the last
+color you specify.  Without this option, \fBppmrainbow\fP adds the
+first color you specify to the right end of the rainbow as if you had
+repeated it.
+
+.TP
+\fB-tmpdir\fP
+The directory specification of the directory \fBppmrainbow\fP is
+to use for temporary files.
+.sp
+Default is the value of the \fBTMPDIR\fP environment variable, or
+\fB/tmp\fP if \fBTMPDIR\fP is not set.
+.sp
+\fBppmrainbow\fP always creates a directory within this directory
+and creates all its files within that directory.
+
+.TP
+\fB-verbose\fP
+Print the "commands" (invocations of other Netpbm
+programs) that \fBppmrainbow\fP uses to create the image.
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pgmramp" (1)\c
+\&,
+.BR "pamseq" (1)\c
+\&,
+.BR "pamgradient" (1)\c
+\&,
+.BR "ppmmake" (1)\c
+\&,
+.BR "ppmfade" (1)\c
+\&,
+.BR "ppm" (1)\c
+\&.
+
+.UN author
+.SH AUTHOR
+.PP
+Arjen Bax wrote \fBppmrainbow\fP in June 2001 and contributed it
+to the Netpbm package.  Bryan Henderson wrote this manual in July
+2001.
+.SH DOCUMENT SOURCE
+This manual page was generated by the Netpbm tool 'makeman' from HTML
+source.  The master documentation is at
+.IP
+.B http://netpbm.sourceforge.net/doc/ppmrainbow.html
+.PP
+\ No newline at end of file