1 files changed, 82 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/asciitopgm.1 b/upstream/opensuse-leap-15-6/man1/asciitopgm.1
new file mode 100644
index 00000000..d32f8b28
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man1/asciitopgm.1
@@ -0,0 +1,82 @@
+\
+.\" 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; the default value is 1.
+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 seealso
+.SH SEE ALSO
+.BR "pbmtoascii" (1)\c
+\&,
+.BR "pbmtext" (1)\c
+\&,
+.BR "pgm" (5)\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