1 files changed, 102 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/asciitopgm.1 b/upstream/mageia-cauldron/man1/asciitopgm.1
new file mode 100644
index 00000000..ff6adc8b
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/asciitopgm.1
@@ -0,0 +1,102 @@
+\
+.\" 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 "Asciitopgm User Manual" 0 "20 January 2011" "netpbm documentation"
+
+.SH NAME
+asciitopgm - convert ASCII graphics into a PGM
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBasciitopgm\fP
+[\fB-d\fP \fIdivisor\fP] \fIheight\fP \fIwidth\fP [\fIasciifile\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBasciitopgm\fP reads ASCII data as input and produces a PGM image
+with pixel values which are an approximation of the
+"brightness" of the ASCII characters, assuming
+black-on-white printing.  In other words, a capital M is very dark, a
+period is very light, and a space is white.
+.PP
+Obviously, \fBasciitopgm\fP assumes a certain font in assigning
+a brightness value to a character.
+.PP
+\fBasciitopgm\fP considers ASCII control characters to be all white.  For
+a lower case character, It assigns a special brightnesses which has nothing to
+do with what it looks like printed.
+\fBasciitopgm\fP takes the ASCII character code from the lower 7 bits
+of each input byte.  But it warns you if the most significant bit of
+any input byte is not zero.
+.PP
+The output image is \fIheight\fP pixels high by \fIwidth\fP pixels wide,
+truncating and padding with white on the right and bottom as necessary.
+.PP
+The \fIdivisor\fP value is an integer (decimal) by which the
+blackness of an input character is divided.  You can use this to
+adjust the brightness of the output: for example, if the image is too
+bright, increase the divisor.
+.PP
+In a sort of reminiscence of Fortran line printer carriage control,
+where a line starts with \fB+\fP (plus), \fBasciitopgm\fP combines it
+with the previous row of output instead of generating a new row.  This
+allows a larger range of gray values.  (In Fortran carriage control, the
+first character of every line sent to the printer tells how much to advance
+the paper, with \fB+\fP meaning not at all, so that the rest of the
+characters on the line overstrike the ones already on the paper.  What
+\fBasciitopgm\fP does is rather different in that \fBasciitopgm\fP does not
+reserve the first character of every line that way.  If the first character is
+anything but \fB+\fP, \fBasciitopgm\fP considers it just to be first
+character of the image.
+.PP
+If you're looking for something that creates an image of text,
+with that text specified in ASCII, that is something quite different.
+Use \fBpbmtext\fP for that.
+
+.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
+\&), \fBasciitopgm\fP recognizes the following
+command line option:
+
+
+.TP
+\fB-d\fP \fIdivisor\fP
+Specify the value by which the blackness of an input character is
+divided.  This is an integer value.  Default value is 1.  Larger
+values produce darker output images.
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pbmtoascii" (1)\c
+\&,
+.BR "pbmtext" (1)\c
+\&,
+.BR "pgm" (1)\c
+\&
+
+.UN author
+.SH AUTHOR
+
+Wilson H. Bent. Jr. (\fIwhb@usc.edu\fP)
+.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/asciitopgm.html
+.PP
+\ No newline at end of file