From 6e9c41a892ed0e0da326e0278b3221ce3f5713b8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Mon, 6 Oct 2014 14:00:40 +0200 Subject: Initial import of sane-backends version 1.0.24-1.2 --- doc/sane-ma1509.man | 134 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 134 insertions(+) create mode 100644 doc/sane-ma1509.man (limited to 'doc/sane-ma1509.man') diff --git a/doc/sane-ma1509.man b/doc/sane-ma1509.man new file mode 100644 index 0000000..bdd20f7 --- /dev/null +++ b/doc/sane-ma1509.man @@ -0,0 +1,134 @@ +.TH sane\-ma1509 5 "13 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy" +.IX sane\-ma1509 +.SH NAME +sane\-ma1509 \- SANE backend for Mustek BearPaw 1200F USB scanner +.SH DESCRIPTION +The +.B sane\-ma1509 +library implements a SANE (Scanner Access Now Easy) backend that provides +access to the Mustek BearPaw 1200F USB flatbed scanner. This scanner is based +on the MA-1509 chipset. Other scanners that use this chip (if they exist) may +also work. +.PP +This backend is ALPHA software. Be careful and remove the power plug +immediately if your hear unusual noises. +.PP +More details can be found on the ma1509 backend homepage +.IR http://www.meier\-geinitz.de/sane/ma1509\-backend/ . +.PP +Other Mustek USB scanners are supported by the gt68xx, mustek_usb and the +plustek backends. See +.BR sane\-mustek_usb (5), +.BR sane\-gt68xx (5) +and +.BR sane\-plustek (5) +for details. +.PP +This backend can only work with scanners that are already detected by the +operating system. See +.BR sane\-usb (5) +for details. +.PP +If you own a scanner other than the Mustek BearPaw 1200F that works with this +backend, please let me know this by sending the scanner's exact model name and +the USB vendor and device ids (e.g. from +.I /proc/bus/usb/devices +or syslog) to me. + +.SH "DEVICE NAMES" +This backend expects device names of the form: +.PP +.RS +.I special +.RE +.PP +Where +.I special +is a path-name for the special device that corresponds to a USB scanner. +With Linux, such a device name could be +.I /dev/usb/scanner0 +or +.IR libusb:001:002 , +for example. +.PP + +.SH CONFIGURATION +The contents of the +.I ma1509.conf +file is a list of options and device names that correspond to Mustek BearPaw +1200F scanners. Empty lines and lines starting with a hash mark (#) are +ignored. +.PP +Instead of using the device name, the scanner can be autodetected by +.B "usb vendor_id product_id" +statements which are already included into +.IR ma1509.conf . +This is only supported with Linux 2.4.8 and higher and all systems that +support libsub. "vendor_id" and "product_id" are hexadecimal numbers that +identify the scanner. If this doesn't work, a device name must be placed in +.I ma1509.conf +as described above. +.PP +To set the time the lamp needs for warm-up, use +.B option +.B warmup-time +in +.IR ma1509.conf . +The time is given in seconds after the option. The default is 30 seconds. +.SH FILES +.TP +.I @CONFIGDIR@/ma1509.conf +The backend configuration file (see also description of +.B SANE_CONFIG_DIR +below). +.TP +.I @LIBDIR@/libsane\-ma1509.a +The static library implementing this backend. +.TP +.I @LIBDIR@/libsane\-ma1509.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_MA1509 +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. + +.SH "SEE ALSO" +.BR sane (7), +.BR sane\-usb (5), +.BR sane\-gt68xx (5), +.BR sane\-plustek (5), +.BR sane\-mustek_usb (5), +.BR sane\-mustek (5), +.BR sane\-mustek_pp (5), +.br +.I http://www.meier\-geinitz.de/sane/ma1509\-backend/ + +.SH AUTHOR +Henning Meier-Geinitz + +.SH BUGS +Resolutions higher than 600 dpi don't work +.br +Transparency adapter and automatic document feeder is not supported yet +.br +No support for "high-speed" mode (jpeg) +.PP +More detailed bug information is available at the MA-1509 backend homepage +.IR http://www.meier\-geinitz.de/sane/ma1509-backend/ . -- cgit v1.2.3