xref: /third_party/backends/tools/README (revision 141cc406) 
12006-05-10
2
3This directory contains various tools that may be useful:
4
5 hotplug/:
6        Linux hotplug script and an automatically generated config file
7        (libsane.usermap) used to change the permissions on the libusb "device
8        nodes" in /proc/bus/usb/ when a scanner is plugged in. For newer Linux
9        kernels, you may need to use udev instead.  Please read the README file
10        in this directory for instructions.
11
12 hotplug-ng/:
13        Linux hotplug-ng script and an automatically generated config file
14        (libsane.db) used to change the permissions on the libusb "device nodes"
15        in /proc/bus/usb/ when a scanner is plugged in. For newer Linux kernels,
16        you may need to use udev instead.  Please read the README file in this
17        directory for instructions.
18
19 udev/:
20	Contains a automatically generated udev rules file. udev now replaces
21	hotplug and provides all the functionalities of hotplug. libusb 0.1.12
22	or newer is necessary.
23
24 openbsd/:
25 	Contains example scripts for hotplugd(8) for USB scanners accessed via
26	libusb.
27
28 sane-find-scanner:
29        Attempts to find a SCSI scanner attached to your system.
30        Invoke with "sane-find-scanner -h" to get command-line
31        syntax. More details can be found in the man page
32        sane-find-scanner(1).
33
34 xerox:
35        A simple script to make photocopies ("xeroxing").  In
36        the script, you may need to adjust the device name
37        assigned to variable DEV and the resolution assigned
38        to variable RES as well as the paper with and height
39        (variables WIDTH and HEIGHT, respectively.
40
41 mustek600iin-off:
42        Allows you to turn off a Mustek 600 II N scanner.
43        Use "make mustek600iin-off" to compile.
44
45 umax_pp:
46	Command line utility to scan on UMAX astra 1220P,
47	1600P and 2000P, without using the backend. So that
48	scanner protocol can be tested directly.
49
50 gamma4scanimage: Creates a gamma table in the format expected by scanimage.
51	You can define a gamma value, shadow and highlight.
52	Take a look at manual page gamma4scanimage for further information.
53
54 RenSaneDlls.cmd: Convert backend-DLL-filenames according to 8.3 naming
55        convention necessary for DLLs on OS/2.
56
57Maybe useful for SANE developers:
58
59 sane-config:
60        Show SANE version, linker flags etc. Might be useful for
61        frontend developers.
62
63 sane-desc:
64        Generate SANE webpages (and ASCII lists) from backend .desc files.
65        Run "sane-desc --help" for details. The default lists are generated
66        in doc/Makefile.
67
68 check-po.awk:
69        Print untranslated and fuzzy messages and their line numbers in the
70        source code and po file. Example:
71           tools/check-po.awk po/de.po
72        You may need to adjust the path of gawk in the first line of the
73        script. Alternatively, run it via gawk's -f option, like so:
74           gawk -f tools/check-po.awk po/de.po
75        More documentation is in the script itself.
76