1 files changed, 113 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/pamseq.1 b/upstream/debian-bookworm/man1/pamseq.1
new file mode 100644
index 00000000..c82d4509
--- /dev/null
+++ b/upstream/debian-bookworm/man1/pamseq.1
@@ -0,0 +1,113 @@
+\
+.\" 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 "Pamseq User Manual" 1 "08 May 2002" "netpbm documentation"
+
+
+.SH NAME
+
+pamseq - generate PAM image of all possible tuple values, in sequence
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpamseq\fP
+[\fB-tupletype=\fP\fItupletype\fP]
+\fIdepth\fP
+\fImaxval\fP
+.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 an equals sign between an option name and its
+value.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpamseq\fP generates a PAM image of a specified depth and specified
+maxval that consists of a single row.  The row consists of one tuple of
+every possible value, in order.
+.PP
+For a depth of one, the order is simple: From 0 to maxval, going from
+left to right.  For higher depths, the highest numbered plane goes from
+0 to maxval (going left to right) while all the other planes have value 0.
+Then the sequence repeats except with the next highest plane set to a value
+of 1, then 2, etc.
+
+.UN options
+.SH OPTIONS
+.PP
+In addition to the options common to all programs based on libnetpbm
+(most notably \fB-quiet\fP, see 
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&), \fBpamseq\fP recognizes the following
+command line option:
+
+
+.TP
+\fB-tupletype\fP
+This is the value of the "tuple_type" attribute of the created PAM image.
+It can be any string up to 255 characters.
+
+
+.UN usage
+.SH USAGE
+.PP
+To create a simple ramp of the values 0..255, for input to various matrix
+calculations, try
+.nf
+\f(CW
+  pamseq 1 255 
+\fP
+
+.fi
+(Before \fBpamseq\fP existed, \fBpgmramp\fP was often pressed into service
+for this).
+.PP
+To create a PPM color map of all the possible colors representable with a
+maxval of 5, do
+.nf
+\f(CW
+  pamseq 3 5 -tupletype=RGB | pamtopnm
+\fP
+
+.fi
+
+Again, with a modern program based on the Netpbm library, you don't need
+the \fBpamtopnm\fP because a PAM RGB image is equivalent to a PPM image.
+.PP
+You can use such a color map with
+.BR "pnmremap" (1)\c
+\& to quantize the colors in an
+image.  With the maxval of 5 given in the example, you get a color map
+of the set of "web safe" colors as defined by Netscape.  Most web
+browsers guarantee that they can produce at least these 216 colors
+(215 plus black).
+
+.UN seealso
+.SH SEE ALSO
+.BR "pnmremap" (1)\c
+\&,
+.BR "pamtopnm" (1)\c
+\&,
+.BR "pam" (1)\c
+\&
+
+.UN history
+.SH HISTORY
+
+\fBpamseq\fP was added to Netpbm in June 2002.
+.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/pamseq.html
+.PP
+\ No newline at end of file