diff options
Diffstat (limited to 'doc/sane-magicolor.man')
| -rw-r--r-- | doc/sane-magicolor.man | 72 |
1 files changed, 72 insertions, 0 deletions
diff --git a/doc/sane-magicolor.man b/doc/sane-magicolor.man new file mode 100644 index 0000000..1e6c0a5 --- /dev/null +++ b/doc/sane-magicolor.man @@ -0,0 +1,72 @@ +.\" .IX sane-magicolor +.TH "sane-magicolor" "5" "10 Jan 2011" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy" +.SH "NAME" +sane\-magicolor \- SANE backend for KONICA MINOLTA magicolor scanners +.SH "DESCRIPTION" +The +.B sane\-magicolor +backend supports KONICA MINOLTA magicolor scanners connected via USB or LAN. Currently, only the magicolor 1690MF device is supported, no other devices with the same scanning protocol are known. +.SH "SUPPORTED DEVICES" +The following scanner should work with this backend: + +Device Details +.br +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +.br +Vendor: KONICA MINOLTA +.br +Model: magicolor 1690MF + +.SH "CONFIGURATION" +.PP +This section describes the backend's configuration file entries. The file is located at: +.IP +.I @CONFIGDIR@/magicolor.conf +.PP +For a proper setup, at least one of the following entries are needed: +.IP +.I net autodiscovery +.br +.I net [IP ADDRESS] [DEVICE-ID] +.br +.I usb +.br +.I usb [VENDOR-ID] [DEVICE-ID] + +.SH "FILES" +.TP +.I @CONFIGDIR@/magicolor.conf +The backend configuration file +.TP +.I @LIBDIR@/libsane\-magicolor.a +The static library implementing this backend. +.TP +.I @LIBDIR@/libsane\-magicolor.so +The shared library implementing this backend (present on systems that support dynamic loading). +.SH "ENVIRONMENT" +.TP +.B SANE_CONFIG_DIR +This environment variable specifies the list of directories that may 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 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). +.TP +.B SANE_DEBUG_MAGICOLOR +If the library was compiled with debug support enabled, this environment variable controls the debug level for this backend. Higher debug levels increase the verbosity of the output. + +Example: export SANE_DEBUG_MAGICOLOR=127 + +To obtain debug messages from the backend, set this environment variable before calling your favorite frontend (e.g. xscanimage). + +Example: SANE_DEBUG_MAGICOLOR=65 xscanimage +.SH "KNOWN BUGS AND RESTRICTIONS" +.PP +Large color scans may sometimes timeout due to unknown reasons (the scanner simply stops returning data) +.PP +Cancelling large scans may lock up the scanner. +.SH "SEE ALSO" +.BR sane (7), +.br +.I http://wiki.kainhofer.com/hardware/magicolor_scan +.SH "AUTHOR" +.PP +Reinhold Kainhofer <reinhold@kainhofer.com> |