summaryrefslogtreecommitdiff
path: root/doc/sane-p5.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-p5.man
Initial import of sane-backends version 1.0.24-1.2
Diffstat (limited to 'doc/sane-p5.man')
-rw-r--r--doc/sane-p5.man160
1 files changed, 160 insertions, 0 deletions
diff --git a/doc/sane-p5.man b/doc/sane-p5.man
new file mode 100644
index 0000000..860a019
--- /dev/null
+++ b/doc/sane-p5.man
@@ -0,0 +1,160 @@
+.TH "sane\-p5" "5" "15 Feb 2010" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
+.IX sane\-p5
+.SH "NAME"
+sane\-p5 \- SANE backend for the Primax PagePartner
+.SH "DESCRIPTION"
+The
+.B sane\-p5
+library implements a SANE (Scanner Access Now Easy) backend that
+provides access to the Primax PagePartner parallel port sheet fed scanner.
+.PP
+This backend handles 100, 150, 200, 300 and 600 dpi scan resolutions,
+in color and gray modes. The 600 dpi is actually 300x600 with lines
+enlarged to match the vertical resolution.
+.PP
+.B EPP/ECP MODES ONLY
+The current version of the backend uses only EPP or ECP mode to communicate
+with the scanner. It is
+recommended that you set your parallel port to EPP in BIOS with the current
+version of this backend. ECPEPP will only
+work if you use a 2.4 or 2.6 kernel with ppdev character device support.
+.PP
+
+.SH "DEVICE NAMES"
+This backend expects device names of the form:
+.PP
+.RS
+.I port value
+.RE
+.PP
+Where
+\fBvalue\fR is :
+
+.RS
+.TP
+auto
+autodetect all parallel ports and probe
+them for scanner
+.TP
+/dev/parport0
+uses linux ppdev device, depending on the
+number of available parallel port, you
+have to use /dev/parport1, /dev/parport2, ...
+.PP
+.RE
+You can rename any device using the
+.PP
+.RS
+.br
+.I option name my_name
+.RE
+.PP
+option. This option apply to the last port option.
+
+.SH "CONFIGURATION"
+Please make sure to edit dll.conf
+.B before
+you use the backend, since this backend isn't enabled by default.
+.PP
+
+.PP
+
+
+
+.SH "FILES"
+.TP
+.I @CONFIGDIR@/p5.conf
+The backend configuration file (see also description of
+.B SANE_CONFIG_DIR
+below).
+.TP
+.I @LIBDIR@/libsane\-p5.a
+The static library implementing this backend.
+.TP
+.I @LIBDIR@/libsane\-p5.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_P5
+If the library was compiled with debug support enabled, this
+environment variable controls the debug level for this backend. E.g.,
+a value of 255 requests all debug output to be printed. Smaller
+levels reduce verbosity.
+
+.PP
+.RS
+.ft CR
+.nf
+level debug output
+\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
+ 0 critical errors
+ 1 errors
+ 2 warnings & minor errors
+ 4 information messages
+ 8 start/stop of functions
+ 16 tracing messages
+ 32 I/O functions
+ 64 I/O functions with traces
+ 128 scanned/calibration data
+.fi
+.ft R
+.RE
+.PP
+.TP
+
+.PP
+.RS
+.ft CR
+.nf
+.PP
+
+.PP
+.SH "SEE ALSO"
+sane(7), sane\-net(5), saned(8)
+
+.SH "AUTHOR"
+St\['e]phane Voltz <stef.dev@free.fr>
+
+.SH "CREDITS"
+Support for the Prima PagePartner has been made possible thank to an hardware donation
+by S\['e]bastien Lange.
+
+.SH "BUG REPORTS"
+If something doesn't work mail sane-devel@lists.alioth.debian.org or use the bug
+tracker at https://alioth.debian.org/tracker/?atid=410366&group_id=30186 .
+Please give as much information as you can.
+
+.TP
+.I SANE version
+run "scanimage \-V" to determine this
+.TP
+.I the backend version and your scanner hardware
+run "SANE_DEBUG_P5=255 scanimage \-L 2>log" as root. If you don't get any output
+from the p5 backend, make sure a line "p5" is included into
+your @CONFIGDIR@/dll.conf.
+If your scanner isn't detected, make sure you've defined the right port address, or the
+correct device
+in your p5.conf.
+.TP
+.I the name of your scanner/vendor
+also a worthy information. Please also include the optical resolution and lamp type of your scanner, both can be found in the manual of your scanner.
+.TP
+.I any further comments
+if you have comments about the documentation (what could be done better), or you
+think I should know something, please include it.