1 files changed, 211 insertions, 0 deletions
diff --git a/upstream/fedora-40/man1/pnmtotiffcmyk.1 b/upstream/fedora-40/man1/pnmtotiffcmyk.1
new file mode 100644
index 00000000..a8d1c9de
--- /dev/null
+++ b/upstream/fedora-40/man1/pnmtotiffcmyk.1
@@ -0,0 +1,211 @@
+\
+.\" 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 "Pnmtotiffcmyk User Manual" 0 "21 March 2017" "netpbm documentation"
+
+.SH NAME
+
+pnmtotiffcmyk - convert a Netpbm image into a CMYK encoded TIFF file
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpnmtotiffcmyk \fP
+	[\fB-none\fP|\fB-packbits\fP|\fB-lzw\fP]
+	[\fB-predictor\fP \fIn\fP]
+	[\fB-msb2lsb\fP|\fB-lsb2msb\fP]
+	[\fB-rowsperstrip\fP \fIn\fP]
+	[\fB-lowdotrange\fP \fIn\fP]
+	[\fB-highdotrange\fP \fIn\fP]
+	[\fB-knormal\fP|\fB-konly\fP|\fB-kremove\fP]
+	[[\fB-default\fP]
+        [\fB-theta\fP \fIdeg\fP]
+        [\fB-gamma\fP \fIn\fP]
+        [\fB-gammap\fP \fIn\fP]
+        [\fB-negative\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpnmtotiffcmyk\fPreads a PNM image as input and produces a CMYK
+encoded TIFF file as output.  It optionally modifies the color
+balance and black level, and modifies removal of CMY from under K.
+.PP
+Output is to Standard Output, but unlike with most Netpbm programs,
+Standard Output must be a seekable file.  An ordinary file is fine, but you
+cannot pipe the output to another program.  Furthermore, the program replaces
+any content currently in the file even if it was opened for appending.
+.PP
+\fBpamtotiff\fP generates many other kinds of TIFF files.
+
+
+.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
+\&), \fBpnmtotiffcmyk\fP recognizes the following
+command line options:
+.PP
+The order of most options is not important, but options for particular
+conversion algorithms must appear after the algorithm is selected
+(\fB-default\fP,\fB-negative\fP).  If you don't select an algorithm,
+\fBpnmtotiffcmyk\fP assumes \fB-default\fP and the appropriate
+options (\fB-theta\fP,\fB-gamma\fP,\fB-gammap\fP) can appear
+anywhere.
+
+.SS \fB-none\fP,\fB-packbits\fP,\fB-lzw\fP,\fB-predictor\fP
+.PP
+Tiff files can be compressed.  By default, \fBpnmtotiffcmyk\fP
+uses LZW decompression, but (apparently) some readers cannot read
+this, so you may want to select a different algorithm
+(\fB-none\fP,\fB-packbits\fP).  For LZW compression, a
+\fB-predictor\fP value of 2 forces horizontal differencing of
+scanlines before encoding; a value of 1 forces no differencing.
+
+.SS \fB-msb2lsb\fP,\fB-lsb2msb\fP
+.PP
+These options control fill order (default is \fB-msb2lsb\fP).
+
+.SS \fB-rowsperstrip\fP
+.PP
+This sets the number of rows in an image strip (data in the Tiff
+files generated by this program is stored in strips - each strip is
+compressed individually).  The default gives a strip size of no more
+than 8 kb.
+
+.SS \fB-lowdotrange\fP,\fB-highdotrange\fP
+.PP
+These options set tag values that may be useful for printers.
+
+.SS \fB-knormal\fP,\fB-kremove\fP,\fB-konly\fP
+.PP
+These options control the calculation of the CMYK ink levels.
+They are useful only for testing and debugging the code.
+.PP
+\fB-kremove\fP sets the black (K) levels to zero while leaving the
+other ink levels as they would be if the black level were normal.
+.PP
+\fB-konly\fP sets all inks to the normal black value.
+
+.SS \fB-default\fP,\fB-negative\fP
+.PP
+These options control what ink levels \fBpnmtotiffcmyk\fP uses to
+represent each input color.
+.PP
+\fB-negative\fP selects a simple algorithm that generates a color
+negative.  None of the following options apply to this algorithm.  The
+algorithm is included as an example in the source code to help
+implementors of other conversions.
+.PP
+\fB-default\fP is not necessary, unless you have to countermand a
+\fB-negative\fP on the same command line.  
+.PP
+The default conversion from RGB to CMYK is as follows: The basic
+values of the 3 pigments are C = 1-R, M = 1-G, Y = 1-B.  From this,
+\fBpnmtotiffcmyk\fP chooses a black (K) level which is the minimum of
+those three.  It then replaces that much of the 3 pigments with the
+black.  I.e. it subtracts K from each of the basic C, M, and Y
+values.
+.PP
+The options below modify this conversion.
+
+.SS \fB-theta\fP \fIdeg\fP
+.PP
+\fB-theta\fP provides a simple correction for any color bias that
+may occur in the printed image because, in practice, inks do not
+exactly complement the primary colors.  It rotates the colors (before
+black replacement) by \fIdeg\fP degrees in the color wheel.  Unless
+you are trying to produce unusual effects you will need to use small
+values.  Try generating three images at -10, 0 (the default) and 10
+degrees and see which has the best color balance.
+
+.SS \fB-gamma\fP \fIn\fP
+.PP
+\fB-gamma\fP applies a gamma correction to the black (K) value
+described above.  Specifically, instead of calculating the K value as
+min(C,M,Y), \fBpnmtotiffcmyk\fP raises that value (normalised to the
+range 0 to 1) to the \fIn\fPth power.  In practice, this means that a
+value greater than 1 makes the image lighter and a value less than 1
+makes the image darker.  The range of allowed values is 0.1 to 10.
+
+.SS \fB-gammap\fP \fIn\fP
+.PP
+This option controls the black replacement.
+.PP
+If you specify \fB-gammap\fP, \fBpnmtotiffcmyk\fP uses the specified
+gamma value in computing how much ink to remove from the 3 pigments, but
+still uses the regular gamma value (\fB-gamma\fP option) to generate the
+actual amount of black ink with which to replace it.
+.PP
+Values of \fIn\fP from 0.01 to 10 are valid.
+.PP
+For example, it may be best to only subtract black from the
+colored inks in the very darkest regions.  In that case, \fIn\fP
+should be a large value, such as 5.
+.PP
+As a special case, if \fIn\fP is -1, \fBpnmtotiffcmyk\fP does not
+remove any pigment (but still adds the black ink).  This means dark
+areas are even darker.  Furthermore, when printed, dark areas contain
+a lot of ink which can make high contrast areas, like lettering,
+appear fuzzy.  It's hard to see what the utility of this is.
+
+.UN seealso
+.SH SEE ALSO
+.BR "pamtotiff" (1)\c
+\&, 
+.BR "tifftopnm" (1)\c
+\&, 
+.BR "pnm" (1)\c
+\&
+
+.UN author
+.SH AUTHOR
+
+Copyright (c) 1999 Andrew Cooke (Jara Software).  Released under the
+GPL with no warranty.  See source or COPYRIGHT and LICENCE files in
+distribution for full details.
+
+Much of the code uses ideas from other Netpbm programs, written by Jef
+Poskanzer (thanks go to him and libtiff maintainer Sam Leffler).  A
+small section of the code - some of the tiff tag settings - is derived
+directly from pnmtotiff, by Jef Poskanzer, which, in turn,
+acknowledges Patrick Naughton with the following text:
+
+.RS
+.PP
+Derived by Jef Poskanzer from ras2tif.c, which is:
+.PP
+Copyright (c) 1990 by Sun Microsystems, Inc.
+.PP
+Author: Patrick J. Naughton
+\fInaughton@wind.sun.com\fP
+.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.
+.PP
+This file is provided AS IS with no warranties of any kind.  The
+author shall have no liability with respect to the infringement of
+copyrights, trade secrets or any patents by this file or any part
+thereof.  In no event will the author be liable for any lost revenue
+or profits or other special, indirect and consequential damages.
+
+.RE
+.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/pnmtotiffcmyk.html
+.PP
+\ No newline at end of file