README
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