summaryrefslogtreecommitdiff
path: root/doc/sane.man
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff-webhosting.net>2019-07-31 17:00:58 +0200
committerJörg Frings-Fürst <debian@jff-webhosting.net>2019-07-31 17:00:58 +0200
commitd087d778ffb62e2713cb848540bcc819470365bd (patch)
treed69692a274dd1c7d0672e6bb7155a0fc106f9d49 /doc/sane.man
parentc8bd2513ecba169cff44c09c8058c36987357b18 (diff)
parent3759ce55ba79b8d3b9d8ed247a252273ee7dade3 (diff)
Merge branch 'feature/upstream' into develop
Diffstat (limited to 'doc/sane.man')
-rw-r--r--doc/sane.man89
1 files changed, 48 insertions, 41 deletions
diff --git a/doc/sane.man b/doc/sane.man
index 3eadf42..a9fd50a 100644
--- a/doc/sane.man
+++ b/doc/sane.man
@@ -24,33 +24,33 @@ If you have trouble getting your scanner detected, read the PROBLEMS section.
.SH TERMINOLOGY
-An application that uses the
+An application that uses the
.B SANE
-interface is called a
+interface is called a
.B SANE frontend.
-A driver that implements the
+A driver that implements the
.B SANE
interface is called a
.B SANE backend.
-A
+A
.B meta backend
provides some means to manage one or more other backends.
.SH "SOFTWARE PACKAGES"
-The package
+The package
.RB ` sane\-backends '
-contains a lot of backends, documentation (including the
+contains a lot of backends, documentation (including the
.B SANE
-standard), networking support, and the command line frontend
+standard), networking support, and the command line frontend
.RB ` scanimage '.
-The frontends
+The frontends
.RB ` xscanimage "', `" xcam "', and `" scanadf '
are included in the package
-.RB ` sane\-frontends '.
+.RB ` sane\-frontends '.
Both packages can be downloaded from the
.B SANE
-homepage
+homepage
.RI ( http://www.sane\-project.org/ ).
Information about other frontends and backends can also be found on the
.B SANE
@@ -60,15 +60,15 @@ homepage.
The following sections provide short descriptions and links to more
information about several aspects of
.B SANE.
-A name with a number in parenthesis (e.g.
+A name with a number in parenthesis (e.g.
.RB ` sane\-dll (5)')
-points to a manual page. In this case
+points to a manual page. In this case
.RB ` "man 5 sane\-dll" '
will display the page. Entries like
.RI ` @DOCDIR@/sane.tex '
are references to text files that were copied to the
.B SANE
-documentation directory
+documentation directory
.RI ( @DOCDIR@/ )
during installation. Everything else is a URL to a resource on the web.
@@ -79,9 +79,9 @@ can be found on the SANE homepage:
.IR http://www.sane\-project.org/ .
.TP
.B SANE device lists
-The
+The
.B SANE
-device lists contain information about the status of
+device lists contain information about the status of
.B SANE
support for a specific device. If your scanner is not listed there (either
supported or unsupported), please contact us. See section HOW CAN YOU HELP
@@ -100,9 +100,9 @@ unsubscribe:
.TP
.B SANE IRC channel
The IRC (Internet Relay Chat) channel #sane can be found on the Freenode
-network (irc.freenode.net). It's for discussing
+network (irc.freenode.net). It's for discussing
.B SANE
-problems, talking about development and general
+problems, talking about development and general
.B SANE
related chatting. Before asking for help, please read the other documentation
mentioned in this manual page. The channel's topic is also used for
@@ -127,13 +127,13 @@ For information about USB configuration see
.SH "FRONTENDS AND MISCELLANEOUS PROGRAMS"
.TP 2
.B scanimage
-Command-line frontend. See
+Command-line frontend. See
.BR scanimage (1).
.TP
.B saned
.B SANE
network daemon that allows remote clients to access image acquisition devices
-available on the local host. See
+available on the local host. See
.BR saned (8).
.TP
.B sane\-find\-scanner
@@ -192,7 +192,7 @@ This backend supports several Avision based scanners. This includes the
original Avision scanners (like AV 630, AV 620, ...) as well as the HP
ScanJet 53xx and 74xx series, Fujitsu ScanPartner, some Mitsubishi and
Minolta film-scanners.
-See
+See
.BR sane\-avision (5)
for details.
.TP
@@ -225,7 +225,7 @@ parallel port scanners. See
for details.
.TP
.B cardscan
-This backend provides support for Corex Cardscan USB scanners. See
+This backend provides support for Corex Cardscan USB scanners. See
.BR sane\-cardscan (5)
for details.
.TP
@@ -260,7 +260,7 @@ and adf scanners. See
for details.
.TP
.B genesys
-The genesys backend provides support for several scanners based on the Genesys Logic
+The genesys backend provides support for several scanners based on the Genesys Logic
GL646, GL841, GL843, GL847 and GL124 chips like the Medion 6471 and Hewlett-Packard 2300c.
See
.BR sane\-genesys (5)
@@ -363,7 +363,7 @@ for details.
.TP
.B microtek
The microtek backend provides access to the "second generation" Microtek
-scanners with SCSI-1 command set. See
+scanners with SCSI-1 command set. See
.BR sane\-microtek (5)
for details.
.TP
@@ -448,6 +448,12 @@ scanners: IS50 and IS60. See
.BR sane\-ricoh (5)
for details.
.TP
+.B ricoh2
+The ricoh2 backend provides access to the following Ricoh flatbed
+scanners: SG-3100SNw, SP-100SU, and SP-111SU. See
+.BR sane\-ricoh2 (5)
+for details.
+.TP
.B s9036
The s9036 backend provides access to Siemens 9036 flatbed scanners. See
.BR sane\-s9036 (5)
@@ -515,7 +521,7 @@ for details.
.TP
.B umax_pp
The sane\-umax_pp backend provides access to Umax parallel port flatbed scanners
-and the HP 3200C. See
+and the HP 3200C. See
.BR sane\-umax_pp (5)
for details.
.TP
@@ -565,12 +571,12 @@ backend. See
.BR sane\-gphoto2 (5).
.TP
.B qcam
-Backend for Connectix QuickCam cameras. See
+Backend for Connectix QuickCam cameras. See
.BR sane\-qcam (5).
.TP
.B stv680
-The sane\-st680 backend provides access to webcams with a stv680 chip. See
-.BR sane\-st680 (5)
+The sane\-stv680 backend provides access to webcams with a stv680 chip. See
+.BR sane\-stv680 (5)
for details.
.PP
Also, have a look at the backend information page at
@@ -589,7 +595,7 @@ backends by dynamic loading. See
.BR sane\-dll (5).
.TP
.B net
-The
+The
.B SANE
network daemon saned provides access to scanners located on different
computers in connection with the net backend. See
@@ -634,9 +640,9 @@ and the list of projects in
.IR @DOCDIR@/PROJECTS .
.SH "CHANGING THE TOP-LEVEL BACKEND"
-By default, all
+By default, all
.B SANE
-backends (drivers) are loaded dynamically by the
+backends (drivers) are loaded dynamically by the
.B sane\-dll
meta backend. If you have any questions about the dynamic loading,
read
@@ -655,8 +661,8 @@ It's not hard to write a
backend. It can take some time, however. You should have basic knowledge of C
and enough patience to work through the documentation and find out how your
scanner works. Appended is a list of some documents that help to write backends
-and frontends.
-.PP
+and frontends.
+.PP
The
.B SANE
standard defines the application programming interface (API) that is used to
@@ -685,7 +691,7 @@ for projects that are planned or not yet included into the
distribution and at our bug-tracking system:
.IR http://www.http://www.sane\-project.org/bugs.html .
.PP
-There are some links on how to find out about the protocol of a scanner:
+There are some links on how to find out about the protocol of a scanner:
.IR http://www.meier\-geinitz.de/sane/misc/develop.html .
.PP
@@ -731,9 +737,9 @@ If your scanner (or other device) is not connected over the SCSI bus or USB,
read the backend's manual page for details on how to set it up.
.PP
-Now your scanner is detected by the operating system but not by
+Now your scanner is detected by the operating system but not by
.BR SANE ?
-Try
+Try
.BR "scanimage \-L" .
If the scanner is not found, check that the backend's name is mentioned in
.IR @CONFIGDIR@/dll.conf .
@@ -741,7 +747,7 @@ Some backends are commented out by default. Remove the comment sign for your
backend in this case. Also some backends aren't compiled at all if one of their
prerequisites are missing. Examples include dc210, dc240, canon_pp, hpsj5s,
gphoto2, pint, qcam, v4l, net, sm3600, snapscan, pnm. If you need one of these
-backends and they aren't available, read the build instructions in the
+backends and they aren't available, read the build instructions in the
.B README
file and the individual manual pages of the backends.
.PP
@@ -761,7 +767,7 @@ debugging. The environment variables are documented in the
relevant manual pages. For example, to get the maximum amount of debug
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
+to 128 and then invoke
.B scanimage
.B \-L .
The debug messages for the dll backend tell if the mustek backend was found
@@ -803,11 +809,11 @@ works and you want to use one of the graphical frontends like
.BR xscanimage ", or"
.B quiteinsane
but those frontends don't detect your scanner? One reason may be that you
-installed two versions of
+installed two versions of
.BR SANE .
-E.g. the version that was installed by your distribution in
+E.g. the version that was installed by your distribution in
.I /usr
-and one you installed from source in
+and one you installed from source in
.IR /usr/local/ .
Make sure that only one version is installed. Another possible reason is, that
your system's dynamic loader can't find the
@@ -825,7 +831,7 @@ See also the documentation of the frontends.
.SH "HOW CAN YOU HELP SANE"
We appreciate any help we can get. Please have a look at our web page about
-contributing to
+contributing to
.BR SANE :
.I http://www.sane\-project.org/contrib.html
.PP
@@ -903,6 +909,7 @@ for details).
.BR sane\-pnm (5),
.BR sane\-qcam (5),
.BR sane\-ricoh (5),
+.BR sane\-ricoh2 (5),
.BR sane\-s9036 (5),
.BR sane\-sceptre (5),
.BR sane\-scsi (5),