Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 143 insertions, 0 deletions

diff --git a/upstream/debian-unstable/man1/pnmsmooth.1 b/upstream/debian-unstable/man1/pnmsmooth.1
new file mode 100644
index 00000000..8d6d9d9f
--- /dev/null
+++ b/upstream/debian-unstable/man1/pnmsmooth.1
@@ -0,0 +1,143 @@
+\
+.\" 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 "Pnmsmooth User Manual" 1 "19 December 2009" "netpbm documentation"
+
+.SH NAME
+pnmsmooth - smooth out an image
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpnmsmooth\fP
+[\fB-width=\fP\fIcols\fP] [\fB-height=\fP\fIrows\fP]
+[\fIpnmfile\fP] [\fB-size\fP]
+.PP
+Minimum unique abbreviations of options is acceptable.  You may use double
+hyphens instead of single hyphen to denote options.  You may use white
+space in place of the equals sign to separate an option name from its value.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpnmsmooth\fP smoothes out an image by replacing each pixel with the
+average of its width X height neighbors.  It is implemented as a program that
+invokes \fBpnmconvol\fP with an appropriate convolution matrix.
+
+.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
+\&), \fBpnmsmooth\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-width=\fP\fIcols\fP
+.TP
+\fB-height=\fP\fIrows\fP
+These options specify the dimensions of the convolution matrix.
+Default dimensions are 3 wide and 3 high.
+.sp
+Before Netpbm 10.49 (December 2009), the maximum size of the convolution
+matrix is limited by the maxval of the image such that width * height * 2 must
+not exceed the maxval.  (use \fBpamdepth\fP to increase the maxval if
+necessary).
+.sp
+These options were new in Netpbm 10.32 (February 2006).  Before that,
+use \fB-size\fP.
+
+.TP
+\fB-size\fP
+This deprecated option exists in current Netpbm for backward
+compatibility.  It was obsoleted by \fB-width\fP and \fB-height\fP
+in Netpbm 10.32 (February 2006).
+.sp
+When you use this option, the first two program arguments are the width
+and height, respectively, of the convolution matrix and do the same thing
+as the \fB-width\fP and \fB-height\fP option values.  The third
+(optional) program argument is the input file name.
+.sp
+In reality, in old \fBpnmsmooth\fP, the width and height are two
+values of the \fB-size\fP option, but the modern Netpbm command syntax
+paradigm doesn't allow an option with multiple values, so instead
+\fB-size\fP is an option with no value and width and height are program
+arguments.  That has the fortunate effect of making the following command
+mean the same in current \fBpnmsmooth\fP as in old \fBpnmsmooth\fP:
+.nf
+\f(CW
+     pnmsmooth -size 5 5 infile.ppm >outfile.ppm
+\fP
+
+.fi
+
+.TP
+\fB-dump=\fP\fIdumpfile\fP
+This options makes \fBpnmsmooth\fP only show you the
+convolution matrix.  It writes to Standard Output a \fBpnmconvol\fP
+\fB-matrix\fP option value that represents the matrix.  It does not
+invoke \fBpnmconvol\fP and does not produce an output image.
+.sp
+Before Netpbm 10.49 (December 2009), this option is rather different.
+It takes a file name as a value, and it writes to that file the
+convolution matrix as a PGM file (as used to be the normal input for
+\fBpnmconvol\fP).
+
+
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pnmconvol" (1)\c
+\&,
+.BR "pnm" (1)\c
+\&
+
+.UN history
+.SH HISTORY
+.PP
+Before Netpbm 10.32 (February 2006), \fBpnmsmooth\fP did not use
+the modern Netpbm command line parser, so had an unconventional command line
+syntax.  Most importantly, you could not use an equal sign or double
+hyphens in the options.
+.PP
+Before Netpbm 10.49 (December 2009), there was a \fB-dump\fP option.
+This strange option caused \fBpnmsmooth\fP not to do any smoothing or
+produce any output image but instead write the convolution matrix it
+would have used, as PGM file such as \fBpnmconvol\fP used to use, to
+a file you specify.  The idea was you could then use that file with a
+separate invocation of \fBpnmconvol\fP.
+.PP
+Then, in Netpbm 10.49, there was a rather different \fB-dump\fP
+option with a similar purpose: It caused \fBpnmsmooth\fP to write to
+Standard Error a string suitable as a value for the \fBpnmconvol\fP
+\fB-matrix\fP option (an option that was new in Netpbm 10.49).
+.PP
+But in Netpbm 10.51 (June 2010), \fBpnmconvol\fP started using the even
+newer \fBpnmconvol\fP \fB-normalize\fP option (new in 10.50), which made
+specifying the convolution matrix for the kind of smoothing that
+\fBpnmsmooth\fP does trivial, so \fB-dump\fP disappeared from
+\fBpnmsmooth\fP.
+.PP
+(There were also ease of implementation issues that kept us from simply
+keeping the original \fB-dump\fP around for backward compatibility: As we
+modified \fBpnmsmooth\fP to take advantage of the new features of
+\fBpnmconvol\fP, which \fBpnmsmooth\fP uses internally, the information
+needed to implement \fB-dump\fP was no longer available in the program).
+.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/pnmsmooth.html
+.PP
\ No newline at end of file