Merge branch 'release/debian/1.0.32-1'debian/1.0.32-1

1 files changed, 33 insertions, 28 deletions

diff --git a/doc/sane-stv680.man b/doc/sane-stv680.man
index 90cdf53..d4a8d3a 100644
--- a/doc/sane-stv680.man
+++ b/doc/sane-stv680.man
@@ -32,24 +32,32 @@ for the exact status of each camera.
 For startup of this backend check that if present the stv680 kernel module is
 removed or disabled.
 .br
-Also before using, enable the backend by editing the /etc/sane.d/dll.conf file,
-change #stv680 to stv680.
+Also before using, enable the backend by editing the
+.I @CONFIGDIR@/dll.conf
+file, change #stv680 to stv680.
 
-For problems with the untested cameras, you
-should contact the author for that.
+For problems with the untested cameras, you should contact the author for that.
 
 The options the backend supports can either be selected through
-command line options to programs like scanimage or through GUI
-elements in xcam. For both programs use the \-B option needed for size buffer.
+command line options to programs like
+.BR scanimage (1)
+or through GUI elements in
+.BR xcam (1).
+For both programs use the
+.B \-B
+option needed for size buffer.
 
 Some frontends examples:
+
 .br
-xcam
+.BR xcam (1)
 .RS
 xcam \-B
 .RE
 
-scanimage: for writing in batch mode to a file or to a new file each time.
+.BR scanimage (1):
+for writing in batch mode to a file or to a new file each time:
+
 .RS
 scanimage \-B \-d stv680:libusb:001:002 \-\-batch=out.ppm \-\-batch-count 5 \-\-mode "Color RGB"
 .RE
@@ -58,11 +66,12 @@ scanimage \-B \-d stv680:libusb:001:002 \-\-batch=out%d.ppm \-\-batch-count 5 \-
 .RE
 
 .br
-If you have any success with a camera not listed here, or if you have
+If you have any success with a camera not listed here, or if you observe
 any strange behavior, please report to the backend maintainer or to
 the SANE mailing list.
 
-Valid command line options and their syntax can be listed by using
+Valid command line options and their syntax can be listed by using:
+
 .RS
 scanimage \-\-help \-d stv680
 .RE
@@ -96,27 +105,27 @@ Bayer unshuffle, color correction, textline with date and time is added
 .B Enhancement options
 
 .TP
-.B \-\-white\-level\-r
+.B \-\-white\-level\-r \-32..+32
 Selects what red radiance level should be
 considered "white", when scanning some sheets by changing the calibration
 value loaded into the scanner. Scale \-32 .. 0 .. +32 in steps of 1.
 
 .TP
-.B \-\-white\-level\-g
+.B \-\-white\-level\-g \-32..+32
 Selects what green radiance level should be
 considered "white", when scanning some sheets by changing the calibration i
 value loaded into the scanner. Scale \-32 .. 0 .. +32 in steps of 1.
 
 .TP
-.B \-\-white\-level\-b
+.B \-\-white\-level\-b \-32..+32
 Selects what blue radiance level should be
 considered "white", when scanning some sheets by changing the calibration
 value loaded into the scanner. Scale \-32 .. 0 .. +32 in steps of 1.
 
 .SH CONFIGURATION FILE
-The configuration file @CONFIGDIR@/stv680.conf supports only one
-information: the device name to use (eg usb 0x.... 0x....).
-
+The configuration file
+.I @CONFIGDIR@/stv680.conf
+supports only one item: the device name to use (eg usb 0x.... 0x....).
 
 .SH FILES
 .TP
@@ -127,7 +136,6 @@ The static library implementing this backend.
 The shared library implementing this backend (present on systems that
 support dynamic loading).
 
-
 .SH ENVIRONMENT
 .TP
 .B SANE_DEBUG_STV680
@@ -141,9 +149,7 @@ The windows TWAIN driver has many more options than this SANE
 backend. However they are only software adjustments. This backend only
 implements what the webcam can support.
 
-
 .SH BUGS
-
 .TP
 Plenty. Parts of this backend are still under development.
 1. Some untested cameras.
@@ -154,22 +160,21 @@ Plenty. Parts of this backend are still under development.
 
 
 .SH "SEE ALSO"
-
-sane\-usb(5), scanimage(1), xcam(1), sane(7)
-
+.BR sane(7),
+.BR sane\-usb (5),
+.BR scanimage (1),
+.BR xcam (1)
 
 .SH AUTHORS
-
-Gerard Klaver http://gkall.hobby.nl/stv680-aiptek.html
-
-
+Gerard Klaver
+.I http://gkall.hobby.nl/stv680-aiptek.html
 
 .SH CREDITS
-
 .TP
 Thanks to developers of the other stv680 programs:
 STV680 kernel module
 .br
 pencam2 program
 .br
-libghoto2 program (camlib stv0680)
+.BR libghoto2 (3)
+program (camlib stv0680)