1 files changed, 92 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/pbmtopgm.1 b/upstream/mageia-cauldron/man1/pbmtopgm.1
new file mode 100644
index 00000000..062a03b7
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/pbmtopgm.1
@@ -0,0 +1,92 @@
+\
+.\" 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 "Pbmtopgm User Manual" 0 "05 Feb 2003" "netpbm documentation"
+
+.SH NAME
+
+pbmtopgm - convert PBM image to PGM by averaging areas
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpbmtopgm \fP
+\fIwidth\fP
+\fIheight\fP
+[\fIpbmfile\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpbmtopgm\fP reads a PBM image as input.  It outputs a PGM image
+in which each pixel's gray level is the average of the surrounding
+black and white input pixels.  The surrounding area is a rectangle of
+\fIwidth\fP by \fIheight\fP pixels.
+.PP
+In other words, this is a convolution.  \fBpbmtopgm\fP is similar
+to a special case of \fBpnmconvol\fP.
+.PP
+You may need a \fBpnmsmooth\fP step after \fBpbmtopgm\fP.
+.PP
+\fBpbmtopgm\fP has the effect of anti-aliasing bitmaps which
+contain distinct line features.
+.PP
+\fBpbmtopgm\fP works best with odd sample width and heights.
+.PP
+You don't need \fBpbmtopgm\fP just to use a PGM program on a PBM
+image.  Any PGM program (assuming it uses the Netpbm libraries to read
+the PGM input) takes PBM input as if it were PGM, with only the
+minimum and maximum gray levels.  So unless your convolution rectangle
+is bigger than one pixel, you're not gaining anything with a
+\fBpbmtopgm\fP step.
+.PP
+The opposite transformation (which would turn a PGM into a PBM) is
+dithering.  See \fBpamditherbw\fP.
+
+.UN options
+.SH OPTIONS
+.PP
+There are no command line options defined specifically
+for \fBpbmtopgm\fP, but it recognizes the options common to all
+programs based on libnetpbm (See 
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&.)
+
+.UN seealso
+.SH SEE ALSO
+.BR "pamditherbw" (1)\c
+\&,
+.BR "pnmconvol" (1)\c
+\&,
+.BR "pbm" (1)\c
+\&,
+.BR "pgm" (1)\c
+\&
+
+.UN author
+.SH AUTHOR
+.PP
+Copyright (C) 1990 by Angus Duggan.
+.PP
+Copyright (C) 1989 by Jef Poskanzer.
+.PP
+Permission to use, copy, modify, and distribute this software and
+its documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both that copyright notice and this permission notice appear in
+supporting documentation.  This software is provided "as is"
+without express or implied warranty.
+.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/pbmtopgm.html
+.PP
+\ No newline at end of file