1 files changed, 147 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/pamtable.1 b/upstream/mageia-cauldron/man1/pamtable.1
new file mode 100644
index 00000000..d151ab89
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/pamtable.1
@@ -0,0 +1,147 @@
+\
+.\" 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 "Pamtable User Manual" 0 "15 April 2017" "netpbm documentation"
+
+.SH NAME
+
+pamtable - print the raster as a table of numerical sample values
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpamtable\fP
+
+[\fB-tuple\fP]
+[\fB-hex\fP]
+
+[\fInetpbmfile\fP]
+
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpamtable\fP prints the raster of a Netpbm image as a table of numerical
+sample values.  For example, a 5-pixel wide, 2-pixel high rainbow (black, red,
+green, blue, white) PPM image with maxval 255 would appear as follows:
+
+.nf
+
+
+        0   0   0|255   0   0|  0 255   0|  0   0 255|255 255 255
+        0   0   0|255   0   0|  0 255   0|  0   0 255|255 255 255
+
+
+
+.fi
+.PP
+There are other output formats possible.  See the command line options.
+.PP
+If you care to see only certain rows or columns, use \fBpamcut\fP to
+filter the input.
+.PP
+If you care to see only certain planes, use \fBpamchannel\fP to filter the
+input.
+.PP
+\fBpamtable\fP prints vertical bars between tuples, unless there is only
+one sample per tuple, in which case it prints a single space between tuples.
+.PP
+\fBpamtable\fP prints a single space between samples within a tuple.
+.PP
+For each sample, \fBpamtable\fP prints the numerical value from the Netpbm
+image, uninterpreted.  It prints it in decimal, right justified in the minimum
+number of spaces required to print the maxval of the image.
+.PP
+If you want the samples to print more densely, use \fBpamdepth\fP to
+reduce the maxval (thus making the decimal numbers for the samples narrower).
+.PP
+The \fBless\fP program (not part of Netpbm) is good for browsing through
+the table.  Use its \fB--chop-long-lines\fP option and use cursor movement
+keys to scroll around in the image.
+
+
+.UN arguments
+.SH ARGUMENTS
+.PP
+The only possible argument is the name of the file containing the input
+Netpbm image.  This is optional; if you don't specify any arguments, 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
+\&), \fBpamtable\fP recognizes the following command line options:
+
+
+.TP
+\fB-tuple\fP
+Print the tuple values in mathematical tuple notation, like this:
+
+.nf
+
+
+        (0, 0, 0) (255, 0, 0) (0, 255, 0) (0, 0, 255) (255, 255, 255)
+        (0, 0, 0) (255, 0, 0) (0, 255, 0) (0, 0, 255) (255, 255, 255)
+
+
+
+.fi
+.sp
+This option was new in Netpbm 10.11.00 (September 2022).
+
+.TP
+\fB-hex\fP
+Display sample values in hexadecimal instead of decimal.
+.sp
+This option is not valid with \fB-tuple\fP.
+.sp
+This option was new in Netpbm 10.11.00 (September 2022).
+
+  
+.TP
+\fB-verbose\fP
+.sp
+Print additional messages about the processing.
+  
+.UN seealso
+.SH SEE ALSO
+.BR "pamfile" (1)\c
+\&,
+.BR "pamcut" (1)\c
+\&,
+.BR "pamchannel" (1)\c
+\&,
+.BR "pnm" (1)\c
+\&,
+.BR "pam" (1)\c
+\&,
+.BR "pamslice" (1)\c
+\&,
+.BR "ppmtoarbtxt" (1)\c
+\&,
+.BR "ppmtoterm" (1)\c
+\&,
+
+
+.UN history
+.SH HISTORY
+.PP
+\fBpamtable\fP was new in Netpbm 10.79 (June 2017).
+.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/pamtable.html
+.PP
+\ No newline at end of file