1 files changed, 89 insertions, 0 deletions
diff --git a/upstream/fedora-40/man1/pamendian.1 b/upstream/fedora-40/man1/pamendian.1
new file mode 100644
index 00000000..9e185573
--- /dev/null
+++ b/upstream/fedora-40/man1/pamendian.1
@@ -0,0 +1,89 @@
+\
+.\" 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 "Pamendian User Manual" 0 "16 March 2002" "netpbm documentation"
+
+.SH NAME
+
+pamendian - reverse endianness of a Netpbm image
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpamendian\fP
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+All Netpbm formats that have samples in pure binary format with multiple
+bytes are defined to have them in big endian (most significant byte first)
+order.  However, there exist variations on these formats, primarily developed
+before official multibyte Netpbm formats existed, that are identical to 
+Netpbm formats in every respect except that samples are in little endian
+(least significant byte first) order.
+.PP
+\fBpamendian\fP reverses the byte order of the sample to convert
+between the two formats.  If the input is true PAM, PGM, or PPM, the
+output is the little endian variation on that format, and vice versa.
+.PP
+The X Window System viewer \fBxv\fP expects the little endian variation
+of PGM and PPM.
+.PP
+Programs that come with the Independent Jpeg Group's JPEG library
+are known to use the little endian variation of PGM and PPM.
+.PP
+The reason some programs use this variant is that at one time
+during Netpbm's
+.BR "dark age" (1)\c
+\&, there
+was a version of Netpbm around that used it.  But it was never
+formally specified.
+.PP
+This program takes input only on Standard Input.  Its output is
+always on Standard Output.
+.PP
+You should never have to use this program with images generated by
+programs in the Netpbm package or programs that use the Netpbm
+libraries.  If you do, that probably means something needs to be fixed
+in those programs.  The Netpbm converter for any graphics format that
+represents numbers in little endian form should properly reverse the
+bytes to create correct Netpbm output.
+.PP
+If you create a Netpbm image from a generic stream of samples,
+using \fBrawtopgm\fP or \fBrawtoppm\fP, use options on those
+programs to declare the endianness of your input, thus creating
+correct endianness in your PGM or PPM output.
+
+.UN options
+.SH OPTIONS
+.PP
+There are no command line options defined specifically
+for \fBpamendian\fP, but it recognizes the options common to all
+programs based on libnetpbm (See 
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&.)
+
+.UN seealso
+.SH SEE ALSO
+.BR "pamdepth" (1)\c
+\&,
+.BR "rawtopgm" (1)\c
+\&,
+.BR "rawtoppm" (1)\c
+\&,
+.BR "pnm" (1)\c
+\&
+.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/pamendian.html
+.PP
+\ No newline at end of file