1 files changed, 138 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/pnmstitch.1 b/upstream/debian-bookworm/man1/pnmstitch.1
new file mode 100644
index 00000000..b0d8591c
--- /dev/null
+++ b/upstream/debian-bookworm/man1/pnmstitch.1
@@ -0,0 +1,138 @@
+\
+.\" 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 "Pnmstitch User Manual" 1 "July 2002" "netpbm documentation"
+
+.SH NAME
+pnmstitch - stitch together two panoramic (side-by-side) photographs
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpnmstitch\fP
+[
+[\fIleft_filespec\fP] \fIright_filespec\fP |
+\fIleft_filespec\fP \fIright_filespec\fP \fIoutput_filespec\fP
+]
+[\fB-width=\fP\fIwidth\fP]
+[\fB-height=\fP\fIheight\fP]
+[\fB-xrightpos=\fP\fIcolumn\fP]
+[\fB-yrightpos=\fP\fIrow\fP]
+[\fB-stitcher=\fP{\fBRotateSliver\fP,
+\fBBiLinearSliver\fP,\fBLinearSliver\fP}]
+[\fB-filter=\fP{\fBLineAtATime\fP,\fBHorizontalCrop\fP}]
+[\fB-output=\fP\fIoutput_filespec\fP]
+[\fB-verbose\fP]
+.PP
+All options can be abbreviated to their shortest unique prefix.
+You may use two hyphens instead of one.  You may separate an option
+name and its value with white space instead of an equals sign.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpnmstitch\fP stitches together two panoramic photographs.  This
+means if you have photographs of the left and right side of something
+that is too big for a single camera frame, \fBpnmstitch\fP can join them
+into one wide picture.
+.PP
+\fBpnmstitch\fP works only on side-by-side images, not top and bottom
+(though you could certainly use \fBpamflip\fP in combination with
+\fBpnmstitch\fP to achieve this).  It stitches together two images, but
+you can use it repeatedly to stitch together as many as you need to.
+.PP
+Your photographs must overlap in order for \fBpnmstitch\fP to
+work, and the overlap should be substantial.  \fBpnmstitch\fP shifts
+and stretches the right hand image to match it up the left hand image.
+You probably want to crop the result with \fBpamcut\fP to make a nice
+rectangular image.
+.PP
+If you're just trying to join (concatenate) two images at their edges, use
+\fBpnmcat\fP.
+.PP
+The \fIleft_filespec\fP and \fIright_filespec\fP arguments are the
+specifications (names) of the PNM files containing the left hand and
+right hand images.  If you specify only \fIright_filespec\fP, the
+left hand image comes from Standard Input.  If you specify neither, both
+images come from Standard Input as a multi-image file containing first the
+left and then the right image.
+.PP
+\fIoutput_filespec\fP is the specification (name) of the output PNM file.
+The \fB-output\fP option also specifies the output file.  You cannot specify
+both the argument and the option.  If you specify neither, the output goes to
+Standard Output.
+
+
+.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
+\&), \fBpnmstitch\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-width=\fIwidth\fP\fP
+.TP
+\fB-height=\fIheight\fP\fP
+.TP
+\fB-xrightpos=\fIcolumn\fP\fP
+.TP
+\fB-yrightpos=\fIrow\fP\fP
+These are constraints on where \fBpnmstitch\fP stitches the images together.
+For the \fBLinearSliver\fP method, \fIcolumn\fP and \fIrow\fP tell what
+location in the right hand image matches up to the top right corner of the
+left hand image.
+     
+.TP
+\fB-stitcher=\fP{\fBRotateSliver\fP,\fBBiLinearSliver\fP,
+\fBLinearSliver\fP}
+The default is \fBRotateSliver\fP.
+
+.TP
+\fB-filter=\fP{\fBLineAtATime\fP,\fBHorizontalCrop\fP}
+No details available.
+     
+.TP
+\fB-output=\fP\fIoutput_filespec\fP
+Name of output file.  If you don't specify this option, the output image
+goes to Standard Output.
+
+.TP
+\fB-verbose\fP
+This option causes \fBpnmstitch\fP to issue messages to Standard Error
+about the stitching process.
+     
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pamcut" (1)\c
+\&,
+.BR "pnmcat" (1)\c
+\&,
+.BR "pamflip" (1)\c
+\&,
+.BR "pnm" (1)\c
+\&,
+
+.UN history
+.SH HISTORY
+.PP
+This program was added to Netpbm in Release 10.7 (August 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/pnmstitch.html
+.PP
+\ No newline at end of file