Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 154 insertions, 0 deletions

diff --git a/upstream/mageia-cauldron/man1/g3topbm.1 b/upstream/mageia-cauldron/man1/g3topbm.1
new file mode 100644
index 00000000..e13eae9b
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/g3topbm.1
@@ -0,0 +1,154 @@
+\
+.\" 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 "G3topbm User Manual" 0 "03 December 2008" "netpbm documentation"
+
+.SH NAME
+g3topbm - convert a Group 3 fax file into a PBM image
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBg3topbm\fP
+[\fB-kludge\fP]
+[\fB-reversebits\fP]
+[\fB-stretch\fP]
+[\fB-width=\fP\fIpixels\fP | paper_size={A3|A4|A5|A6|B4}]
+[\fB-stop_error\fP]
+[\fIg3file\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
+\fBg3topbm\fP reads a Group 3 fax file with MH (Modified Huffman)
+compression as input and produces a PBM image as output.
+.PP
+\fBg3topbm\fP tolerates various deviations from the standard,
+so as to recover some of the image if there was a transmission error.
+One thing it tolerates is lines of varying length.  The standard requires
+all the lines to be the same length; \fBg3topbm\fP makes the output
+image as wide as the longest line in the input and pads the others on
+the right.  It warns you when it does this.
+.PP
+You can use the \fBstop_error\fP option to make \fBg3topbm\fP
+insist on valid input.
+.PP
+There is no Netpbm program that understands the other G3 fax
+compression methods: MR (Modified Read) and MMR (Modified Modified Read).
+.PP
+Note that the Group 3 fax file format does not include any kind of a
+signature so that \fBg3topbm\fP might verify it's actually looking at a G3
+file or that the compression method is MH.  The program will interpret any
+sequence of bytes you give it as if it is G3 and, while typically issuing a
+lot of error messages about the file not conforming to the G3 MH format, will
+produce output (unless you use
+\fB-stoperror\fP).  In particular, if you feed \fBg3topbm\fP an MR or MMR
+file, it will not tell you of your mistake.
+.PP
+There are subformats of TIFF that use the Group 3 fax encodings
+inside.  See \fBtifftopnm\fP.
+
+
+.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
+\&), \fBg3topbm\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-kludge\fP
+Tells \fBg3topbm\fP to ignore the first few lines of the file;
+sometimes fax files have some junk at the beginning.
+
+.TP
+\fB-reversebits\fP
+Tells \fBg3topbm\fP to interpret bits least-significant first,
+instead of the default most-significant first.  Apparently some fax
+modems do it one way and others do it the other way.  If you get a
+whole bunch of "bad code word" messages, try using this
+option.
+
+.TP
+\fB-stretch\fP
+This option tells \fBg3topbm\fP to stretch the image vertically by
+duplicating each row.  This is for the low-quality transmission mode.
+
+.TP
+\fB-width=\fP\fIpixels\fP
+This option tells \fBg3topbm\fP that the image is supposed to be
+\fIpixels\fP pixels wide.  If any line in it is not that size, \fBg3topbm\fP
+issues a warning or fails, depending on whether you specify
+\fB-stop_error\fP.
+.sp
+You cannot specify both \fB-width\fP and \fB-paper_size\fP.
+.sp
+This option was new in Netpbm 10.33 (March 2006).
+
+.TP
+\fB-paper_size=\fP{\fBA3\fP,\fBA4\fP,\fBA5\fP,\fBA6\fP,\fBB4\fP}
+This option tells \fBg3topbm\fP for what size paper this image is
+supposed to be formatted.  \fBg3topbm\fP uses the width of the paper
+the same way as with the \fB-width\fP option.  \fBg3topbm\fP
+does not use the height of the paper for anything.
+.sp
+You cannot specify both \fB-width\fP and \fB-paper_size\fP.
+.sp
+This option was new in Netpbm 10.33 (March 2006).
+
+.TP
+\fB-stop_error\fP
+This option tells \fBg3topbm\fP to fail when it finds a problem
+in the input.  "Fail" means it terminates with a nonzero
+status code with the contents of the output file undefined.
+.sp
+If you don't specify this option, \fBg3topbm\fP does its best to
+work around input errors and salvage as much of the image as possible
+in the output image.  It first tries to resynchronize to a later line
+by searching for the next End Of Line marker, skipping any lines or
+partial lines in between.  It saves the beginning of the line in which
+it encountered the problem.  If the input file ends prematurely,
+\fBg3topbm\fP produces output containing the lines up to where it
+encountered the problem.
+.sp
+\fBg3topbm\fP issues warning messages when it continues in spite of
+input errors.
+.sp
+This option was new in Netpbm 10.24 (August 2004).  Before that,
+\fBg3topbm\fP always failed when it encountered premature EOF and
+never failed when it encountered other problems.
+
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pbmtog3" (1)\c
+\&,
+.BR "tifftopnm" (1)\c
+\&,
+.BR "pbm" (1)\c
+\&,
+.BR "fax formats" (1)\c
+\&
+.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/g3topbm.html
+.PP
\ No newline at end of file