2002-01-21 Oliver Rauch <Oliver.Rauch@rauch-domain.de>

* doc/sane-umax.man, backend/umax.conf:
          added new umax.conf options and explaination

backend/umax.conf

@@ -9,6 +9,7 @@
 #option execute-request-sense 0
 #option force-preview-bit-rgb 0
 #option lamp-control-available 0
+#option gamma-lsb-padded 0
 #
 # linux device identification:
 #scsi vendor model type bus channel id lun

doc/sane-umax.man

@@ -27,9 +27,6 @@ Its contents is a list of device names that correspond to UMAX and UMAX compatib
 and lines starting with a hash mark (#) are ignored. A sample configuration file is
 shown below: 
 
- #scsi Vendor Model Type Bus Channel ID LUN 
- scsi UMAX * Scanner * * * * * 
- /dev/scanner 
  # this is a comment
  #
  option scsi-maxqueue 4
@@ -47,10 +44,23 @@ shown below:
  option calibration-bytes-pixel -1
  option invert-shading-data -1 
  option lamp-control-available 0
+ option gamma-lsb-padded 0
  /dev/sge 
 
+ #scsi Vendor Model Type Bus Channel ID LUN 
+ # The following scanner supports lamp control
+ option lamp-control-available 1
+ scsi UMAX * Scanner * * * * * 
+
+ # scanner on /dev/scanner does not support lamp control
+ option lamp-control-available 0
+ /dev/scanner 
+
  - execute-request-sense:
-   values: 0=disabled, 1=enabled, default=0
+   values:
+    0 = disabled
+    1 = enabled
+   default = 0
    If set to 1 umax_do_request_sense is called in
    umax_do_calibration. This can hang the system
    (but has been enabled until this version)
@@ -74,18 +84,29 @@ shown below:
    into one buffer
  
  - force-preview-bit-rgb:
-   values: 0=disabled, 1=enabled, default=0
+   values:
+    0 = disabled
+    1 = enabled
+   default = 0
    set preview bit in rgb real scan
  
  - slow-speed, care-about-smearing:
-   values: -1=auto, 0=disabled, 1=enabled, default=-1
+   values:
+   -1 = auto
+    0 = disabled
+    1 = enabled
+   default = -1
    dangerous options, needed for some scanners
    do not changed these options until you really know
    what you do, you may destroy your scanner when you
    define wrong values for this options
  
  - calibration-full-ccd:
-   values: -1=auto, 0=disabled, 1=enabled, default=-1
+   values:
+   -1 = auto
+    0 = disabled
+    1 = enabled
+   default = -1
    do calibration for each pixel of ccd instead of
    selected image
  
@@ -95,27 +116,46 @@ shown below:
    image/ccd
  
  - calibration-bytes-pixel:
-   values: -1=disabled, 0=not set, 1=1 byte/pixel,
-   2=x bytes/pixel
+   values:
+   -1 = disabled
+    0 = not set
+    1 = 1 byte/pixel,
+    2 = 2 bytes/pixel
    use # bytes per pixel for calibration
  
  - invert-shading-data:
-   values: -1=auto, 0=disabled, 1=enabled, default=-1
-   invert shading data before sending it back to the
-   scanner
+   values:
+   -1 = automatically set by driver - if known
+    0 = disabled
+    1 = enabled
+   default = -1
+   invert shading data before sending it back to the scanner
  
  - lamp-control-available:
-   values: 0=automatically set by driver - if known,
-   1=available, default=0
+   values:
+    0 = automatically set by driver - if known
+    1 = available
+   default = 0
+
+ - gamma-lsb-padded:
+   values:
+   -1 = automatically set by driver - if known
+    0 = gamma data is msb padded
+    1 = gamma data is lsb padded
+   default = -1
 
  - handle-bad-sense-error:
-   values: 0=handle as device busy, 1=handle as ok,
-   2=handle as i/o error, 3=ignore bad error code - continue sense handler,
-   default=0
+   values:
+    0 = handle as device busy
+    1 = handle as ok
+    2 = handle as i/o error
+    3 = ignore bad error code - continue sense handler,
+   default = 0
 
  - scsi-maxqueue:
-   values: 1..# (maximum defined at compile time).
-   default=2
+   values:
+    1..# (maximum defined at compile time)
+   default = 2
    most scsi drivers allow internal command queueing with a depth
    of 2 commands. In most cases it does not mprove anything when you
    increase this value. When your scsi driver does not support any