diff options
Diffstat (limited to 'upstream/fedora-rawhide/man5/sane-hpsj5s.5')
| -rw-r--r-- | upstream/fedora-rawhide/man5/sane-hpsj5s.5 | 121 |
1 files changed, 121 insertions, 0 deletions
diff --git a/upstream/fedora-rawhide/man5/sane-hpsj5s.5 b/upstream/fedora-rawhide/man5/sane-hpsj5s.5 new file mode 100644 index 00000000..f7766102 --- /dev/null +++ b/upstream/fedora-rawhide/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/lib64/sane/libsane\-hpsj5s.a +The static library implementing this backend. +.TP +.I /usr/lib64/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 . |