Initial import of sane-backends version 1.0.24-1.2

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.