1 files changed, 98 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/ppmtosixel.1 b/upstream/mageia-cauldron/man1/ppmtosixel.1
new file mode 100644
index 00000000..a8a17bdf
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/ppmtosixel.1
@@ -0,0 +1,98 @@
+\
+.\" 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 "Ppmtosixel User Manual" 0 "26 April 1991" "netpbm documentation"
+
+.SH NAME
+
+ppmtosixel - convert a PPM image to DEC sixel format
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBppmtosixel\fP
+
+[\fB-raw\fP]
+
+[\fB-margin\fP]
+
+[\fIppmfile\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBppmtosixel\fP reads a PPM image as input and produces sixel
+commands (SIX) as output.  The output is formatted for color printing,
+e.g. for a DEC LJ250 color inkjet printer.
+.PP
+If RGB values from the PPM file do not have maxval=100,
+\fBppmtosixel\fP rescales them to maxval 100.  A printer control
+header and a color assignment table begin the SIX file.  Image data is
+in a compressed format by default.  A printer control footer ends the
+image file.
+
+.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
+\&), \fBppmtosixel\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-raw\fP
+If you specify this, each pixel will be explicitly described in
+the image file.  If \fB-raw\fP is not specified, output will default
+to compressed format in which identical adjacent pixels are replaced
+by "repeat pixel" commands.  A raw file is often an order of
+magnitude larger than a compressed file and prints much slower.
+
+.TP
+\fB-margin\fP
+If you don't specify \fB-margin\fP, the image will start at the
+left margin (of the window, paper, or whatever).  If you \fIdo\fP
+specify \fB-margin\fP, a 1.5 inch left margin will offset the image.
+
+
+
+.UN printing
+.SH PRINTING
+.PP
+Generally, sixel files must reach the printer unfiltered.
+Use the lpr -x option or \fBcat filename > /dev/tty0?\fP.
+
+.UN limitations
+.SH LIMITATIONS
+
+Upon rescaling, truncation of the least significant bits of RGB values
+may result in poor color conversion.  If the original PPM maxval was
+greater than 100, rescaling also reduces the image depth.  While the
+actual RGB values from the ppm file are more or less retained, the
+color palette of the LJ250 may not match the colors on your screen.
+This seems to be a printer limitation.
+
+.UN seealso
+.SH SEE ALSO
+.BR "ppm" (1)\c
+\&
+
+.UN author
+.SH AUTHOR
+
+Copyright (C) 1991 by Rick Vinci.
+.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/ppmtosixel.html
+.PP
+\ No newline at end of file