Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 145 insertions, 0 deletions

diff --git a/upstream/debian-unstable/man1/palmtopnm.1 b/upstream/debian-unstable/man1/palmtopnm.1
new file mode 100644
index 00000000..9ba7a286
--- /dev/null
+++ b/upstream/debian-unstable/man1/palmtopnm.1
@@ -0,0 +1,145 @@
+\
+.\" 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 "Palmtopnm User Manual" 1 "26 January 2005" "netpbm documentation"
+
+.SH NAME
+palmtopnm - convert a Palm Bitmap to a PNM image
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpalmtopnm\fP
+
+[\fB-verbose\fP]
+
+[\fB-rendition\fP \fIN\fP]
+
+[\fB-showhist\fP]
+
+[\fIpalmfile\fP]
+\fBpalmtopnm\fP
+
+\fB-transparent\fP
+
+[\fB-verbose\fP]
+
+[\fIpalmfile\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpalmtopnm\fP reads a Palm Bitmap as input, from Standard Input or
+\fIpalmfile\fP and produces a PPM image as output.
+.PP
+Alternatively (when you specify \fB-transparent\fP),
+\fBpalmtopnm\fP writes the value of the transparent color in the Palm
+Bitmap to Standard Output.
+.PP
+\fBPalmtopnm\fP can convert Palm Bitmaps with the following features.
+This does not mean that it doesn't handle other features.  These are just
+the ones we found worth mentioning.
+
+.IP \(bu
+Version 0
+.IP \(bu
+Version 1
+.IP \(bu
+Version 2
+.IP \(bu
+Version 3 (new in Netpbm 10.27 (March 2005))
+.IP \(bu
+Scanline compression
+.IP \(bu
+RLE compression
+.IP \(bu
+Packbits compression (new in Netpbm 10.27 (March 2005))
+
+
+.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
+\&), \fBpalmtopnm\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-verbose\fP
+Display various interesting information about the input file and process.
+
+.TP
+\fB-transparent\fP
+If the Palm Bitmap has a transparent color set, 
+\fBpalmtopnm\fP writes the value for that
+color to Standard Output in the form #RRGGBB, where
+RR, GG, and BB are two-digit hexadecimal numbers
+indicating a value in the range 0 through 255.  If no transparent color is set
+in the Bitmap, \fBpalmtopnm\fP writes nothing.  \fBpalmtopnm\fP does not
+generate any output image when you specify \fB-transparent\fP.
+
+.TP
+\fB-rendition N\fP
+Palm Bitmaps may contain several different renditions of the same
+image, with different depths.  By default, \fBpalmtopnm \fP operates
+on the first rendition (rendition number 1) in the image.  This
+switch allows you to operate on a different rendition.  The value must
+be between 1 and the number of renditions in the image, inclusive.
+
+.TP
+\fB-showhist\fP
+This option causes \fBpalmtopnm\fP to 
+write a histogram of colors in the input file to Standard Error.
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pnmtopalm" (1)\c
+\&,
+.BR "pamtopdbimg" (1)\c
+\&,
+.BR "pnm" (1)\c
+\&,
+
+.UN limitations
+.SH LIMITATIONS
+.PP
+You cannot generate a transparency mask if the Palm Bitmap has a
+transparent color.  However, you can still do this with
+\fBppmcolormask\fP with a Netpbm pipe similar to:
+.PP
+\fBpalmtopnm bitmap.palm | 
+ppmcolormask `palmtopnm -transparent bitmap.palm`\fP
+
+.UN history
+.SH HISTORY
+.PP
+Before Netpbm 10.23 (July 2004), there was a \fB-forceplain\fP
+option.  But that had been redundant for a long time, since the Netpbm 
+common option \fB-plain\fP does the same thing.
+
+.UN authors
+.SH AUTHORS
+
+This program was originally written as Tbmptopnm.c, by Ian Goldberg.
+It was heavily modified by Bill Janssen to add color, compression, and
+transparency function.
+.PP
+Copyright 1995-2001 by Ian Goldberg and Bill Janssen.
+.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/palmtopnm.html
+.PP
\ No newline at end of file