1 files changed, 141 insertions, 0 deletions
diff --git a/upstream/fedora-40/man1/pnmshear.1 b/upstream/fedora-40/man1/pnmshear.1
new file mode 100644
index 00000000..60f40a2f
--- /dev/null
+++ b/upstream/fedora-40/man1/pnmshear.1
@@ -0,0 +1,141 @@
+\
+.\" 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 "Pnmshear User Manual" 0 "22 March 2020" "netpbm documentation"
+
+.SH NAME
+pnmshear - shear a PNM image by a specified angle
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpnmshear\fP
+
+[\fB-noantialias\fP] [\fB-background=\fP\fIcolor\fP]
+\fIangle\fP [\fIpnmfile\fP]
+.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 equals signs between an option name and
+its value.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpnmshear\fP reads a PNM image as input and shears it by the
+specified angle and produce a PNM image as output.  If the input file
+is in color, the output will be too, otherwise it will be grayscale.
+The angle is in degrees (floating point), and measures this:
+
+.nf
+    +-------+  +-------+
+    |       |  |\e       \e
+    |  OLD  |  | \e  NEW  \e
+    |       |  |an\e       \e
+    +-------+  |gle+-------+
+
+.fi
+
+If the angle is negative, it shears the other way:
+.nf
+    +-------+  |-an+-------+
+    |       |  |gl/       /
+    |  OLD  |  |e/  NEW  /
+    |       |  |/       /
+    +-------+  +-------+
+
+.fi
+
+The angle should not get too close to 90 or -90, or the resulting image will
+be unreasonably wide.  In fact, if it gets too close, the width will be so
+large that \fBpnmshear\fP cannot do computations in the word sizes it uses,
+and the program detects this and fails.
+.PP
+\fBpnmshear\fP does the shearing by looping over the source pixels
+and distributing fractions to each of the destination pixels.  This
+has an "anti-aliasing" effect - it avoids jagged edges and
+similar artifacts.  However, it also means that the original colors in
+the image are modified and there are typically more of them than you
+started with.  If you need to keep precisely the same set of colors,
+see the \fB-noantialias\fP option.  If the expanded palette is a
+problem, you can run the result through \fBpnmquant\fP.
+
+.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
+\&), \fBpnmshear\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-background=\fP\fIcolor\fP
+This determines the color of the background on which the sheared image
+sits.
+.sp
+Specify the color (\fIcolor\fP) as described for the 
+.UR libnetpbm_image.html#colorname
+argument of the \fBpnm_parsecolor()\fP library routine
+.UE
+\&.
+.sp
+By default, if you don't specify this option, \fBpnmshear\fP selects
+what appears to it to be the background color of the original image.  It 
+determines this color rather simplistically, by taking an average of the colors
+of the two top corners of the image.
+.sp
+This option was new in Netpbm 10.37 (December 2006).  Before that,
+\fBpnmshear\fP always behaved as is the default now.
+
+.TP
+\fB-noantialias\fP
+This option forces \fBpnmshear\fP to simply move pixels around instead 
+of synthesizing output pixels from multiple input pixels.  The latter could
+cause the output to contain colors that are not in the input, which may not
+be desirable.  It also probably makes the output contain a large number of
+colors.  If you need a small number of colors, but it doesn't matter if they
+are the exact ones from the input, consider using \fBpnmquant\fP on the 
+output instead of using \fB-noantialias\fP.
+.sp
+Note that to ensure the output does not contain colors that are not
+in the input, you also must consider the background color.  See the
+\fB-background\fP option.
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pnmrotate" (1)\c
+\&,
+.BR "pamflip" (1)\c
+\&,
+.BR "pamhomography" (1)\c
+\&,
+.BR "pnmquant" (1)\c
+\&,
+.BR "pamrestack" (1)\c
+\&,
+.BR "pnm" (1)\c
+\&
+
+
+.UN author
+.SH AUTHOR
+
+Copyright (C) 1989, 1991 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/pnmshear.html
+.PP
+\ No newline at end of file