1 files changed, 148 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/pgmhist.1 b/upstream/mageia-cauldron/man1/pgmhist.1
new file mode 100644
index 00000000..7db6b3b1
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/pgmhist.1
@@ -0,0 +1,148 @@
+\
+.\" 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 "Pgmhist User Manual" 0 "18 December 2021" "netpbm documentation"
+
+.SH NAME
+
+pgmhist - print a histogram of the values in a PGM image
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpgmhist\fP
+
+[\fB-median\fP, \fB-quartile\fP, \fB-decile\fP]
+
+[\fB-forensic\fP]
+
+[\fB-machine\fP]
+
+[\fIpgmfile\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpgmhist\fP reads a PGM image as input and prints a histogram of the
+gray values or other gray value distribution metrics.
+.PP
+If you specify none of \fB-median\fP, \fB-quartile\fP, or \fB-decile\fP,
+\fBpgmhist\fP prints a complete histogram showing how many pixels of each
+possible gray value exist in the image.  Along with each gray value, it tells
+you how many pixels are at lest as black as it and how many are at least as
+white.
+.PP
+\fB-median\fP, \fB-quartile\fP, and \fB-decile\fP options cause
+\fBpgmhist\fP instead to print the indicated quantiles.  Each quantile is a
+gray value that actually appears in the image (as opposed to fractional values
+that are sometimes used for quantiles).  The 3rd quartile is the least gray
+value for which at least 75% of the pixels are as dark or darker than it.
+The 4th quartile is the brightest gray value that appears in the image.
+
+
+.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
+\&), \fBpgmhist\fP recognizes the following
+command line options:
+.PP
+You may specify at most one of \fB-median\fP, \fB-quartile\fP, and
+\fB-decile\fP.  If none of these is specified \fBpgmhist\fP prints
+a histogram of gray values.
+
+
+.TP
+\fB-median\fP
+.sp
+This option causes \fBpgmhist\fP to print the median gray value.
+.sp
+This option was new in Netpbm 10.61 (December 2012).
+
+.TP
+\fB-quartile\fP
+.sp
+This option causes \fBpgmhist\fP to print the four quartile gray values.
+.sp
+This option was new in Netpbm 10.61 (December 2012).
+
+.TP
+\fB-decile\fP
+.sp
+This option causes \fBpgmhist\fP to print the ten decile gray values.
+.sp
+This option was new in Netpbm 10.61 (December 2012).
+
+.TP
+\fB-forensic\fP
+.sp
+With this option, \fBpgmhist\fP works on images that contain invalid gray
+values.  Normally, like most Netpbm programs, \fBpgmhist\fP fails if it
+encounters a gray value greater than the maxval that the image declares.  The
+presence of such a value means the image is invalid, so the pixels have no
+meaning.  But with \fB-forensic\fP, \fBpgmhist\fP produces a histogram
+of the actual gray values without regard to maxval.  It issues messages
+summarizing the invalid pixels if there are any.
+.sp
+One use for this is to diagnose the problem that caused the invalid Netpbm
+image to exist.
+.sp
+There is a small exception to the ability of \fBpgmhist\fP to process
+invalid pixels even with \fB-forensic\fP: it can never process a gray value
+greater than 65535.  Note that in the rarely used Plain PGM format, it is
+possible for a number greater than that to appear where a gray value belongs.
+.sp
+This option was new in Netpbm 10.66 (March 2014).  But Netpbm older than
+10.66 does not properly reject invalid sample values, so the effect is very
+similar to \fB-forensic\fP.
+
+.TP
+\fB-machine\fP
+.sp
+This option causes \fBpgmhist\fP to print the information in a way
+easily digestible by a machine as opposed to a human.
+.sp
+For the quantiles, there is one line per quantile, in quantile order, and
+it consists of the gray value of the quantile in decimal with no leading
+zeroes.
+.sp
+For the full histogram output, it consists of one line per possible
+gray value (whether that value appears in the image or not), in order of
+the gray values.  The line consists of two tokens separated by a space.  The
+first is the gray value; the second is the number of pixels in the image that
+have that gray value.  Both are decimal numbers without leading zeroes.
+.sp
+This option was new in Netpbm 10.61 (December 2012).
+
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pnmnorm" (1)\c
+\&,
+.BR "ppmhist" (1)\c
+\&,
+.BR "pgm" (1)\c
+\&
+
+.UN author
+.SH AUTHOR
+
+Copyright (C) 1989 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/pgmhist.html
+.PP
+\ No newline at end of file