1 files changed, 160 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man1/pamenlarge.1 b/upstream/debian-unstable/man1/pamenlarge.1
new file mode 100644
index 00000000..ad4cbdf9
--- /dev/null
+++ b/upstream/debian-unstable/man1/pamenlarge.1
@@ -0,0 +1,160 @@
+\
+.\" 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 "Pamenlarge User Manual" 1 "07 January 2019" "netpbm documentation"
+
+.SH NAME
+pamenlarge - Enlarge a Netpbm image N times by duplicating pixels
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpamenlarge\fP
+[\fB-scale=\fP\fIinteger\fP]
+[\fB-xscale=\fP\fIinteger\fP]
+[\fB-yscale=\fP\fIinteger\fP]
+[\fIfilename\fP]
+
+\fBpamenlarge\fP \fIN\fP [\fIpnmfile\fP]
+
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpamenlarge\fP reads a Netpbm image as input, replicates its pixels
+\fIN\fP times, and produces a Netpbm image as output.  The output is
+the same type of image as the input.
+.PP
+If you enlarge by a factor of 3 or more, you should probably add a
+\fBpnmsmooth\fP step; otherwise, you can see the original pixels in
+the resulting image.
+.PP
+For PBM images, \fBpamenlarge\fP uses special fast algorithms for scale
+factors up to 10.  For larger factors, it uses a simple but slow algorithm.
+As a result, you can often get a significantly faster scale by running
+\fBpamenlarge\fP multiple times.  For example, enlarging by 3 and
+then by 5 is faster than enlarging once by 15.  And because the algorithms
+are different for the different scale factors, some faster than others,
+the order matters too.  For example, the following examples all produce
+the same output -- an image 15 times bigger on edge than the input --
+but at different speeds, each being faster than the one before.
+
+.nf
+\f(CW
+     $ pamenlarge -scale=15 test.pbm
+     $ pamenlarge -scale=5 test.pbm | pamenlarge -scale=3
+     $ pamenlarge -scale=3 test.pbm | pamenlarge -scale=5
+\fP
+
+.fi
+.PP
+The special fast cases for factors up to 10 have existed since Release
+10.50 (March 2010).  The special cases for 1, 2, 3, and 5 go back to Release
+10.41 (December 2007).  Before 10.41, there are no special scale factors and
+PBM enlargement is significantly slower than today for all scale factors.
+.PP
+\fBpamenlarge\fP can enlarge only by integer factors.  The slower
+but more general \fBpamscale\fP can enlarge or reduce by arbitrary
+factors.  \fBpamscale\fP allows you to enlarge by resampling, which
+gives you smoother enlargements.  But it is much slower.
+.PP
+\fBpamstretch\fP is another enlarging program that enlarges by
+integer factors.  It does a simple kind of resampling that gives you a
+smoothed enlargement with less computational cost.
+.PP
+\fBpbmreduce\fP can reduce by integer factors, but only for PBM
+images.
+
+.UN arguments
+.SH ARGUMENTS
+.PP
+As with most Netpbm programs, you can give the input file name as an
+argument or omit that argument and have it come from Standard Input (and
+you can specify '-' for the argument to specify Standard Input
+explicitly).
+.PP
+You can also specify the scale factor as an argument, for backward
+compatibility, but the preferred way to do that is with a \fB-scale\fP
+option, because it is easier to remember and read that way.  The scale factor
+argument goes before the file name argument.
+
+
+
+  
+.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
+\&), \fBpamenlarge\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-scale=\fP\fIinteger\fP
+.TP
+\fB-xscale=\fP\fIinteger\fP
+.TP
+\fB-yscale=\fP\fIinteger\fP
+These specify the scale factor.  \fB-xscale\fP specifies the horizontal
+scale factor; \fB-yscale\fP specifies the vertical scale factor
+and \fB-scale\fP specifies both.
+.sp
+If you specify \fB-xscale\fP but not \fB-yscale\fP, \fBpamenlarge\fP
+does not scale vertically (i.e. the vertical scale factor is 1).  The converse
+applies if you specify \fB-yscale\fP and not \fB-xscale\fP.
+.sp
+You cannot specify \fB-scale\fP and also \fB-xscale\fP or \fByscale\fP.
+.sp
+You must specify at least one of these options, unless you use the
+deprecaated method of specifying the scale factor via argument.
+.sp
+These options were all new in Netpbm 10.86 (March 2019).  Before that, use
+the scale argument.
+  
+
+
+  
+.UN history
+.SH HISTORY
+.PP
+\fBpamenlarge\fP was new in Netpbm 10.25 (October 2004).  It is
+designed as a replacement for \fBpnmenlarge\fP by Jef Poskanzer,
+which was in Pbmplus as far back as 1989.  The major difference is that
+\fBpamenlarge\fP can enlarge PAM format images in addition to PNM.
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pbmreduce" (1)\c
+\&,
+.BR "pamscale" (1)\c
+\&,
+.BR "pamstretch" (1)\c
+\&,
+.BR "pbmpscale" (1)\c
+\&,
+.BR "pnmsmooth" (1)\c
+\&,
+.BR "pnm" (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/pamenlarge.html
+.PP
+\ No newline at end of file