summaryrefslogtreecommitdiff
path: root/doc/sane-test.man
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff-webhosting.net>2021-05-18 07:43:35 +0200
committerJörg Frings-Fürst <debian@jff-webhosting.net>2021-05-18 07:43:35 +0200
commit9f8889f928ce86ba4a78659d378c6ba29bc9f735 (patch)
treec9567cb0d015b68ce3da8d03472b6443f1cb1ca9 /doc/sane-test.man
parent446e9454b8cbe5b689149415d11d36e88442ca88 (diff)
parent154785ab2d5df7ddc8c2cf813b773c340e5e2aea (diff)
Merge branch 'release/debian/1.0.32-1'debian/1.0.32-1
Diffstat (limited to 'doc/sane-test.man')
-rw-r--r--doc/sane-test.man51
1 files changed, 36 insertions, 15 deletions
diff --git a/doc/sane-test.man b/doc/sane-test.man
index 08c9f86..3368bdf 100644
--- a/doc/sane-test.man
+++ b/doc/sane-test.man
@@ -17,9 +17,14 @@ capabilities of SANE. Therefore
implements functions and options that are not (or seldom) found in other
backends.
.PP
-The backend is commented out in @CONFIGDIR@/dll.conf, so either the comment
+The backend is commented out in
+.IR @CONFIGDIR@/dll.conf ,
+so either the comment
character must be removed or the backend must be called explicitly. E.g.
-`scanimage \-d test' or `xscanimage test'.
+.I scanimage \-d test
+or
+.IR "xscanimage test" .
+
.SH SCAN MODE OPTIONS
Option
@@ -73,7 +78,8 @@ and "Solid black" are quite obvious, the other options need some more
explanation. Color patterns are used to determine if all modes and their
colors are represented correctly by the frontend. The grid should look like the
same in every mode and resolution. A table of all the test pictures can be
-found at: http://www.meier\-geinitz.de/sane/test\-backend/test\-pictures.html.
+found at:
+.IR http://www.meier\-geinitz.de/sane/test\-backend/test\-pictures.html .
.PP
If option
.B invert\-endianness
@@ -83,8 +89,9 @@ frontend uses the correct endianness.
.PP
If option
.B read\-limit
-is set, the maximum amount of data transferred with each call to sane_read() is
-limited.
+is set, the maximum amount of data transferred with each call to
+.BR sane_read ()
+is limited.
.PP
Option
.B read\-limit\-size
@@ -105,8 +112,9 @@ used over the network.
If option
.B read\-return\-value
is different from "Default", the selected status will be returned by every
-call to sane_read(). This is useful to test the frontend's handling of the
-SANE statuses.
+call to
+.BR sane_read ().
+This is useful to test the frontend's handling of the SANE statuses.
.PP
If option
.B ppl\-loss
@@ -121,13 +129,15 @@ parameters it got before the start of the scan (which it shouldn't).
.PP
Option
.B non\-blocking
-determines if non-blocking IO for sane_read() should be used if supported by
-the frontend.
+determines if non-blocking IO for
+.BR sane_read ()
+should be used if supported by the frontend.
.PP
If option
.B select\-fd
is set, the backend offers a select filedescriptor for detecting if
-sane_read() will return data.
+.BR sane_read()
+will return data.
.PP
If option
.B enable\-test\-options
@@ -288,6 +298,7 @@ The static library implementing this backend.
.I @LIBDIR@/libsane\-test.so
The shared library implementing this backend (present on systems that
support dynamic loading).
+
.SH ENVIRONMENT
.TP
.B SANE_CONFIG_DIR
@@ -296,13 +307,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_TEST
If the library was compiled with debug support enabled, this
@@ -313,12 +330,16 @@ Example:
export SANE_DEBUG_TEST=4
.SH "SEE ALSO"
-sane(7),
+.BR sane (7),
+.BR scanimage (1),
+.BR xscanimage (1)
+.br
.IR http://www.meier\-geinitz.de/sane/test\-backend/
.SH AUTHOR
-Henning Meier-Geinitz <henning@meier\-geinitz.de>
+Henning Meier-Geinitz
+.RI < henning@meier\-geinitz.de >
.SH BUGS
\- config file values aren't tested for correctness