summaryrefslogtreecommitdiff
path: root/doc/sane-magicolor.man
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff-webhosting.net>2014-10-06 14:00:40 +0200
committerJörg Frings-Fürst <debian@jff-webhosting.net>2014-10-06 14:00:40 +0200
commit6e9c41a892ed0e0da326e0278b3221ce3f5713b8 (patch)
tree2e301d871bbeeb44aa57ff9cc070fcf3be484487 /doc/sane-magicolor.man
Initial import of sane-backends version 1.0.24-1.2
Diffstat (limited to 'doc/sane-magicolor.man')
-rw-r--r--doc/sane-magicolor.man72
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>