Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 121 insertions, 0 deletions

diff --git a/upstream/debian-unstable/man5/sane-hpsj5s.5 b/upstream/debian-unstable/man5/sane-hpsj5s.5
new file mode 100644
index 00000000..ac0f69ab
--- /dev/null
+++ b/upstream/debian-unstable/man5/sane-hpsj5s.5
@@ -0,0 +1,121 @@
+.TH sane\-hpsj5s 5 "13 Jul 2008" "" "SANE Scanner Access Now Easy"
+.IX sane\-hpsj5s
+.SH NAME
+sane\-hpsj5s \- SANE backend for HP ScanJet 5S sheet-fed scanner
+.SH DESCRIPTION
+The
+.B sane\-hpsj5s
+library implements a SANE (Scanner Access Now Easy) backend that
+provides access to a parallel port Hewlett-Packard ScanJet 5S scanner.
+.PP
+IMPORTANT: this is alpha code. Don't expect this to work
+correctly. Many functions are missing, others contain errors. In some
+cases, your computer might even hang. It cannot be excluded (although
+I consider it extremely improbable) that your scanner will be
+damaged.
+.PP
+LIMITATIONS: For now this backend works only on Linux.  This limitation
+is due to dependence on the
+.BR libieee1284 (3)
+library. If your system supports
+.BR libieee1284 (3)
+too, this backend should work. If you ported
+.BR libieee1284 (3)
+for your platform, please let me know. Your system should support
+.B EPP
+(or
+.BR EPP+ECP )
+mode to operate this scanner. Future versions will support ECP and SPP
+(Nibble and Byte) modes also. It's planned to support scanners not only
+at daisy-chain position 0, but anywhere. Support for multiple scanners could
+be implemented too.
+.PP
+Current version implements only gray scale scanning. True Color and B/W modes are
+not supported for now.
+.PP
+That said, TESTERS ARE WELCOME. Send your bug reports and comments to
+Max Vorobiev
+.RI < pcwizard@yandex.ru >.
+.PP
+.SH "DEVICE NAMES"
+This backend expects device names of the form:
+.PP
+.RS
+.I special
+.RE
+.PP
+Where
+.I special
+is the parallel port name in form,
+.BR libieee1284 (3)
+expects. It seems to be system dependent. Under Linux it's parport0, parport1, etc.
+.SH CONFIGURATION
+The contents of the
+.I hpsj5s.conf
+file is a list of parport names that correspond to HP ScanJet 5S
+scanners.  Empty lines and lines starting with a hash mark (#) are
+ignored.  Only one device name can be listed in
+.IR hpsj5s.conf
+for this moment. Future versions will support daisy chain selection.
+
+.SH TIPS
+.PP
+It seems that HP ScanJet 5S scanner uses software noise correction. This
+feature, along with gamma correction and calibration, are not implemented for now.
+They will be handled in future versions.
+Native resolution for this scanner is 300 DPI.
+Other modes may present aliasing artifacts.
+.PP
+.SH FILES
+.TP
+.I /etc/sane.d/hpsj5s.conf
+The backend configuration file (see also description of
+.B SANE_CONFIG_DIR
+below).
+.TP
+.I /usr/lib/x86_64-linux-gnu/sane/libsane\-hpsj5s.a
+The static library implementing this backend.
+.TP
+.I /usr/lib/x86_64-linux-gnu/sane/libsane\-hpsj5s.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.  On *NIX systems, 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
+.IR /etc/sane.d .
+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
+.IR tmp/config ,
+.IR . ,
+and
+.I "/etc/sane.d"
+being searched (in this order).
+.TP
+.B SANE_DEBUG_HPSJ5S
+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 libieee1284 (3)
+.br
+.I http://hpsj5s.sourceforge.net
+.br
+.I http://cyberelk.net/tim/libieee1284
+.br
+.SH AUTHOR
+Max Vorobiev
+.br
+Man page mostly based on
+.IR canon.man .