1 files changed, 157 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man1/rletopnm.1 b/upstream/debian-unstable/man1/rletopnm.1
new file mode 100644
index 00000000..4ce152d8
--- /dev/null
+++ b/upstream/debian-unstable/man1/rletopnm.1
@@ -0,0 +1,157 @@
+\
+.\" 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 "Rletopnm User Manual" 1 "13 April 2000" "netpbm documentation"
+
+.SH NAME
+rletopnm - convert a Utah Raster Tools RLE image file to a PNM image file.
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBrletopnm\fP
+
+[\fB--alphaout=\fP{\fIalpha-filename\fP,\fB-\fP}]
+[\fB--headerdump\fP|\fB-h\fP]
+
+[\fB--verbose\fP|\fB-v\fP]
+
+[\fIrlefile\fP|\fB-\fP]
+.PP
+All options may be abbreviated to their minimum unique abbreviation
+and options and arguments may be in any order.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBrletopnm\fP converts Utah Raster Toolkit RLE image files to PNM
+image files.  \fBrletopnm\fP handles four types of RLE files:
+Grayscale (8 bit data, no color map), Pseudocolor (8 bit data with a
+color map), Truecolor (24 bit data with color map), and Directcolor
+(24 bit data, no color map).  \fBrletopnm\fP generates a PPM file for
+all these cases except for the Grayscale file, for which
+\fBrletopnm\fP generates a PGM file.
+.PP
+\fIrlefile\fP is the RLE input file.  If it is absent or \fB-\fP,
+the input comes from Standard Input.
+
+.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
+\&), \fBrletopnm\fP recognizes the following
+command line options:
+
+
+.TP
+\fB--alphaout=\fP\fIalpha-filename\fP
+\fBrletopnm \fP creates a PGM (portable graymap) file containing the
+transparency channel values in the input image.  If the input image doesn't
+contain an transparency channel, the \fIalpha-filename\fP file contains all
+zero (transparent) transparency values.  If you don't specify
+\fB--alphaout\fP, \fBrletopnm\fP does not generate a transparency file,
+and if the input image has a transparency channel, \fBrletopnm\fP simply
+discards it.
+.sp
+If you specify \fB-\fP as the filename, \fBrletopnm\fP writes the
+transparency output to Standard Output and discards the image.
+.sp
+See
+.BR "pamcomp" (1)\c
+\& for one way to use
+the transparency output file.
+
+.TP
+\fB--verbose\fP
+This option causes \fBrletopnm \fP to operate in verbose mode.
+It prints messages about what it's doing, including the contents of
+the RLE image header, to Standard Error.
+
+.TP
+\fB--headerdump\fP
+This option causes \fBrletopnm\fP to operate in header dump mode.
+It prints the contents of the RLE image header to Standard Error, but
+does not produce any other output.
+
+
+
+.UN examples
+.SH EXAMPLES
+
+
+.IP \(bu
+While running in verbose mode, convert lenna.rle to PPM format and
+store the resulting image as lenna.ppm:
+
+.nf
+\f(CW
+    rletopnm --verbose lenna.rle >lenna.ppm
+\fP
+
+.fi
+
+.IP \(bu
+Dump the header information of the RLE file called file.rle:
+
+.nf
+\f(CW
+    rletopnm --headerdump file.rle
+\fP
+
+.fi
+
+.IP \(bu
+Convert RLE file dart.rle to PPM format as dart.ppm.  Store the
+transparency channel of dart.rle as dartalpha.pgm (if dart.rle doesn't have
+a transparency channel, store a fully transparent transparency mask as
+dartalpha.pgm):
+
+.nf
+\f(CW
+    rletopnm --alphaout=dartalpha.pgm dart.rle >dart.ppm
+\fP
+
+.fi
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pnmtorle" (1)\c
+\&,
+.BR "pnmconvol" (1)\c
+\&,
+.BR "pnm" (1)\c
+\&,
+.BR "ppm" (1)\c
+\&,
+.BR "pgm" (1)\c
+\&,
+
+.UN author
+.SH AUTHOR
+
+Wes Barris
+Army High Performance Computing Research Center (AHPCRC)
+Minnesota Supercomputer Center, Inc.
+.PP
+Modifications by Eric Haines to produce raw and plain formats.
+.PP
+Modifications by Bryan Henderson to create transparency files and use
+mnemonic options.
+.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/rletopnm.html
+.PP
+\ No newline at end of file