1 files changed, 131 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/pamslice.1 b/upstream/mageia-cauldron/man1/pamslice.1
new file mode 100644
index 00000000..d76201e0
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/pamslice.1
@@ -0,0 +1,131 @@
+\
+.\" 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 "Pamslice User Manual" 0 "08 February 2010" "netpbm documentation"
+
+.SH NAME
+pamslice - extract one line of values out of a Netpbm image
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpamslice\fP
+{\fB-row=\fP\fIrownumber\fP | \fB-column=\fP\fIcolumnnumber\fP}
+[\fB-plane=\fP\fIplanenumber\fP]
+[\fIimagefile\fP]
+
+.SH OPTION USAGE
+.PP
+All options can be abbreviated to their shortest unique prefix.
+You may use two hyphens instead of one.  You may separate an option
+name and its value with white space instead of an equals sign.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpamslice\fP extracts one line of tuples (pixels) out of a
+Netpbm image and prints their values in a table.  A line means a row
+or column.  It shows you a one-dimensional cross section of a
+two-dimensional image.  (With the \fB-plane\fP option, it can be
+thought of as a one-dimensional cross-section of a three-dimensional
+image).
+.PP
+The table has one line per tuple, consisting of blank-separated
+ASCII decimal numbers.  The first number is the column number if you
+specified a row slice or the row number if you specified a column
+slice.  The rest of the numbers are the sample values in plane number
+order.  For a PBM or PGM input, there is only one plane.  For a PPM
+input, Plane 0 is red, Plane 1 is green, and Plane 2 is blue.  See the
+specifications of the image formats for details on exactly what these
+numbers mean.
+.PP
+If you want to see the entire raster of a Netpbm image, use
+\fBpamtable\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
+\&), \fBpamslice\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-row=\fP\fIrownumber\fP
+     This indicates that the slice is to be horizontal -- i.e. one row of the
+     image -- and indicates which row.  Rows are numbered from the top
+     starting with 0.
+.sp
+You cannot specify both \fB-row\fP and \fB-column\fP.
+
+.TP
+\fB-column=\fP\fIcolnumber\fP
+     This indicates that the slice is to be vertical -- i.e. one column of the
+     image -- and indicates which column.  Columns are numbered from the left
+     starting with 0.
+.sp
+You cannot specify both \fB-row\fP and \fB-column\fP.
+
+.TP
+\fB-plane=\fP\fIplanenumber\fP
+     This specifies that you are interested in only one plane of the image
+     and which one.  Planes are numbered from 0 and have meanings that vary
+     on the type of image.  In a PPM image, Plane 0 is red, Plane 1 is
+     green, and Plane 2 is blue.
+.sp
+If you don't specify \fB-plane\fP, you get all the planes -- each
+     line of output has multiple numbers in addition to the sequence number.
+     If you do specify \fB-plane\fP, each line of output contains one
+     number in addition to the sequence number.
+
+.TP
+\fB-xmgr\fP
+     This option causes \fBpamslice\fP to format the output as input for a
+     \fBxmgr\fP so you can plot it.  The only difference this option makes
+     is that it adds header information to the beginning of the output.
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pamtable" (1)\c
+\&
+.BR "pamcut" (1)\c
+\&
+.BR "pamtopnm" (1)\c
+\&
+.BR "pamchannel" (1)\c
+\&
+.BR "pnm" (1)\c
+\&
+
+.UN history
+.SH HISTORY
+.PP
+\fBpamslice\fP replaced \fBpgmslice\fP in Netpbm 10.3 (June 2002).
+It was backward compatible, but worked on Netpbm images other than PGM and
+PBM and added the \fB-plane\fP and \fB-xmgr\fP options.
+
+.UN author
+.SH AUTHOR
+.PP
+Jos Dingjan <\fIjos@tuatha.org\fP> wrote
+\fBpgmslice\fP after being unable to find the source code to Marco
+Beijersbergen's program with the same name.  Bryan Henderson converted it
+to \fBpamslice\fP.
+.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/pamslice.html
+.PP
+\ No newline at end of file