Minor adjustments, added headers, fixed \- bug.

ChangeLog

@@ -3,6 +3,8 @@
 	* doc/sane-usb.man: Added quick start section. New structure/order.
 	  Added list of backends that don't use sanei_usb. Added headers
 	  and fixed \- bug.
+	* doc/sane-find-scanner.man: Minor adjustments, added headers, fixed
+	  \- bug.
 
 2002-11-18  Frank Zago  <fzago at austin dot rr dot com>
 

doc/sane-find-scanner.man

@@ -1,42 +1,55 @@
-.TH sane-find-scanner 1 "15 Sep 2002"
+.TH sane-find-scanner 1 "15 Sep 2002" @PACKAGEVERSION@ "SANE Scanner Access Now Easy"
 .IX sane-find-scanner
 .SH NAME
-sane-find-scanner - find SCSI and USB scanners and their device files
+sane-find-scanner \- find SCSI and USB scanners and their device files
 .SH SYNOPSIS
 .B sane-find-scanner
-.RB [\-h|\-?]
+.RB [ \-h | \-? ]
-.RB [\-v]
+.RB [ \-v ]
-.RB [\-q]
+.RB [ \-q ]
-.RB [\-f]
+.RB [ \-f ]
-.RI [devname]
+.RI [ devname ]
+
 .SH DESCRIPTION
 .B sane-find-scanner
-is a command-line tool to find SCSI and some USB scanners and determine their
+is a command-line tool to find SCSI and USB scanners and determine their Unix
-Unix device files. It's part of the sane-backends package.
+device files. Its primary aim is to make sure that scanners can be detected by
+SANE backends.
 .PP
 For 
 .B SCSI
-scanners, it checks the default generic SCSI device files (e.g., /dev/sg0) and
+scanners, it checks the default generic SCSI device files (e.g., 
-/dev/scanner. The test is done by sending a SCSI inquiry command and looking
+.IR /dev/sg0 )
-for a device type of "scanner" or "processor" (some old HP scanners seem to
+and 
-send "processor"). So sane-find-scanner will find any SCSI scanner connected
+.IR /dev/scanner .
-to those default device files even if it isn't supported by any SANE backend.
+The test is done by sending a SCSI inquiry command and looking for a device
+type of "scanner" or "processor" (some old HP scanners seem to send
+"processor"). So 
+.B sane-find-scanner
+will find any SCSI scanner connected to those default device files even if it
+isn't supported by any SANE backend.
 .PP
 For
 .B USB
-scanners, first the USB kernel scanner device files (e.g. /dev/usb/scanner0),
+scanners, first the USB kernel scanner device files (e.g.
-/dev/usb/scanner, and /dev/usbscanner are tested. The files are opened and the
+.IR /dev/usb/scanner0 ),
-vendor and device ids are determined if the operating system supports this
+.IR /dev/usb/scanner ,
-feature. Currently USB scanners are only found this way if they are supported
+and
-by the Linux scanner module or the FreeBSD or OpenBSD uscanner driver. After
+.IR /dev/usbscanner )
-that test, sane-find-scanner tries to scan for USB devices found by the USB
+are tested. The files are opened and the vendor and device ids are determined,
-library libusb (if available). There is no special USB class for scanners, so
+if the operating system supports this feature. Currently USB scanners are only
-the heuristics used to distinguish scanners from other USB devices is not
+found this way if they are supported by the Linux scanner module or the
-perfect. sane-find-scanner will even find USB scanners, that are not supported
+FreeBSD or OpenBSD uscanner driver. After that test, 
-by any SANE backend.
+.B sane-find-scanner
+tries to scan for USB devices found by the USB library libusb (if
+available). There is no special USB class for scanners, so the heuristics used
+to distinguish scanners from other USB devices is not
+perfect. 
+.B sane-find-scanner
+will even find USB scanners, that are not supported by any SANE backend.
 .PP
-sane-find-scanner won't find parallel
+.B sane-find-scanner
-port scanners, or scanners connected to proprietary ports.
+won't find parallel port scanners, or scanners connected to proprietary ports.
 
 .SH OPTIONS
 .TP 8
@@ -44,16 +57,19 @@ port scanners, or scanners connected to proprietary ports.
 Prints a short usage message.
 .TP 8
 .B \-v
-Verbose output. If used once, sane-find-scanner shows every device name and
+Verbose output. If used once, 
-the test result.  If used twice, SCSI inquiry information and the USB device
+.B sane-find-scanner
-descriptors are also printed.
+shows every device name and the test result.  If used twice, SCSI inquiry
+information and the USB device descriptors are also printed.
 .TP 8
 .B \-q
 Be quiet. Print only the devices, no comments.
 .TP 8
 .B \-f
 Force opening all explicitely given devices as SCSI and USB devices. That's
-useful if sane-find-scanner is wrong in determing the device type.
+useful if 
+.B sane-find-scanner
+is wrong in determing the device type.
 .TP 8
 .B devname
 Test device file "devname". No other devices are checked if devname is given.
@@ -67,8 +83,14 @@ every device file.
 .br
 Look for a (SCSI) scanner only at /dev/scanner and print the result.
 .SH "SEE ALSO"
-sane(7), sane-scsi(5), sane-usb(5), scanimage(1), xscanimage(1), xsane(1),
+.BR sane (7),
-sane-"backendname"(5)
+.BR sane-scsi (5),
+.BR sane-usb (5),
+.BR scanimage(1),
+.BR xscanimage(1),
+.BR xsane(1),
+.BR sane-"backendname" (5)
+
 .SH AUTHOR
 Oliver Rauch, Henning Meier-Geinitz and others
 .SH SUPPORTED PLATFORMS