summaryrefslogtreecommitdiff
path: root/doc/sane-u12.man
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff-webhosting.net>2021-02-16 18:25:42 +0100
committerJörg Frings-Fürst <debian@jff-webhosting.net>2021-02-16 18:25:42 +0100
commit64ddd1a4dfcefd11f662f5cf4bb05b590d901a97 (patch)
tree4303648095deff998ae20c2393b56db527742ac9 /doc/sane-u12.man
parent5793a221e112fa49073de0137d6bfa750a61b0a1 (diff)
parentecaaf250cb33ff61f37a7b441f2337584a655350 (diff)
Merge branch 'feature/upstream' into develop
Diffstat (limited to 'doc/sane-u12.man')
-rw-r--r--doc/sane-u12.man38
1 files changed, 26 insertions, 12 deletions
diff --git a/doc/sane-u12.man b/doc/sane-u12.man
index 680ce0c..a09ae91 100644
--- a/doc/sane-u12.man
+++ b/doc/sane-u12.man
@@ -12,7 +12,7 @@ provides access to USB flatbed scanners based on Plusteks' ASIC
bridge chip.
.SH "SUPPORTED DEVICES"
-The backend is able to support some early Plustek USB scanner based
+The backend is able to support some early Plustek USB scanners that based
their old parport design around the ASIC 98003 and other rebadged
Plustek devices. The following tables will give you a short overview.
@@ -52,6 +52,7 @@ ColorPage HR6 V1 0x0458 0x2004
To use your scanner with this backend, you need at least two
entries in the configuration file
.I @CONFIGDIR@/u12.conf
+
.RS
.I [usb] vendor-id product-id
.br
@@ -91,16 +92,17 @@ lamps off, 0 --> do not change lamp status
.RE
.PP
-See the u12.conf file for examples.
+See the
+.I u12.conf
+file for examples.
.PP
.B Note:
-.br
You have to make sure, that the USB subsystem is loaded
correctly and you have access to the device-node. For
more details see
-.B sane\-usb (5)
+.BR sane\-usb (5)
manpage. You might use
-.B sane\-find\-scanner
+.BR sane\-find\-scanner (1)
to check that you have access to your device.
.PP
.B Note:
@@ -128,13 +130,19 @@ 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 @CONFIGDIR@. If the value of the
+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
.B SANE_CONFIG_DIR
-to "/tmp/config:" would result in directories "tmp/config", ".", and
-"@CONFIGDIR@" being searched (in this order).
+to "/tmp/config:" would result in directories
+.IR tmp/config ,
+.IR . ,
+and
+.I @CONFIGDIR@
+being searched (in this order).
.TP
.B SANE_DEBUG_U12
If the library was compiled with debug support enabled, this
@@ -148,6 +156,9 @@ export SANE_DEBUG_U12=10
.BR sane (7),
.BR sane\-usb (5),
.BR sane\-plustek (5),
+.BR sane\-find\-scanner (1),
+.BR xscanimage (1),
+.BR scanimage (1)
.br
.I @DOCDIR@/u12/U12.changes
@@ -160,14 +171,17 @@ Additional info and hints can be obtained from our
.br
Mailing-List archive at:
.br
-.B http://www.sane\-project.org/mailing\-lists.html
+.I http://www.sane\-project.org/mailing\-lists.html
.PP
To obtain debug messages from the backend, please set the
environment-variable
-.I SANE_DEBUG_U12
-before calling your favorite scan-frontend (i.e. xscanimage).
+.B SANE_DEBUG_U12
+before calling your favorite scan-frontend (i.e.
+.BR xscanimage (1)),
+i.e.:
+
.br
-.B i.e.: export SANE_DEBUG_U12=20 ; xscanimage
+.I export SANE_DEBUG_U12=20 ; xscanimage
.PP
The value controls the verbosity of the backend.