From e2e68a06d17d0c373624246f659d5e86b5e679e3 Mon Sep 17 00:00:00 2001 From: Henning Geinitz Date: Tue, 19 Nov 2002 16:07:48 +0000 Subject: [PATCH] Minor adjustments, added headers, fixed \- bug. --- ChangeLog | 2 + doc/sane-find-scanner.man | 86 ++++++++++++++++++++++++--------------- 2 files changed, 56 insertions(+), 32 deletions(-) diff --git a/ChangeLog b/ChangeLog index 55646d096..ed7b76fed 100644 --- a/ChangeLog +++ b/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 diff --git a/doc/sane-find-scanner.man b/doc/sane-find-scanner.man index b2b719907..af43a7cd7 100644 --- a/doc/sane-find-scanner.man +++ b/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 [\-v] -.RB [\-q] -.RB [\-f] -.RI [devname] +.RB [ \-h | \-? ] +.RB [ \-v ] +.RB [ \-q ] +.RB [ \-f ] +.RI [ devname ] + .SH DESCRIPTION .B sane-find-scanner -is a command-line tool to find SCSI and some USB scanners and determine their -Unix device files. It's part of the sane-backends package. +is a command-line tool to find SCSI and USB scanners and determine their Unix +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 -/dev/scanner. 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 sane-find-scanner will find any SCSI scanner connected -to those default device files even if it isn't supported by any SANE backend. +scanners, it checks the default generic SCSI device files (e.g., +.IR /dev/sg0 ) +and +.IR /dev/scanner . +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), -/dev/usb/scanner, and /dev/usbscanner are tested. The files are opened and the -vendor and device ids are determined if the operating system supports this -feature. Currently USB scanners are only found this way if they are supported -by the Linux scanner module or the FreeBSD or OpenBSD uscanner driver. After -that test, 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. sane-find-scanner will even find USB scanners, that are not supported -by any SANE backend. +scanners, first the USB kernel scanner device files (e.g. +.IR /dev/usb/scanner0 ), +.IR /dev/usb/scanner , +and +.IR /dev/usbscanner ) +are tested. The files are opened and the vendor and device ids are determined, +if the operating system supports this feature. Currently USB scanners are only +found this way if they are supported by the Linux scanner module or the +FreeBSD or OpenBSD uscanner driver. After that test, +.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 -port scanners, or scanners connected to proprietary ports. +.B sane-find-scanner +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 -the test result. If used twice, SCSI inquiry information and the USB device -descriptors are also printed. +Verbose output. If used once, +.B sane-find-scanner +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), -sane-"backendname"(5) +.BR sane (7), +.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