diff --git a/doc/sane-abaton.man b/doc/sane-abaton.man index 13c3c6b45..8765dadae 100644 --- a/doc/sane-abaton.man +++ b/doc/sane-abaton.man @@ -78,7 +78,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-agfafocus.man b/doc/sane-agfafocus.man index 53b2d375e..f9abb04b0 100644 --- a/doc/sane-agfafocus.man +++ b/doc/sane-agfafocus.man @@ -47,9 +47,9 @@ This backend expects device names of the form: .I special .RE .PP -Where +where .I special -is either the path-name for the special device that corresponds to a +is the path-name for the special device that corresponds to a SCSI scanner. For SCSI scanners, the special device name must be a generic SCSI device or a symlink to such a device. Under Linux, such a device name could be @@ -93,7 +93,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-apple.man b/doc/sane-apple.man index 0c057fb27..ef7d4ce05 100644 --- a/doc/sane-apple.man +++ b/doc/sane-apple.man @@ -35,9 +35,9 @@ This backend expects device names of the form: .I special .RE .PP -Where +where .I special -is either the path-name for the special device that corresponds to a +is the path-name for the special device that corresponds to a SCSI scanner. For SCSI scanners, the special device name must be a generic SCSI device or a symlink to such a device. Under Linux, such a device name could be @@ -85,7 +85,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable is list of directories where SANE looks -for the configuration file. Under UNIX directory names are +for the configuration file. On *NIX systems, directory names are separated by a colon (`:'), under OS/2 by a semi-colon (`;'). If SANE_CONFIG_DIR is not set, SANE defaults to searching the current working directory (".") and then diff --git a/doc/sane-artec.man b/doc/sane-artec.man index a738660f8..d61273246 100644 --- a/doc/sane-artec.man +++ b/doc/sane-artec.man @@ -79,7 +79,7 @@ model AT3 .SH SCSI ADAPTER TIPS Some Artec scanners come with an included SCSI adapter. If your scanner came -with a DTC ISA scsi cards, you can probably use it with recent (>= 2.2.0) +with a DTC ISA SCSI cards, you can probably use it with recent (>= 2.2.0) kernels using the generic NCR5380 support. You must pass the following boot argument to the kernel: "dtc3181e=0x2c0,0" .br @@ -104,11 +104,11 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are -separated by a colon (`:'), under OS/2, they are separated by a semi- -colon (`;'). If this variable is not set, the configuration file is -searched in two default directories: first, the current working direc- -tory (".") and then in +contain the configuration file. On *NIX systems, the directories are +separated by a colon (`:'), under OS/2, they are separated by a +semi-colon (`;'). If this variable is not set, the configuration file is +searched in two default directories: first, the current working +directory (".") and then in .IR @CONFIGDIR@ . If the value of the environment variable ends with the directory separator character, then diff --git a/doc/sane-artec_eplus48u.man b/doc/sane-artec_eplus48u.man index 70f4254a2..fa6fe7f56 100644 --- a/doc/sane-artec_eplus48u.man +++ b/doc/sane-artec_eplus48u.man @@ -6,7 +6,7 @@ The .B sane\-artec_eplus48u library implements a SANE (Scanner Access Now Easy) backend that provides access to several USB flatbed scanners using the GT6816 chipset like the Artec E+ 48U. -These scanners have a contact image sensor (CIS) and an USB interface. +These scanners have a contact image sensor (CIS). .PP A complete list of supported devices can be found on .IR http://www.sane\-project.org/sane\-supported\-devices.html . @@ -57,10 +57,9 @@ autodetected by .I usb vendor_id product_id statements which are already included into .I artec_eplus48u.conf . -"vendor_id" and "product_id" are hexadecimal numbers that identify the -.B scanner. +"vendor_id" and "product_id" are hexadecimal numbers that identify the scanner. .PP -Every usb section can have additional options +Every usb section can have additional options. .TP .B artecFirmwareFile @DATADIR@/sane/artec_eplus48u/Artec48.usb The path to the firmware file. This option is required. @@ -86,8 +85,9 @@ then the gamma options are reset to the values specified here. .B greenExposure 0x116 .TP .B blueExposure 0xdc -These are the default values for offset and exposure time. You can e.g. change them to speed up calibration, -if you don't want to save the calibration data to disk. +These are the default values for offset and exposure time. +You can change them (e.g. to speed up calibration) +if you don't want to save the calibration data permanently. .TP .B vendorString "Artec" .TP @@ -111,7 +111,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-avision.man b/doc/sane-avision.man index 517ac1b7a..9aae5e107 100644 --- a/doc/sane-avision.man +++ b/doc/sane-avision.man @@ -2,7 +2,7 @@ .IX sane\-avision .SH NAME -sane\-avision \- SANE backend for original Avision and Avision OEM scanners +sane\-avision \- SANE backend for Avision branded and Avision OEM (HP, Minolta, Mitsubishi, UMAX and possibly more) flatbed and film scanners. .SH DESCRIPTION @@ -16,7 +16,7 @@ It is fully big-endian aware and in everyday use on PowerPC and SPARC systems. .B I suggest you hold one hand on the power-button of the scanner while -you try the first scans \- especially with film-scanners! +.B you try the first scans \- especially with film-scanners! .SH CONFIGURATION @@ -69,19 +69,19 @@ respond. .TP disable\-gamma\-table: Disables the usage of the scanner's gamma-table. You -might try this if your scans hang or only produces +might try this if your scans hang or only produce random garbage. .TP disable\-calibration: Disables the scanner's color calibration. You -might try this if your scans hang or only produces +might try this if your scans hang or only produce random garbage. .TP Note: Any option above modifies the default code-flow for your scanner. The options should only be used -when you encounter problems with the default be- -haviour of the backend. Please report the need of +when you encounter problems with the default behavior +of the backend. Please report the need of options to the backend-author so the backend can be fixed as soon as possible. @@ -146,7 +146,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-bh.man b/doc/sane-bh.man index de1336e95..218fd39b4 100644 --- a/doc/sane-bh.man +++ b/doc/sane-bh.man @@ -418,7 +418,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-canon.man b/doc/sane-canon.man index 6cc23a594..7d181f206 100644 --- a/doc/sane-canon.man +++ b/doc/sane-canon.man @@ -74,7 +74,7 @@ image data are exported without corrections as 16-bit intensities; this mode can be recommended if extensive adjustments have to be made to a picture (and if the frontend can handle 16-bit intensities). .PP -Negatives are handled by simple color inversion and may require manual +Negatives are handled by simple color inversion and will require manual removal of blue discoloration. .PP .SH FILES diff --git a/doc/sane-canon630u.man b/doc/sane-canon630u.man index f569695a5..73bb3bd37 100644 --- a/doc/sane-canon630u.man +++ b/doc/sane-canon630u.man @@ -40,7 +40,7 @@ for details. .PP This product-specific scanner driver uses the lower-level kernel USB driver "scanner". Check for "Driver=usbscanner" under -.IR /proc/bus/usb/devices. +.IR /proc/bus/usb/devices . If "Driver=(none)", try forcing it with .I "insmod scanner vendor=0x04a9 product=0x2204" .SH NOTES @@ -56,12 +56,12 @@ kernel 2.4.12 or later. Some users have reported that this driver doesn't work at all. This seems to be a hardware specific issue, although I dsane\-uson't know what exactly the problem is. If you are having problems, please send me the info in -.IR /proc/bus/usb/devices, -.IR /proc/pci, +.IR /proc/bus/usb/devices , +.IR /proc/pci , the kernel .I scanner.c driver version from -.IR /var/log/messages, +.IR /var/log/messages , and the output from .I "SANE_DEBUG_CANON630U=12 scanimage > /dev/null" .PP @@ -87,7 +87,7 @@ Deleting this file will force recalibration. .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-canon_dr.man b/doc/sane-canon_dr.man index 353045077..1704291b3 100644 --- a/doc/sane-canon_dr.man +++ b/doc/sane-canon_dr.man @@ -55,7 +55,8 @@ by some frontends. .TP .B \-\-page\-width, \-\-page\-height Sets paper size. Used by scanner to determine centering of scan -coordinates when using ADF and to detect double feed errors. +coordinates when using the ADF (Automatic Document Feeder) and +to detect double feed errors. .PP Other options will be available based on the capabilities of the scanner: diff --git a/doc/sane-canon_pp.man b/doc/sane-canon_pp.man index 72a938166..6889c050c 100644 --- a/doc/sane-canon_pp.man +++ b/doc/sane-canon_pp.man @@ -132,7 +132,7 @@ dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may contain -the configuration file. Under UNIX, the directories are separated by a colon +the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working directory (".") and then in diff --git a/doc/sane-coolscan2.man b/doc/sane-coolscan2.man index c80103411..84e8a93dc 100644 --- a/doc/sane-coolscan2.man +++ b/doc/sane-coolscan2.man @@ -85,7 +85,7 @@ with no options altered. The backend must not be restarted between the scans. If you use .BR scanimage (1), perform a batch scan with -.B batch\-count=2 +.B \-\-batch\-count=2 to obtain the IR information. .TP .B \-\-depth @@ -115,15 +115,17 @@ Multiply all exposure times with this value. This allows exposure correction without modifying white balance. .TP .B \-\-load -Load the next slide when using the slide loader. +Load the next slide when using the slide loader +(applies only to the SF\-200 bulk feeder). .TP .B \-\-eject Eject the film strip or mounted slide when using the slide loader. .TP .B \-\-reset Reset scanner. The scanner will perform the same action as when power is -turned on: it will eject the film strip and calibrate itself. Use this -whenever the scanner refuses to load a film strip properly, as a result of +turned on: it will eject the film strip (with the SF\-200 bulk feeder) +and calibrate itself. Use this whenever the scanner refuses to load +a film strip properly, as a result of which .B \-\-eject does not work. @@ -186,8 +188,9 @@ whenever the hardware changes. Thus the number of choices for the .B \-\-frame option will be fixed when the backend is initialized (usually when the user runs the frontend). In particular, if there is no film strip in the -automatic film strip feeder when the backend is initialized, the frame option -will not appear at all. Also, restarting the frontend after swapping film +automatic film strip feeder when the backend is initialized, the +.B \-\-frame +option will not appear at all. Also, restarting the frontend after swapping film adapters is strongly recommended. Linux kernels prior to 2.4.19 had a patch that truncated INQUIRY data diff --git a/doc/sane-coolscan3.man b/doc/sane-coolscan3.man index 17873b181..7c59f4347 100644 --- a/doc/sane-coolscan3.man +++ b/doc/sane-coolscan3.man @@ -83,7 +83,7 @@ If set to "yes", the scanner will read the infrared channel, thus allowing defect removal in software. The infrared image is read during a second scan, with no options altered. The backend must not be restarted between the scans. If you use scanimage, perform a batch scan with -.B batch\-count=2 +.B \-\-batch\-count=2 to obtain the IR information. .TP .B \-\-depth @@ -113,14 +113,15 @@ Multiply all exposure times with this value. This allows exposure correction without modifying white balance. .TP .B \-\-load -Load the next slide when using the slide loader (SF-200 only). +Load the next slide when using the slide loader (SF\-200 bulk loader only). .TP .B \-\-eject Eject the film strip or mounted slide when using the slide loader. .TP .B \-\-reset Reset scanner. The scanner will perform the same action as when power is -turned on: it will eject the film strip and calibrate itself. Use this +turned on: it will eject the film strip (with the SF\-200 bulk loader) +and calibrate itself. Use this whenever the scanner refuses to load a film strip properly, as a result of which .B \-\-eject @@ -142,7 +143,7 @@ These lines are ignored, thus '#' can be used to include comments. .TP .I containing only the word """auto""" This instructs the backend to probe for a scanner by scanning the buses for -devices with know identifiers. This is the action taken when no +devices with known identifiers. This is the default action when no configuration file is present. .TP .I a line of the form : @@ -175,8 +176,8 @@ levels reduce verbosity. .BR sane\-scsi (5), .BR sane\-usb (5), .BR scanimage (1), -.BR xscanimage(1), -.BR xsane(1) +.BR xscanimage (1), +.BR xsane (1) .SH BUGS Currently, the SANE protocol does not allow automatically updating options @@ -184,9 +185,10 @@ whenever the hardware changes. Thus the number of choices for the .B \-\-frame option will be fixed when the backend is initialized (usually when the user runs the frontend). In particular, if there is no film strip in the -automatic film strip feeder when the backend is initialized, the frame option -will not appear at all. Also, restarting the frontend after swapping film -adapters is strongly recommended. +automatic film strip feeder when the backend is initialized, the +.B \-\-frame +option will not appear at all. +Also, restarting the frontend after swapping film adapters is strongly recommended. Linux kernels prior to 2.4.19 had a patch that truncated INQUIRY data from IEEE 1394 scanners to 36 bytes, discarding vital information diff --git a/doc/sane-dc210.man b/doc/sane-dc210.man index 89e9e7240..a782aecc3 100644 --- a/doc/sane-dc210.man +++ b/doc/sane-dc210.man @@ -30,13 +30,13 @@ line causes some information about the camera to be printed. .PP .B cmdrespause -specifies how many usec (1,000,000ths of a) between -writing the command and reading the result should be used. 125000 -seems to be the lowest I could go reliably. +specifies how many usec (1,000,000ths of a second) to wait between +writing the command and reading the result. 125000 seems to be the +lowest I could go reliably. .PP .B breakpause -is the time in 1,000,000ths of a usec between sending the -"back to default" break sending commands. +specifies how many usec (1,000,000ths of a second) between sending the +"back to default" break and sending commands. .PP Empty lines and lines starting with a hash mark (#) are ignored. A sample configuration file is shown below: @@ -73,7 +73,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-dc240.man b/doc/sane-dc240.man index 27547c1d2..6d0e9b1c2 100644 --- a/doc/sane-dc240.man +++ b/doc/sane-dc240.man @@ -30,13 +30,13 @@ The line causes some information about the camera to be printed. .PP .B cmdrespause -specifies how many usec (1,000,000ths of a) between -writing the command and reading the result should be used. 125000 -seems to be the lowest I could go reliably. +specifies how many usec (1,000,000ths of a second) to wait between +writing the command and reading the result. 125000 seems to be the +lowest I could go reliably. .PP .B breakpause -is the time in 1,000,000ths of a usec between sending the -"back to default" break sending commands. +specifies how many usec (1,000,000ths of a second) between sending the +"back to default" break and sending commands. .PP Empty lines and lines starting with a hash mark (#) are ignored. A sample configuration file is shown below: @@ -73,7 +73,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working @@ -104,10 +104,16 @@ levels reduce verbosity. Peter S. Fales .PP -This backend borrows heavily from the dc210 backend by Brian J. Murrell -which is based somewhat on the dc25 backend by Peter Fales. +This backend borrows heavily from the +.BR sane\-dc210 (5) +backend by Brian J. Murrell +which is based somewhat on the +.BR sane\-dc25 (5) +backend by Peter Fales. .PP -The manpage was largely copied from the dc210 manpage. +The manpage was largely copied from the +.BR sane\-dc210 (5) +manpage. .SH BUGS The major limitation that I know of is that the backend assumes diff --git a/doc/sane-dc25.man b/doc/sane-dc25.man index 23f471781..160aa028c 100644 --- a/doc/sane-dc25.man +++ b/doc/sane-dc25.man @@ -61,7 +61,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-dll.man b/doc/sane-dll.man index aaa357782..b7f98c900 100644 --- a/doc/sane-dll.man +++ b/doc/sane-dll.man @@ -136,7 +136,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-dmc.man b/doc/sane-dmc.man index a076736ff..eee5e928d 100644 --- a/doc/sane-dmc.man +++ b/doc/sane-dmc.man @@ -102,7 +102,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-epsonds.man b/doc/sane-epsonds.man index a7c9e320a..e75dac659 100644 --- a/doc/sane-epsonds.man +++ b/doc/sane-epsonds.man @@ -111,4 +111,4 @@ a bug report. .SH AUTHOR -The package is written by Alessandro Zummo +The backend is written by Alessandro Zummo. diff --git a/doc/sane-find-scanner.man b/doc/sane-find-scanner.man index ae46369f6..22b17e334 100644 --- a/doc/sane-find-scanner.man +++ b/doc/sane-find-scanner.man @@ -35,7 +35,7 @@ isn't supported by any SANE backend. For .B USB scanners, first the USB kernel scanner device files (e.g. -.IR /dev/usb/scanner0 ), +.IR /dev/usb/scanner0 , .IR /dev/usb/scanner , and .IR /dev/usbscanner ) @@ -59,7 +59,7 @@ won't find most parallel port scanners, or scanners connected to proprietary ports. Some .B parallel port scanners may be detected by -.I sane\-find\-scanner -p. +.I "sane\-find\-scanner -p" . At the time of writing this will only detect Mustek parallel port scanners. .SH OPTIONS diff --git a/doc/sane-fujitsu.man b/doc/sane-fujitsu.man index a633e14e0..4db6d41ff 100644 --- a/doc/sane-fujitsu.man +++ b/doc/sane-fujitsu.man @@ -83,7 +83,8 @@ by some frontends. .B page\-width, page\-height .RS Sets paper size. Used by scanner to determine centering of scan -coordinates when using ADF and to detect double feed errors. +coordinates when using the ADF (Automatic Document Feeder) and to detect +double feed errors. .RE .PP Other options will be available based on the capabilities of the scanner: diff --git a/doc/sane-genesys.man b/doc/sane-genesys.man index cf4fa38c6..85b80ffb2 100644 --- a/doc/sane-genesys.man +++ b/doc/sane-genesys.man @@ -196,7 +196,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-gphoto2.man b/doc/sane-gphoto2.man index d98387ed9..2b2d66f3d 100644 --- a/doc/sane-gphoto2.man +++ b/doc/sane-gphoto2.man @@ -91,7 +91,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working @@ -122,15 +122,18 @@ Set to 1, 2, or 3, to enable various levels of debugging within the gphoto2 libraries. .SH "SEE ALSO" -.BR sane (7) -.BR scanimage (1) -.BR xscanimage (1) +.BR sane (7) , +.BR scanimage (1) , +.BR xscanimage (1) , +.BR libgphoto2 (3) .SH AUTHOR Peter S. Fales .PP -The manpage was largely copied from the dc210 manpage. +The manpage was largely copied from the +.BR sane\-dc210 (5) +manpage. .SH BUGS Many, no doubt. diff --git a/doc/sane-gt68xx.man b/doc/sane-gt68xx.man index 8a1cff94d..62bd04584 100644 --- a/doc/sane-gt68xx.man +++ b/doc/sane-gt68xx.man @@ -31,7 +31,7 @@ following web page: Please use libusb-0.1.8 or later. Without libusb or with older libusb versions all kinds of trouble can be expected. The scanner should be found by .BR sane\-find\-scanner (1) -without further actions. For setting permissions and general USB information looks at +without further actions. For setting permissions and general USB information, look at .BR sane\-usb (5). .PP @@ -44,7 +44,8 @@ It comes on the installation CD that was provided by the manufacturer, but it may be packaged together with the installation program in an .exe file. For Mustek scanners, the file can be downloaded from the gt68xx backend homepage. For other scanners, check the CD for .usb files. If you only find *.cab files, try -cabextract to unpack. If everything else fails, you must install the Windows +.BR cabextract (1) +to unpack. If everything else fails, you must install the Windows driver and get the firmware from there (usually in the .I windows/system or @@ -159,7 +160,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working @@ -195,7 +196,8 @@ export SANE_DEBUG_GT68XX=4 .BR sane\-ma1509 (5), .BR sane\-mustek_usb (5), .BR sane\-mustek (5), -.BR sane\-mustek_pp (5) +.BR sane\-mustek_pp (5), +.BR cabextract (1) .br .I @DOCDIR@/gt68xx/gt68xx.CHANGES .br diff --git a/doc/sane-hp.man b/doc/sane-hp.man index 7a6fa1461..d0b0ff851 100644 --- a/doc/sane-hp.man +++ b/doc/sane-hp.man @@ -192,7 +192,7 @@ changed to 'print media'. .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-hp3900.man b/doc/sane-hp3900.man index 4c2e56287..2afbdc0ee 100644 --- a/doc/sane-hp3900.man +++ b/doc/sane-hp3900.man @@ -27,7 +27,7 @@ BenQ 5550 RTS8823L-01E * .RE .PP More details can be found on the -.BR sane\-hp3900 (1) +.BR sane\-hp3900 (5) backend homepage .IR http://sourceforge.net/projects/hp3900\-series/ . .PP @@ -77,7 +77,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-hp4200.man b/doc/sane-hp4200.man index 7d92cdedb..bc0fe5869 100644 --- a/doc/sane-hp4200.man +++ b/doc/sane-hp4200.man @@ -64,7 +64,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-hp5400.man b/doc/sane-hp5400.man index 4738c08e2..e0752daad 100644 --- a/doc/sane-hp5400.man +++ b/doc/sane-hp5400.man @@ -64,7 +64,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-hpsj5s.man b/doc/sane-hpsj5s.man index aae2f51b0..56a940b16 100644 --- a/doc/sane-hpsj5s.man +++ b/doc/sane-hpsj5s.man @@ -19,7 +19,7 @@ is due to dependence on the .BR libieee1284 (3) library. If your system supports .BR libieee1284 (3) -too,this backend should work. If you ported +too, this backend should work. If you ported .BR libieee1284 (3) for your platform, please let me know. Your system should support .B EPP @@ -61,10 +61,10 @@ for this moment. Future versions will support daisy chain selection. .SH TIPS .PP It seems that HP ScanJet 5S scanner uses software noise correction. This -feature is not implemented for now. So does gamma correction and calibration. -I'll handle it in future versions. -Native resolution for this scanner is 300 DPI. Other modes could be jagged in some -ways. +feature, along with gamma correction and calibration, are not implemented for now. +They will be handled in future versions. +Native resolution for this scanner is 300 DPI. +Other modes may present aliasing artifacts. .PP .SH FILES .TP @@ -83,7 +83,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-hs2p.man b/doc/sane-hs2p.man index fcbdae105..1b3929664 100644 --- a/doc/sane-hs2p.man +++ b/doc/sane-hs2p.man @@ -23,7 +23,7 @@ This backend expects device names of the form: .PP Where .I special -is either the path-name for the special device that corresponds to a SCSI +is the path-name for the special device that corresponds to a SCSI scanner. The program .BR sane\-find\-scanner (1) helps to find out the correct device. Under Linux, such a device name could be @@ -60,7 +60,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-ibm.man b/doc/sane-ibm.man index 1ecb28595..677de8f33 100644 --- a/doc/sane-ibm.man +++ b/doc/sane-ibm.man @@ -23,7 +23,7 @@ This backend expects device names of the form: .PP Where .I special -is either the path-name for the special device that corresponds to a SCSI +is the path-name for the special device that corresponds to a SCSI scanner. The program .BR sane\-find\-scanner (1) helps to find out the correct device. Under Linux, such a device name could be @@ -60,7 +60,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-kodak.man b/doc/sane-kodak.man index 9b89c2b93..3261f6842 100644 --- a/doc/sane-kodak.man +++ b/doc/sane-kodak.man @@ -59,7 +59,8 @@ by some frontends. .BR --page\-width ", " --page\-height .RS Sets paper size. Used by scanner to determine centering of scan -coordinates when using ADF and to detect double feed errors. +coordinates when using the ADF (Automatic Document Feeder) and to +detect double feed errors. .RE .PP Other options will be available based on the capabilities of the scanner. @@ -133,7 +134,7 @@ which enables debugging output to stderr. Valid values are: .SH KNOWN ISSUES Most hardware options are either not supported or not exposed for control by the user, including: multifeed detection, image compression, autocropping, -endorser, iThresholding, multi\-stream, etc. +endorser, thresholding, multi\-stream, etc. .PP .SH CREDITS diff --git a/doc/sane-kvs1025.man b/doc/sane-kvs1025.man index d366c0b33..c8e9631ed 100644 --- a/doc/sane-kvs1025.man +++ b/doc/sane-kvs1025.man @@ -24,7 +24,7 @@ sanei_usb instead of libusb by m. allan noah. The backend was tested on KV-S1025C and 1045C by Tiago Zaniquelli. .SH "SEE ALSO" -.BR sane (7) , +.BR sane (7), .BR sane\-usb (5) .SH AUTHOR diff --git a/doc/sane-leo.man b/doc/sane-leo.man index 00ec8fdac..b2548b751 100644 --- a/doc/sane-leo.man +++ b/doc/sane-leo.man @@ -46,15 +46,18 @@ scanimage \-\-help \-d leo .TP .B \-\-mode -selects the basic mode of operation of the scanner valid choices are -.I Black & White -, +selects the basic mode of operation of the scanner. Valid choices are +.IR "Black & White" , .I Grayscale and +.IR Color . +The +.I Black & White +mode is black and white only (1 bit). +.I Grayscale +mode will produce 256 levels of gray (8 bits). .I Color -The Black & White mode is black and white only (1 bit). Grayscale -will produce 256 levels of gray (8 bits). Color will produce a 24 bits -color image. +mode will produce a 24 bit color image. .TP .B \-\-resolution @@ -98,15 +101,12 @@ for the blue channel. The table must be 256 bytes long. .TP .B \-\-halftone (Black & White only) select the halftone mask to use. Possible values are -.I Diamond -, -.I 8x8 Coarse Fatting -, -.I 8x8 Fine Fatting -, +.IR Diamond , +.IR "8x8 Coarse Fatting" , +.IR "8x8 Fine Fatting" , .I 8x8 Bayer and -.I 8x8 Vertical Line +.IR "8x8 Vertical Line" . .TP .B \-\-preview @@ -147,7 +147,7 @@ backend. However they are only software adjustments. This backend only implements what the scanner can support. -SH BUGS +.SH BUGS None known. diff --git a/doc/sane-lexmark.man b/doc/sane-lexmark.man index 3ab9f8fa9..0f1fd6e52 100644 --- a/doc/sane-lexmark.man +++ b/doc/sane-lexmark.man @@ -55,14 +55,21 @@ scanimage \-\-help \-d lexmark:usb: .TP .B \-\-mode -selects the basic mode of operation of the scanner valid choices are +selects the basic mode of operation of the scanner. Valid choices are .IR Color , .I Gray and +.IR Lineart . +The default mode is +.IR Color . +The .I Lineart -The default mode is Color. The Lineart mode is black and white only (1 bit). -Grayscale will produce 256 levels of gray (8 bits). Color mode allows for over -16 million different colors produced from 24 bits of color information. +mode is black and white only (1 bit). +.I Gray +mode will produce 256 levels of gray (8 bits). +.I Color +mode allows for over 16 million different colors produced from 24 +bits of color information. .TP .B \-\-resolution diff --git a/doc/sane-ma1509.man b/doc/sane-ma1509.man index e6b3a7e98..06f384011 100644 --- a/doc/sane-ma1509.man +++ b/doc/sane-ma1509.man @@ -13,16 +13,17 @@ also work. This backend is ALPHA software. Be careful and remove the power plug immediately if your hear unusual noises. .PP -More details can be found on the ma1509 backend homepage +More details can be found on the +.B sane\-ma1509 +backend homepage .IR http://www.meier\-geinitz.de/sane/ma1509\-backend/ . .PP -Other Mustek USB scanners are supported by the gt68xx, mustek_usb and the -plustek backends. See +Other Mustek USB scanners are supported by the .BR sane\-mustek_usb (5), .BR sane\-gt68xx (5) and .BR sane\-plustek (5) -for details. +backends. .PP This backend can only work with scanners that are already detected by the operating system. See @@ -92,7 +93,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-magicolor.man b/doc/sane-magicolor.man index 8b2446a5e..19716e0f8 100644 --- a/doc/sane-magicolor.man +++ b/doc/sane-magicolor.man @@ -47,9 +47,15 @@ The shared library implementing this backend (present on systems that support dy .SH "ENVIRONMENT" .TP .B SANE_CONFIG_DIR -This environment variable specifies the list of directories that may contain the configuration file. Under UNIX, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi\-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working directory (".") and then in +This environment variable specifies the list of directories that may contain the +configuration file. On *NIX systems, the directories are separated by a +colon (`:'), under OS/2, they are separated by a semi\-colon (`;'). +If this variable is not set, the configuration file is searched in two +default directories: first, the current working directory (".") and then in .IR @CONFIGDIR@ . -If the value of the environment variable ends with the directory separator character, then the default directories are searched after the explicitly specified directories. For example, setting +If the value of the environment variable ends with the directory separator character, +then the default directories are searched after the explicitly specified directories. +For example, setting .B SANE_CONFIG_DIR to "/tmp/config:" would result in directories .IR "/tmp/config" , @@ -69,7 +75,7 @@ To obtain debug messages from the backend, set this environment variable before Example: SANE_DEBUG_MAGICOLOR=65 xscanimage .SH "KNOWN BUGS AND RESTRICTIONS" .PP -Large color scans may sometimes timeout due to unknown reasons (the scanner simply stops returning data) +Large color scans may sometimes timeout due to unknown reasons (the scanner simply stops returning data). .PP Cancelling large scans may lock up the scanner. diff --git a/doc/sane-microtek.man b/doc/sane-microtek.man index cb42aa3ed..674f0bdc0 100644 --- a/doc/sane-microtek.man +++ b/doc/sane-microtek.man @@ -131,7 +131,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-mustek.man b/doc/sane-mustek.man index 925e6d84a..45ea2d3f2 100644 --- a/doc/sane-mustek.man +++ b/doc/sane-mustek.man @@ -349,7 +349,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-mustek_pp.man b/doc/sane-mustek_pp.man index 8443306bf..0ab8e41c9 100644 --- a/doc/sane-mustek_pp.man +++ b/doc/sane-mustek_pp.man @@ -411,7 +411,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-mustek_usb.man b/doc/sane-mustek_usb.man index cea9e3676..105228ff8 100644 --- a/doc/sane-mustek_usb.man +++ b/doc/sane-mustek_usb.man @@ -136,7 +136,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-mustek_usb2.man b/doc/sane-mustek_usb2.man index 2ad7b24ec..cc96919f7 100644 --- a/doc/sane-mustek_usb2.man +++ b/doc/sane-mustek_usb2.man @@ -9,7 +9,9 @@ library implements a SANE (Scanner Access Now Easy) backend that provides access to USB flatbed scanners based on the Service & Quality SQ113 chipset. At the moment, only the Mustek BearPaw 2448 TA Pro is supported. It's planned to add support for other scanners that are based on the SQ113 and maybe SQ11 chip. For -more details, see the mustek_usb2 backend homepage: +more details, see the +.B sane\-mustek_usb2 +backend homepage: .IR http://www.meier\-geinitz.de/sane/mustek_usb2\-backend/ . .PP This is BETA software. Especially if you test new or untested scanners, keep @@ -28,7 +30,7 @@ Please use libusb-0.1.8 or later. Without libusb or with older libusb versions all kinds of trouble can be expected. The scanner should be found by .BR sane\-find\-scanner (1) without further actions. For setting permissions and general -USB information looks at +USB information, look at .BR sane\-usb (5). .PP diff --git a/doc/sane-net.man b/doc/sane-net.man index 0f62684b7..ee7e82ec4 100644 --- a/doc/sane-net.man +++ b/doc/sane-net.man @@ -119,7 +119,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-p5.man b/doc/sane-p5.man index dd1db03b5..80438e8cd 100644 --- a/doc/sane-p5.man +++ b/doc/sane-p5.man @@ -76,7 +76,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-pint.man b/doc/sane-pint.man index b6dd181c7..4fa7d2e73 100644 --- a/doc/sane-pint.man +++ b/doc/sane-pint.man @@ -73,7 +73,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-pixma.man b/doc/sane-pixma.man index 7640e6293..860c9a9a0 100644 --- a/doc/sane-pixma.man +++ b/doc/sane-pixma.man @@ -445,7 +445,7 @@ You should also set SANE_DEBUG_PIXMA to 11. .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-plustek.man b/doc/sane-plustek.man index c043072b9..50e2c6acd 100644 --- a/doc/sane-plustek.man +++ b/doc/sane-plustek.man @@ -444,7 +444,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working @@ -477,7 +477,7 @@ export SANE_DEBUG_PLUSTEK=10 .BR sane\-gt68xx (5), .BR sane-\mustek_pp (5), .BR sane\-find\-scanner (1), -.BR scanimage (1), +.BR scanimage (1) .br .I @DOCDIR@/plustek/Plustek-USB.changes diff --git a/doc/sane-plustek_pp.man b/doc/sane-plustek_pp.man index e225c95ec..2ef9b9672 100644 --- a/doc/sane-plustek_pp.man +++ b/doc/sane-plustek_pp.man @@ -435,7 +435,7 @@ The Linux kernelmodule for kernels >= 2.6.x. .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-qcam.man b/doc/sane-qcam.man index 30d2e8360..d809e09e5 100644 --- a/doc/sane-qcam.man +++ b/doc/sane-qcam.man @@ -60,7 +60,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-ricoh.man b/doc/sane-ricoh.man index 4006b4922..d0c61855f 100644 --- a/doc/sane-ricoh.man +++ b/doc/sane-ricoh.man @@ -54,7 +54,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-rts8891.man b/doc/sane-rts8891.man index 75c5ac135..95d028bcb 100644 --- a/doc/sane-rts8891.man +++ b/doc/sane-rts8891.man @@ -45,14 +45,21 @@ scanimage \-\-help \-d rts8891 .TP .B \-\-mode -selects the basic mode of operation of the scanner valid choices are -.IR "R Color" , +selects the basic mode of operation of the scanner. Valid choices are +.IR "Color" , .I Gray and +.IR Lineart . +The default mode is +.IR Color . +The .I Lineart -The default mode is Color. The Lineart mode is black and white only (1 bit). -Grayscale will produce 256 levels of gray (8 bits). Color mode allows for over -16 million different colors produced from 24 bits of color information. +mode is for black and white only (1 bit). +.I Gray +will produce 256 levels of gray (8 bits). +.I Color +mode allows for over 16 million different colors produced from +24 bits of color information. .TP .B \-\-resolution diff --git a/doc/sane-s9036.man b/doc/sane-s9036.man index 5065a3d56..f1e4020a8 100644 --- a/doc/sane-s9036.man +++ b/doc/sane-s9036.man @@ -47,7 +47,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-sharp.man b/doc/sane-sharp.man index 32009905f..34ad8cbc1 100644 --- a/doc/sane-sharp.man +++ b/doc/sane-sharp.man @@ -50,15 +50,17 @@ This backend expects device names of the form: .I special .RE .PP -Where +where .I special -is either the path-name for the special device that corresponds to a +is the path-name for the special device that corresponds to a SCSI scanner. The special device name must be a generic SCSI device or a symlink to such a device. Under Linux, such a device name could be .I /dev/sga or .IR /dev/sge , -for example. See sane\-scsi(5) for details. +for example. See +.BR sane\-scsi (5) +for details. .SH SCAN OPTIONS .TP diff --git a/doc/sane-sm3600.man b/doc/sane-sm3600.man index 3cbcd81a1..bd4bc552c 100644 --- a/doc/sane-sm3600.man +++ b/doc/sane-sm3600.man @@ -39,7 +39,9 @@ This backend dynamically enables the options for the frontend, that are supported by the scanner dependent on the scanning-mode and other options. Unsupported options are disabled. .PP -The following options are supported by the Microtek2-driver: +The following options are supported by the +.B sane\-sm3600 +backend: Color, grayscale, halftone and lineart scans. Also contrast, brightness, and gamma correction. diff --git a/doc/sane-snapscan.man b/doc/sane-snapscan.man index aff29a91c..0fb493e42 100644 --- a/doc/sane-snapscan.man +++ b/doc/sane-snapscan.man @@ -77,7 +77,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-sp15c.man b/doc/sane-sp15c.man index f0dc72a05..905694773 100644 --- a/doc/sane-sp15c.man +++ b/doc/sane-sp15c.man @@ -41,8 +41,8 @@ to set scanning region, resolution, bit-depth (and color), and enable the automatic document feeder. .SH "SEE ALSO" -.BR sane (7) , -.BR sane\-scsi (5) , +.BR sane (7), +.BR sane\-scsi (5), .BR sane\-fujitsu (5), .BR xscanimage (1) .br diff --git a/doc/sane-st400.man b/doc/sane-st400.man index b93dc4910..dab23f6b0 100644 --- a/doc/sane-st400.man +++ b/doc/sane-st400.man @@ -36,7 +36,7 @@ This backend expects device names of the form: .PP Where .I special -is either the path-name for the special device that corresponds to a +is the path-name for the special device that corresponds to a SCSI scanner. For SCSI scanners, the special device name must be a generic SCSI device or a symlink to such a device. Under Linux, such a device name could be @@ -98,7 +98,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-stv680.man b/doc/sane-stv680.man index d4a8d3a26..58488e0e4 100644 --- a/doc/sane-stv680.man +++ b/doc/sane-stv680.man @@ -160,7 +160,7 @@ Plenty. Parts of this backend are still under development. .SH "SEE ALSO" -.BR sane(7), +.BR sane (7), .BR sane\-usb (5), .BR scanimage (1), .BR xcam (1) diff --git a/doc/sane-tamarack.man b/doc/sane-tamarack.man index 16b1128aa..82ec419f0 100644 --- a/doc/sane-tamarack.man +++ b/doc/sane-tamarack.man @@ -56,7 +56,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-teco1.man b/doc/sane-teco1.man index e9d96630b..936ce009a 100644 --- a/doc/sane-teco1.man +++ b/doc/sane-teco1.man @@ -77,14 +77,19 @@ scanimage \-\-help \-d teco1 .TP .B \-\-mode Black & White|Grayscale|Color -Selects the basic mode of operation of the scanner valid choices are +Selects the basic mode of operation of the scanner. Valid choices are +.IR "Black & White" , +.I "Grayscale" +and +.IR Color . + The .I Black & White -mode is black and white only (1 bit). +mode is for black and white only (1 bit). .I Grayscale will produce 256 levels of gray (8 bits). .I Color -will produce a 24 bits color image. +will produce a 24 bit color image. .TP .B \-\-resolution 1..600 diff --git a/doc/sane-teco2.man b/doc/sane-teco2.man index 6b042906a..6fd9780f3 100644 --- a/doc/sane-teco2.man +++ b/doc/sane-teco2.man @@ -96,7 +96,9 @@ a restricted set of resolutions are available. .B Note: All values with ydpi > 300 (300 x 600) or 600 (600 x 1200) result in a wrong proportion for the scan. The proportion can be adjusted with -the following imagemagick command: +the following +.BR convert (1) +command from imagemagick: .br .I convert \-geometry (dpi/max_xdpi * 100%)x100% .br @@ -164,7 +166,7 @@ value loaded into the scanner. Scale 0..64 in steps of 1. .TP .B \-\-white\-level\-g 0..64 Selects what green radiance level should be -considered "white", when scanning some sheets by changing the calibration i +considered "white", when scanning some sheets by changing the calibration value loaded into the scanner. Scale 0..64 in steps of 1. .TP @@ -252,4 +254,4 @@ Dave Parker for testing the support for the VM6575. .TP Michael Hoeller for testing the support for the VM356A. .TP -Christoph.Hoeffner for testing the support for the VM3564 (Relisys AVEC II S3 firmware 1.09). +Christoph Hoeffner for testing the support for the VM3564 (Relisys AVEC II S3 firmware 1.09). diff --git a/doc/sane-test.man b/doc/sane-test.man index 3368bdf1d..194fd8b14 100644 --- a/doc/sane-test.man +++ b/doc/sane-test.man @@ -51,7 +51,7 @@ correctly. This option also enables a fixed width of 11 cm. Setting option .B three\-pass simulates a three-pass scanner. Older color scanners needed to scan the image -once per color (reg/green/blue) to get the full image. Therefore, in this mode +once per color (red/green/blue) to get the full image. Therefore, in this mode three single frames are transmitted in color mode. .PP Option @@ -303,7 +303,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-u12.man b/doc/sane-u12.man index a09ae91e4..81ab725e4 100644 --- a/doc/sane-u12.man +++ b/doc/sane-u12.man @@ -126,7 +126,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-umax.man b/doc/sane-umax.man index 21caa3c7b..747277ed5 100644 --- a/doc/sane-umax.man +++ b/doc/sane-umax.man @@ -6,9 +6,9 @@ sane\-umax \- SANE backend for UMAX scanners .SH ABOUT THIS FILE -This file only is a short description of the +This file is only a brief description of the .B sane\-umax -backend for sane! For detailed information take a look at +backend for SANE! For detailed information take a look at sane\-umax\-doc.html (it is included in the sane source directory and in the .BR xsane (1) online help)! @@ -17,7 +17,7 @@ online help)! The .B sane\-umax -library implements a SANE backend that provides access to several UMAX-SCSI-scanners and some Linotye Hell SCSI-scanners, +library implements a SANE backend that provides access to several UMAX-SCSI-scanners and some Linotype Hell SCSI-scanners, parallel- and USB-scanners are not (and probably will never be) supported! .B I suggest you hold one hand on the power-button of the scanner while you try the first scans! @@ -69,9 +69,11 @@ values: 0 = disabled, 1 = enabled .br default = 0 .br -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) +If set to 1, +.BR umax_do_request_sense () +is called in +.BR umax_do_calibration (). +This can hang the system, but has been enabled until this version. .TP scsi\-buffer\-size\-min, scsi\-buffer\-size\-max: values: 4096-1048576 @@ -113,10 +115,11 @@ values: .br default = \-1 .br -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 +Dangerous options, needed for some scanners. +.br +Do not change these options unless you really know +what you are doing otherwise you may destroy your scanner +with invalid values. .TP calibration\-full\-ccd: values: @@ -132,8 +135,7 @@ selected image calibration\-width\-offset: values: \-99999 = auto, > \-99999 set value .br -add an offset width to the calculated with for -image/ccd +add an offset to the calculated width for image/ccd .TP calibration\-bytes\-pixel: values: @@ -191,7 +193,7 @@ values: default = 2 .br most SCSI drivers allow internal command queueing with a depth -of 2 commands. In most cases it does not mprove anything when you +of 2 commands. In most cases it does not improve anything when you increase this value. When your SCSI driver does not support any command queueing you can try to set this value to 1. @@ -203,9 +205,9 @@ permissions of that device, have a look at .SH SCSI ADAPTER TIPS -The ISA-SCSI-adapters that are shipped with some Umax-scanners are not supported very +The ISA-SCSI-adapters that are shipped with some UMAX-scanners are not supported very well by Linux (I suggest not to use it), the PCI-SCSI-adapters that come with some -Umax-scanners are not supported at all (as far as I know). On other platforms these +UMAX-scanners are not supported at all (as far as I know). On other platforms these SCSI-adapters are not supported. So you typically need to purchase another SCSI-adapter that is supported by your platform. See the relevant hardware FAQs and HOWTOs for your platform for more information. @@ -215,7 +217,7 @@ necessary to connect the scanner to its own SCSI-adapter. But if you need short response time for your SCSI-harddisk (e.g. if your computer is a file-server) or other SCSI devices, I suggest you use an own SCSI-adapter for your UMAX-scanner. -If you have any problems with your Umax scanner, check your SCSI chain +If you have any problems with your UMAX scanner, check your SCSI chain (cable length, termination, ...). See also: @@ -240,9 +242,9 @@ The shared library implementing this backend: .B SANE_DEBUG_UMAX If the library was compiled with debug support enabled, this environment variable controls the debug level for this backend. E.g., a value of 128 -requests all debug output to be printed. Smaller levels reduce verbosity: +requests all debug output to be printed. Smaller levels reduce verbosity. .B SANE_DEBUG_UMAX -values. +values: .ft CR .nf diff --git a/doc/sane-umax_pp.man b/doc/sane-umax_pp.man index 1d1506197..7bfa750d9 100644 --- a/doc/sane-umax_pp.man +++ b/doc/sane-umax_pp.man @@ -217,7 +217,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane-v4l.man b/doc/sane-v4l.man index 41a600ef5..1ecaa6564 100644 --- a/doc/sane-v4l.man +++ b/doc/sane-v4l.man @@ -59,7 +59,7 @@ support dynamic loading). .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working diff --git a/doc/sane.man b/doc/sane.man index 79de76cb1..a0be3c30e 100644 --- a/doc/sane.man +++ b/doc/sane.man @@ -49,7 +49,7 @@ The frontends and .BR scanadf (1) are included in the package -.BR sane\-frontends. +.BR sane\-frontends . Both packages can be downloaded from the .B SANE homepage @@ -90,7 +90,8 @@ supported or unsupported), please contact us. See section HOW CAN YOU HELP SANE for details. There are lists for specific releases of SANE, for the current development version and a search engine: .IR http://www.sane\-project.org/sane\-supported\-devices.html . -The lists are also installed on your system at \fI@DOCDIR@/\fR. +The lists are also installed on your system at +.IR @DOCDIR@/ . .TP .B SANE mailing list There is a mailing list for the purpose of discussing the SANE standard and its @@ -267,16 +268,20 @@ for details. .TP .B genesys Supports several scanners based on the Genesys Logic -GL646, GL841, GL843, GL847 and GL124 chips like the Medion 6471 and Hewlett-Packard 2300c. - See +GL646, GL841, GL843, GL847 and GL124 chips like the +Medion 6471 and Hewlett-Packard 2300c. +See .BR sane\-genesys (5) for details. .TP .B gt68xx Supports scanners based on the Grandtech -GT-6801 and GT-6816 chips like the Artec Ultima 2000 and several Mustek -BearPaw CU and TA models. Some Genius, Lexmark, Medion, Packard Bell, Plustek, -and Trust scanners are also supported. See +GT-6801 and GT-6816 chips like the Artec Ultima 2000 +and several Mustek BearPaw CU and TA models. +.br +Some Genius, +Lexmark, Medion, Packard Bell, Plustek, and Trust scanners +are also supported. See .BR sane\-gt68xx (5) for details. .TP @@ -313,7 +318,7 @@ for details. .TP .B hpljm1005 Supports the Hewlett-Packard LaserJet M1005 scanner. See -.BR sane\-hpljm1005(5) +.BR sane\-hpljm1005 (5) for details. .TP .B hs2p @@ -601,9 +606,9 @@ The network daemon .BR saned (8) provides access to scanners located on different -computers in connection with the net backend. See +computers in connection with the .BR sane\-net (5) -and +backend. See .BR saned (8). .TP .B pnm @@ -761,9 +766,16 @@ information when testing a Mustek SCSI scanner, set environment variables .BR SANE_DEBUG_DLL ", " SANE_DEBUG_MUSTEK ", and " SANE_DEBUG_SANEI_SCSI to 128 and then invoke .IR scanimage\ \-L . -The debug messages for the dll backend tell if the mustek backend was found -and loaded at all. The mustek messages explain what the mustek backend is -doing while the SCSI debugging shows the low level handling. If you can't find +The +.B SANE_DEBUG_DLL +messages tell if the +.BR sane\-mustek (5) +backend was found and loaded at all. The +.B SANE_DEBUG_MUSTEK +messages explain what the backend is +doing while the +.B SANE_DEBUG_SCSI +debugging shows the low level handling. If you can't find out what's going on by checking the messages carefully, contact the sane\-devel mailing list for help (see REPORTING BUGS below). .PP @@ -792,11 +804,11 @@ You should get a list of PASSed tests. You can do the same with your backend by changing "test" to your backend's name. .PP So now scanning with -.B scanimage(1) +.B scanimage (1) works and you want to use one of the graphical frontends like -.BR xsane(1) , -.BR xscanimage(1) ", or" -.B quiteinsane(1) +.BR xsane (1) , +.BR xscanimage (1) ", or" +.B quiteinsane (1) but those frontends don't detect your scanner? One reason may be that you installed two versions of .BR SANE . diff --git a/doc/saned.man b/doc/saned.man index 073eaa662..d91f8176a 100644 --- a/doc/saned.man +++ b/doc/saned.man @@ -309,14 +309,15 @@ service sane\-port .SH SYSTEMD CONFIGURATION .B saned can be compiled with explicit -.BR systemd (1) support. This +.BR systemd (1) +support. This will allow logging debugging information to be forwarded to the .BR systemd (1) journal. The .BR systemd (1) support requires compilation with the systemd-devel package -installed on the system. this is the preferred option. +installed on the system. This is the preferred option. .B saned can be used with @@ -333,7 +334,7 @@ configuration is different for the 2 options, so both are described below. For .BR systemd (1) configuration we need to add 2 configuration files in -.I /etc/systemd/system. +.IR /etc/systemd/system . .PP The first file we need to add here is called .I saned.socket. @@ -391,7 +392,7 @@ You need to set an environment variable for pointing to the directory where .B saned can find its configuration files. -you will have to remove the # on the last line and set the variables +You will have to remove the # on the last line and set the variables for the desired debugging information if required. Multiple variables can be set by separating the assignments by spaces as shown in the example above. @@ -412,15 +413,15 @@ forwarded to the system log. This configuration will also work when .B saned is compiled WITH -.BR systemd (1) integration support, but it does not allow debugging -information to be logged. +.BR systemd (1) +integration support, but it does not allow debugging information to be logged. .PP For .BR systemd (1) configuration for .BR saned , we need to add 2 configuration files in -.I /etc/systemd/system. +.IR /etc/systemd/system . .PP The first file we need to add here is called .I saned.socket. @@ -447,7 +448,7 @@ WantedBy=sockets.target .RE .PP The second file to be added is -.I saned@.service +.IR saned@.service . This one differs from the version with .BR systemd (1) integration compiled in: @@ -499,7 +500,7 @@ if supported by the client. .TP .B SANE_CONFIG_DIR This environment variable specifies the list of directories that may -contain the configuration file. Under UNIX, the directories are +contain the configuration file. On *NIX systems, the directories are separated by a colon (`:'), under OS/2, they are separated by a semi-colon (`;'). If this variable is not set, the configuration file is searched in two default directories: first, the current working @@ -527,7 +528,7 @@ being searched (in this order). .BR sane\-"backendname" (5), .BR inetd (8), .BR xinetd (8), -.BR systemd (1), +.BR systemd (1) .br .I http://www.penguin-breeder.org/?page=sane\-net .SH AUTHOR diff --git a/doc/scanimage.man b/doc/scanimage.man index c045fc855..a86fe2aba 100644 --- a/doc/scanimage.man +++ b/doc/scanimage.man @@ -321,10 +321,10 @@ prints the program and package name, the version number of the .B SANE distribution that it came with and the version of the backend that it -loads. Usually that's the dll backend. If more information about the version +loads. If more information about the version numbers of the backends are necessary, the .B DEBUG -variable for the dll backend can be used. Example: +variable for the dll layer can be used. Example: .I "SANE_DEBUG_DLL=3 scanimage \-L" . .PP As you might imagine, much of the power of @@ -348,24 +348,26 @@ The documentation for the device-specific options printed by is best explained with a few examples: .B \-l 0..218mm [0] -.br - Top-left x position of scan area. -.PP .RS +Top-left x position of scan area. +.PP The description above shows that option .B \-l expects an option value in the range from 0 to 218 mm. The value in square brackets indicates that the current option value is 0 -mm. Most backends provide similar geometry options for top-left y position (\-t), -width (\-x) and height of scan-area (\-y). +mm. Most backends provide similar geometry options for top-left y position +.RB ( \-t ), +width +.RB ( \-x ) +and height of scan-area +.RB (\-y ). .RE .B \-\-brightness \-100..100% [0] -.br - Controls the brightness of the acquired image. -.PP .RS +Controls the brightness of the acquired image. +.PP The description above shows that option .B \-\-brightness expects an option value in the range from \-100 to 100 percent. The @@ -374,10 +376,9 @@ percent. .RE .B \-\-default\-enhancements -.br - Set default values for enhancement controls. -.PP .RS +Set default values for enhancement controls. +.PP The description above shows that option .B \-\-default\-enhancements has no option value. It should be thought of as having an immediate @@ -390,10 +391,9 @@ would effectively be a no-op. .RE .B \-\-mode Lineart|Gray|Color [Gray] -.br - Selects the scan mode (e.g., lineart or color). -.PP .RS +Selects the scan mode (e.g., lineart or color). +.PP The description above shows that option .B \-\-mode accepts an argument that must be one of the strings @@ -413,10 +413,9 @@ is identical to .RE .B \-\-custom\-gamma[=(yes|no)] [inactive] -.br - Determines whether a builtin or a custom gamma-table should be used. -.PP .RS +Determines whether a builtin or a custom gamma-table should be used. +.PP The description above shows that option .B \-\-custom\-gamma expects either no option value, a "yes" string, or a "no" string. @@ -446,14 +445,11 @@ is selected. .RE .B \-\-gamma\-table 0..255,... -.br - Gamma-correction table. In color mode this option -.br - equally affects the red, green, and blue channels -.br - simultaneously (i.e., it is an intensity gamma table). -.PP .RS +Gamma-correction table. In color mode this option +equally affects the red, green, and blue channels +simultaneously (i.e., it is an intensity gamma table). +.PP The description above shows that option .B \-\-gamma\-table expects zero or more values in the range 0 to 255. For example, a @@ -471,12 +467,10 @@ can be used to generate such gamma tables (see for details). .RE -.br .B \-\-filename [/tmp/input.ppm] -.br - The filename of the image to be loaded. -.PP .RS +The filename of the image to be loaded. +.PP The description above is an example of an option that takes an arbitrary string value (which happens to be a filename). Again, the value in brackets show that the option is current set to the @@ -513,8 +507,8 @@ to 127 characters. .BR sane (7), .BR gamma4scanimage (1), .BR xscanimage (1), -.BR xcam(1) , -.BR xsane(1) , +.BR xcam (1) , +.BR xsane (1) , .BR scanadf (1), .BR sane\-dll (5), .BR sane\-net (5),