1 files changed, 159 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/pammosaicknit.1 b/upstream/debian-bookworm/man1/pammosaicknit.1
new file mode 100644
index 00000000..de82e999
--- /dev/null
+++ b/upstream/debian-bookworm/man1/pammosaicknit.1
@@ -0,0 +1,159 @@
+\
+.\" 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 "Pammosaicknit User Manual" 1 "12 December 2010" "netpbm documentation"
+
+.SH NAME
+
+pammosaicknit - validate a mosaic knitting pattern
+
+.UN synopsis
+.SH SYNOPSIS
+.PP
+\fBpammosaicknit\fP [\fIin_netpbmfile\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpammosaicknit\fP helps the user create
+.UR http://en.wikipedia.org/wiki/Slip-stitch_knitting#Mosaic_knitting
+mosaic knitting patterns
+.UE
+\&. The program inputs a black-and-white Netpbm image that
+describes a mosaic knitting pattern and outputs a color Netpbm image of the
+same pattern but with invalid runs shown in red.
+.PP
+A valid knitting pattern starts with a "black" row on the
+bottom and alternates "white" and "black"
+rows. A "black" row can contain any arrangement of black pixels
+but no more than three consecutive white pixels. A "white" row
+can contain any arrangement of white pixels but no more than three
+consecutive black pixels. Columns wrap horizontally, so a "white"
+row that both begins and ends with two black pixels is deemed to
+contain four consecutive black pixels. Because this is an invalid
+number for a "white" row, those four pixels will be recolored red
+in the output image.
+.PP
+For clarity, there are two shades of red in the output image.  Dark
+red pixels indicate pixels that were black in the input image but
+which must contain one or more white pixels. Light red pixels indicate
+pixels that were white in the input image but which must contain one
+or more black pixels.
+.PP
+If the output image contains no red pixels, then the input image
+represents a valid mosaic knitting pattern.
+
+.UN options
+.SH OPTIONS
+.PP
+There are no command line options defined specifically
+for \fBpammosaicknit\fP, but it recognizes the options common to all
+programs based on libnetpbm (See 
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&.)
+
+.UN arguments
+.SH ARGUMENTS
+.PP
+\fBpammosaicknit\fP's only argument,
+\fIin_netpbmfile\fP, is the name of an image file that represents a mosaic
+knitting pattern. If you don't specify
+\fIin_netpbmfile\fP, the program reads the image from Standard Input.
+
+
+.UN notes
+.SH NOTES
+.PP
+If the input image is not a black-and-white image, \fBpammosaicknit\fP
+converts it internally to black and white by thresholding each pixel's
+luminosity. The output image is always a color image containing at most four
+colors (black, white, dark red, light red).
+
+.UN seealso
+.SH SEE ALSO
+
+
+.IP \(bu
+
+.BR "pam" (1)\c
+\&
+
+
+.UN history
+.SH HISTORY
+.PP
+pammosaicknit was new in Netpbm 10.53 (December 2010).
+
+.UN author
+.SH AUTHOR
+.PP
+Copyright (C) 2010 Scott Pakin,
+\fIscott+pbm@pakin.org\fP
+
+
+.UN index
+.SH Table Of Contents
+
+
+.IP \(bu
+
+.UR #synopsis
+SYNOPSIS
+.UE
+\&
+.IP \(bu
+
+.UR #description
+DESCRIPTION
+.UE
+\&
+.IP \(bu
+
+.UR #options
+OPTIONS
+.UE
+\&
+.IP \(bu
+
+.UR #arguments
+ARGUMENTS
+.UE
+\&
+.IP \(bu
+
+.UR #notes
+NOTES
+.UE
+\&
+.IP \(bu
+
+.UR #seealso
+SEE ALSO
+.UE
+\&
+.IP \(bu
+
+.UR #history
+HISTORY
+.UE
+\&
+.IP \(bu
+
+.UR #author
+AUTHOR
+.UE
+\&
+.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/pammosaicknit.html
+.PP
+\ No newline at end of file