Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 198 insertions, 0 deletions

diff --git a/upstream/opensuse-leap-15-6/man1/pnmpad.1 b/upstream/opensuse-leap-15-6/man1/pnmpad.1
new file mode 100644
index 00000000..db9a720c
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man1/pnmpad.1
@@ -0,0 +1,198 @@
+\
+.\" 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 "Pnmpad User Manual" 0 "1 July 2015" "netpbm documentation"
+
+.SH NAME
+
+pnmpad - add borders to a PNM image
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpnmpad \fP
+[\fB-verbose\fP]
+[\fB-white\fP|\fB-black\fP]
+[\fB-width=\fP\fIpixels\fP]
+[\fB-halign=\fP\fIratio\fP]
+[\fB-mwidth=\fP\fIpixels\fP]
+[\fB-left=\fP\fIpixels\fP]
+[\fB-right=\fP\fIpixels\fP]
+[\fB-height=\fP\fIpixels\fP]
+[\fB-valign=\fP\fIratio\fP]
+[\fB-mheight=\fP\fIpixels\fP]
+[\fB-top=\fP\fIpixels\fP]
+[\fB-bottom=\fP\fIpixels\fP]
+[\fIpnmfile\fP]
+
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpnmpad\fP reads a PNM image as input and outputs a PNM image
+that is the input image plus black or white borders of the sizes
+specified.
+.PP
+If you just need to convert an image to a certain size regardless
+of the original dimensions, \fBpamcut\fP with the \fB-pad\fP option
+may be a better choice.
+.PP
+\fBpnmmargin\fP does essentially the same thing, but allows you to
+add borders of any color and requires all four borders to be the same
+size.
+
+
+.UN options
+.SH OPTIONS
+.PP
+All options can be abbreviated to their shortest unique prefix.  You
+may use two hyphens instead of one to designate an option.  You may
+use either white space or an equals sign between an option name and
+its value.
+
+
+.TP
+\fB-verbose\fP
+Verbose output.
+
+.TP
+\fB-white\fP
+.TP
+\fB-black\fP
+Set pad color.  Default is \fB-black\fP.
+
+
+.TP
+\fB-left=\fP\fIpixels\fP
+.TP
+\fB-right=\fP\fIpixels\fP
+.TP
+\fB-width=\fP\fIwidth\fP
+.TP
+\fB-halign=\fP\fIratio\fP
+.TP
+\fB-mwidth=\fP\fIpixels\fP
+Specify amount of left and right padding in pixels.
+.sp
+\fB-left\fP and \fB-right\fP directly specify the amount of
+padding added to the left and right sides, respectively, of the image.
+.sp
+Alternatively, you can specify \fB-width\fP and just one of
+\fB-left\fP and \fB-right\fP and \fBpnmpad\fP calculates the required
+padding on the other side based on the width of the input image.  If
+the \fB-width\fP value is less than the width of the image plus the
+specified padding, the \fB-width\fP values is ignored.
+.sp
+If you specify all three of \fB-width\fP, \fB-left\fP, and
+\fB-right\fP, you must ensure that the \fB-left\fP and \fB-right\fP
+padding are sufficient to make the image at least as wide as
+\fB-width\fP specifies.  Otherwise, \fBpnmpad\fP fails.
+.sp
+When you specify \fB-width\fP without \fB-left\fP or
+\fB-right\fP, and \fB-width\fP is larger than the input image,
+\fBpnmpad\fP chooses left and right padding amounts in a certain
+ratio.  That ratio defaults to half, but you can set it to anything
+(from 0 to 1) with the \fB-halign\fP option.  If the input image is
+already at least as wide as \fB-width\fP specifies, \fBpnmpad\fP
+adds no padding.
+.sp
+Common values for \fB-halign\fP are:
+
+.TP
+\fB0.0\fP 
+left aligned
+
+.TP
+\fB0.5\fP 
+center aligned (default)
+
+.TP
+\fB1.0\fP 
+right aligned
+
+.sp
+\fB-mwidth=\fP\fIpixels\fP says to pad to a multiple of
+\fIpixels\fP pixels.  E.g. if \fIpixels\fP is 10, the output image width
+will be a multiple of 10 pixels.  \fBpnmpad\fP adds to whatever padding the
+other options say to do to get to this multiple.  It divides that padding
+between the left and right sides of the image to maintain the ratio the other
+options produce.  E.g. if you say \fB-left=10 -right=10 -mwidth=50\fP with a
+100-pixel image, you end up with a 150-pixel image with the extra padding
+split evenly between left and right for a total of 25 pixels of padding
+on the left and 25 on the right.
+.sp
+Before Netpbm 10.23 (July 2004), \fBpnmpad\fP did not allow the
+\fB-left\fP or \fB-right\fP option together with \fB-width\fP.
+.sp
+Before Netpbm 10.72 (September 2015), there is no \fB-mwidth\fP.
+
+.TP
+\fB-top=\fP\fIpixels\fP
+.TP
+\fB-bottom=\fP\fIpixels\fP
+.TP
+\fB-height=\fP\fIheight\fP
+.TP
+\fB-valign=\fP\fIratio\fP
+.TP
+\fB-mheight=\fP\fIpixels\fP
+These options determine the vertical padding.  They are analogous
+to the horizontal padding options above.
+
+
+
+
+.UN history
+.SH HISTORY
+.PP
+Before February 2002, \fBpnmpad\fP had a different option syntax
+which was less expressive and not like conventional Netpbm programs.
+That syntax is still understood by \fBpnmpad\fP for backward
+compatibility, but not documented or supported for future use.
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pbmmake" (1)\c
+\&,
+.BR "pnmpaste" (1)\c
+\&,
+.BR "pamcut" (1)\c
+\&,
+.BR "pnmcrop" (1)\c
+\&,
+.BR "pamcomp" (1)\c
+\&,
+.BR "pnmmargin" (1)\c
+\&,
+.BR "pbm" (5)\c
+\&
+
+
+.UN author
+.SH AUTHOR
+.PP
+Copyright (C) 2002 by Martin van Beilen
+.PP
+Copyright (C) 1990 by Angus Duggan
+.PP
+Copyright (C) 1989 by Jef Poskanzer.
+.PP
+Permission to use, copy, modify, and distribute this software and
+its documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both that copyright notice and this permission notice appear in
+supporting documentation.  This software is provided "as is"
+without express or implied warranty.
+.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/pnmpad.html
+.PP
\ No newline at end of file