Formatting updates. Added default values. Minor fixes.

doc/gamma4scanimage.man

@@ -1,15 +1,16 @@
-.TH gamma4scanimage 1 "18 august 2002"
+.TH gamma4scanimage 1 "11 Sep 2002"
-.IX sane-umax
+.IX gamma4scanimage
-
 .SH NAME
-gamma4scanimage
+gamma4scanimage - create a gamma table for scanimage
-
+.SH SYNOPSIS
-.SH ABOUT THIS FILE
+.B gamma4scanimage 
-
+.I gamma
-This file gives a short information about the usage and options of gamma4scanimage
+.RI [ shadow 
+.RI [ highlight
+.RI [ maxin
+.RI [ maxout ]]]]
 
 .SH DESCRIPTION
-
 The tool
 .B gamma4scanimage
 creates a gamma table in the format expected by scanimage. You can define a
@@ -18,47 +19,45 @@ a
 .BR shadow
 and a
 .BR highlight
-value. You also have to specify the size (
+value. You also can specify the size
-.BR maxin
+.RB ( maxin )
-) and maximum output value (
+and maximum output value
-.BR maxout
+.RB ( maxout )
-)
 of the gamma table.
-
+.PP
-Usage: gamma4scanimage gamma [shadow [highlight [maxin [maxout]]]]
-
 .BR gamma
-is a floating point value, neutral value is 1.0, if the value is larger than 1.0
+is a floating point value, neutral value is 1.0, if the value is larger than
-then the image gets brighter.
+1.0 then the image gets brighter.
-
+.PP
 .BR shadow
-defines the minmum input value that is necessary to create an output value larger than zero.
+defines the minmum input value that is necessary to create an output value
-shadow has to be in the range [0..maxin].
+larger than zero.  shadow has to be in the range [0..maxin]. Its default value
-
+is 0.
+.PP
 .BR highlight
-defines the maximum input value that produces an output value smaller than maxout.
+defines the maximum input value that produces an output value smaller than
-highlight has to be in the range [0..maxin], highlight has to be larger than shadow.
+maxout.  highlight has to be in the range [0..maxin], highlight has to be
-
+larger than shadow. Its default value is the same as maxin (16383 if not set).
+.PP
 .BR maxin
 defines the size of the gamma table. The size depends on the scanner/backend.
-If the scanner uses 8 bits gamma input then maxin has to be set to 255, for 10 bits 
+If the scanner uses 8 bits gamma input then maxin has to be set to 255, for 10
-1023, for 12 bits 4095, for 14 bits 16383. The default is 16383.
+bits 1023, for 12 bits 4095, for 14 bits 16383. The default is 16383.  To find
-To find out what value maxin has to be call scanimage with a very large gamma table
+out what value maxin has to be call scanimage with a very large gamma table
-[0]0-99999[255] then scanimage prints an error message with the needed size of the
+[0]0-[99999]255 then scanimage prints an error message with the needed size of
-gamma table.
+the gamma table.
-
+.PP
 .BR maxout
-defines the maximum output value. Take a look at the output of scanimage -h to find out
+defines the maximum output value. Take a look at the output of scanimage -h to
-what maxout has to be.
+find out what maxout has to be. The default value is 255.
-
+.PP
-.SH Example:
+.SH EXAMPLE
 scanimage --custom-gamma=yes --gamma-table `gamma4scanimage 1.8 0 11500 16383 255` >image.pnm
 
 .SH SEE ALSO
 scanimage(7)
 
 .SH AUTHOR
-
 Oliver Rauch
 
 .SH EMAIL-CONTACT