1 files changed, 131 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man5/sane-hs2p.5 b/upstream/debian-unstable/man5/sane-hs2p.5
new file mode 100644
index 00000000..879789e6
--- /dev/null
+++ b/upstream/debian-unstable/man5/sane-hs2p.5
@@ -0,0 +1,131 @@
+.TH sane\-hs2p 5 "13 Jul 2008" "" "SANE Scanner Access Now Easy"
+.IX sane\-hs2p
+.SH NAME
+sane\-hs2p \- SANE backend for Ricoh SCSI flatbed/ADF scanners
+.SH DESCRIPTION
+The
+.B sane\-hs2p
+library implements a SANE (Scanner Access Now Easy) backend that provides
+access to the Ricoh IS450 family of scanners. Should also work with the IS420,
+IS410, and IS430 scanners, but these are untested.
+Please contact the maintainer or the sane\-devel mailing list if you own such a scanner.
+.PP
+This backend is alpha-quality. It may have bugs and some scanners haven't been
+tested at all. Be careful and pull the plug if the scanner causes unusual
+noise.
+
+.SH "DEVICE NAMES"
+This backend expects device names of the form:
+.PP
+.RS
+.I special
+.RE
+.PP
+Where
+.I special
+is the path-name for the special device that corresponds to a SCSI
+scanner. The program
+.BR sane\-find\-scanner (1)
+helps to find out the correct device. Under Linux, such a device name could be
+.I /dev/sg0
+or
+.IR /dev/sga ,
+for example.  See
+.BR sane\-scsi (5)
+for details.
+
+.SH CONFIGURATION
+The contents of the
+.I hs2p.conf
+file is a list of device names that correspond to SCSI
+scanners.  Empty lines and lines starting with a hash mark (#) are
+ignored.  See
+.BR sane\-scsi (5)
+on details of what constitutes a valid device name.
+
+.SH FILES
+.TP
+.I /etc/sane.d/hs2p.conf
+The backend configuration file (see also description of
+.B SANE_CONFIG_DIR
+below).
+.TP
+.I /usr/lib/x86_64-linux-gnu/sane/libsane\-hs2p.a
+The static library implementing this backend.
+.TP
+.I /usr/lib/x86_64-linux-gnu/sane/libsane\-hs2p.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_HS2P
+If the library was compiled with debug support enabled, this
+environment variable controls the debug level for this backend.
+A value of 255 prints all debug output.  Smaller values reduce verbosity.
+
+.SH CURRENT STATUS
+The
+.B sane\-hs2p
+backend is now in version 1.00. All major scanning-related features
+are supported, except for those features requiring the optional IPU. Scanning
+from the flatbed or ADF (either simplex or duplex) is supported. Lineart,
+halftone, 4-bit gray, and 8-bit gray are supported. Pre-set gamma tables and
+halftone patterns are supported, as well as brightness, threshold, contrast.
+Also supported is scan wait mode, binary and gray filtering, negative scanning,
+and absolute or relative white setting. Printing with the optional endorser
+also is supported.
+
+.SH PLANNED FUNCTIONALITY
+This scanner can scan from the ADF in continuous simplex mode.
+Surprisingly, many scanners scan an entire document from the ADF
+into memory before ejecting the sheet. Thus if the document is too
+long, the scanner cannot hold the entire image data in memory.
+But if the scanner would send its image data when its memory got full,
+and then read the next buffer's worth of data, continuous scanning
+could be achieved.
+
+.SH MISSING FUNCTIONALITY
+The SCSI commands for uploading (2AH) or downloading (28H)
+custom halftone patterns (02H) and gamma vectors (03H) should work,
+but require implementing the SANE Option-Value code to allow the
+user to create the tables to be uploaded to the scanner. No support
+for Maintenance Data (80H) is planned as this functionality is more
+suited to a stand-alone utility to be used by a technician when
+replacing the lamp or ADF unit. Nor is support for reading or changing
+IPU (93H) parameters and adjustments planned, since my IS450 lacks
+such a unit. The 31-byte Auto Photo/Letter struct and 21-byte Dynamic
+threshold struct are documented in the
+.I hs2p-scsi.h
+file should someone wish to use their IPU for image data processing.
+
+.SH "SEE ALSO"
+.BR sane (7),
+.BR sane\-find\-scanner (1),
+.BR sane\-scsi (5),
+
+.SH AUTHOR
+jeremy
+.RI < jeremy@acjlaw.net >
+.br
+Maintained by Jeremy Johnson
+.RI < jeremy@acjlaw.net >