1 files changed, 85 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/rasttopnm.1 b/upstream/mageia-cauldron/man1/rasttopnm.1
new file mode 100644
index 00000000..2f098768
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/rasttopnm.1
@@ -0,0 +1,85 @@
+\
+.\" 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 "Rasttopnm User Manual" 0 "16 August 2011" "netpbm documentation"
+
+.SH NAME
+rasttopnm - convert a Sun rasterfile to a PNM image
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBrasttopnm\fP
+
+[\fB-index\fP]
+
+[\fIrastfile\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBrasttopnm\fP reads a Sun rasterfile as input and produces a PNM
+image as output.  The type of the output file depends on the input
+file - if it's black and white, \fBrasttopnm\fP writes a PBM image.
+If it's grayscale, \fBrasttopnm\fP writes a PGM.  If it's color,
+\fBrasttopnm\fP writes a PPM.  The program tells you which type it is
+generating.
+
+.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
+\&), \fBrasttopnm\fP recognizes the following
+command line option:
+
+
+  
+.TP
+\fB-index\fP
+This odd option tells \fBrasttopnm\fP to use the color map indices in
+the raster as if they are the color values.
+.sp
+In a colormapped Sun rasterfile, the header of the file contains a color
+map, associating each unique color that occurs in the file with an index
+number.  The raster portion of the file then represents the color of a pixel
+with one of those colormap indices.
+.sp
+This option has found use as follows: take a regular grayscale Sun
+rasterfile in which all the grayscale value are represented, so the colormap
+indices are identical to the color values.  Modify its color map so as to
+alter the colors in the image, in particular to equalize the colors.  With
+that modified rasterfile as input, \fBrasttopnm\fP without \fB-index\fP
+produces the modified image.  But with \fB-index\fP, it produces the original
+unmodified image.
+.sp
+This option was new in Netpbm 10.56 (September 2011).
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pnmtorast" (1)\c
+\&, 
+.BR "pnm" (1)\c
+\&
+
+.UN author
+.SH AUTHOR
+
+Copyright (C) 1989, 1991 by Jef Poskanzer.
+.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/rasttopnm.html
+.PP
+\ No newline at end of file