1 files changed, 126 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/pamtopnm.1 b/upstream/mageia-cauldron/man1/pamtopnm.1
new file mode 100644
index 00000000..3698ae3b
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/pamtopnm.1
@@ -0,0 +1,126 @@
+\
+.\" 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 "Pamtopnm User Manual" 0 "02 February 2018" "netpbm documentation"
+
+.SH NAME
+pamtopnm - convert PAM image to PBM, PGM, or PPM
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpamtopnm\fP
+
+[\fB-assume\fP]
+
+[\fIpnmfile\fP]
+.PP
+Minimum unique abbreviation of option is acceptable.  You may use double
+hyphens instead of single hyphen to denote options.  You may use white
+space in place of the equals sign to separate an option name from its value.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpamtopnm\fP reads a PAM image as input and produces an
+equivalent PBM, PGM, or PPM (i.e. PNM) image, whichever is most
+appropriate, as output.
+.PP
+\fBpamtopnm\fP assumes the PAM image represents the information
+required for a PBM, PGM, or PPM image if its tuple type is
+"BLACKANDWHITE", "GRAYSCALE", or "RGB"
+and its depth and maxval are appropriate.  If this is not the case,
+\fBpamtopnm\fP fails.
+.PP
+However, you can override the tuple type requirement with the
+\fB-assume\fP option.
+.PP
+\fBpamtopnm\fP produces a PPM image if the input PAM has depth 3 or 4; it
+produces PGM or PBM if the input PAM has depth 1 or 2.  Whether it produced
+PGM or PBM depends upon the maxval: PBM for 1, PGM for anything higher.  The
+tuple type does not play a role in determining the output type.  You can
+use Netpbm programs such as \fBpgmtopgm\fP to generate a different PNM
+output, but remember that Netpbm program that expects PGM input will take
+PBM and so on.
+.PP
+Note that it's possible for an image which is formally color to in fact
+contain only shades of gray and for an image which is formally grayscale to
+contain only black and white.  This program pays no attention to that; an RGB
+input image produces a PPM output image even if all the pixels are gray.  But
+you can use \fBppmtopgm\fP to convert a PPM that you know is grayscale to the
+equivalent PGM, and you can use \fBpamthreshold\fP to convert a PGM image you
+know is black and white to a black and white PAM image and then
+use \fBpamtopnm\fP to convert that to PBM.
+  
+.PP
+As with any Netpbm program that reads PAM images, \fBpamtopnm\fP
+also reads PNM images as if they were PAM.  In that case,
+\fBpamtopnm\fP's functions reduces to simply copying the input to the
+output.  But this can be useful in a program that doesn't know whether
+its input is PAM or PNM but needs to feed it to a program that only
+recognizes PNM.
+
+.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
+\&), \fBpamtopnm\fP recognizes the following
+command line option:
+
+
+.TP
+\fB-assume\fP
+When you specify \fB-assume\fP, you tell \fBpamtopnm\fP that you
+personally vouch for the fact that the tuples contain the same data as
+belongs in the channels of a PBM, PGM, or PPM file.  The depth must
+still conform, though, so to truly force a conversion, you may have to
+run the input through \fBpamchannel\fP first.  But be careful with
+\fB-assume\fP.  When you -assume, you make an -ass of u and me.
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pbmtopgm" (1)\c
+\&,
+.BR "pamditherbw" (1)\c
+\&,
+.BR "pgmtoppm" (1)\c
+\&,
+.BR "ppmtopgm" (1)\c
+\&,
+.BR "pamthreshold" (1)\c
+\&,
+.BR "pam" (1)\c
+\&,
+.BR "pnm" (1)\c
+\&,
+.BR "pbm" (1)\c
+\&,
+.BR "pgm" (1)\c
+\&,
+.BR "ppm" (1)\c
+\&
+
+
+.UN history
+.SH HISTORY
+.PP
+\fBpamtopnm\fP was new, along with the PAM format, in Netpbm
+9.7 (August 2000).
+.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/pamtopnm.html
+.PP
+\ No newline at end of file