From 351b7328520c16730ceb46e5acae16038c42185e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Tue, 16 Feb 2021 18:24:19 +0100 Subject: New upstream version 1.0.32 --- doc/sane-test.man | 51 ++++++++++++++++++++++++++++++++++++--------------- 1 file changed, 36 insertions(+), 15 deletions(-) (limited to 'doc/sane-test.man') 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 +.RI < henning@meier\-geinitz.de > .SH BUGS \- config file values aren't tested for correctness -- cgit v1.2.3