summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-rawhide/man5/sane-coolscan.5
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-rawhide/man5/sane-coolscan.5')
-rw-r--r--upstream/fedora-rawhide/man5/sane-coolscan.5111
1 files changed, 111 insertions, 0 deletions
diff --git a/upstream/fedora-rawhide/man5/sane-coolscan.5 b/upstream/fedora-rawhide/man5/sane-coolscan.5
new file mode 100644
index 00000000..68ce70a7
--- /dev/null
+++ b/upstream/fedora-rawhide/man5/sane-coolscan.5
@@ -0,0 +1,111 @@
+.TH sane\-coolscan 5 "13 Jul 2008" "" "SANE Scanner Access Now Easy"
+.IX sane\-coolscan
+
+.SH NAME
+sane\-coolscan \- SANE backend for Nikon film-scanners
+
+.SH ABOUT THIS FILE
+
+This file is a short description of the coolscan backend for
+.BR SANE .
+
+.SH DESCRIPTION
+
+The
+.B sane\-coolscan
+library implements a SANE backend that provides the interface to the following Nikon
+Coolscan Film scanners: Nikon LS20, LS30, LS1000, LS2000.
+
+.B Even though the backend has worked for a number of people, there are still some
+problems, especially in combination with some SCSI card/drivers (AHA-1505/aha152x.o)
+and the autofocus command.
+You should consider this backend 'alpha' and be careful when using it the first time.
+
+.SH CONFIGURATION
+
+The configuration file for this backend resides in
+.IR /etc/sane.d/coolscan.conf .
+
+Its content is a list of device names that correspond to Nikon Coolscan scanners. Empty lines
+and lines starting with a hash mark (#) are ignored. A sample configuration file is
+shown below:
+
+.nf
+ #scsi Vendor Model Type
+ scsi Nikon * Scanner
+ /dev/scanner
+.fi
+
+The special device name must be a generic SCSI device or a symlink to such a device.
+To find out to which device your scanner is assigned and how you can set the
+permissions of that device, have a look at
+.BR sane\-scsi (5).
+
+.SH SCSI ADAPTER TIPS
+
+Some SCSI-adapters and low-level SCSI drivers do not work correctly with this backend and the
+Coolscan scanners. These systems hang when the autofocus command is send to the Scanner.
+To see a list of which card/driver combinations work or don't work have a look at:
+.I http://andreas.rick.free.fr/sane/autofocus.html.
+
+.SH FILES
+.TP
+The backend configuration file:
+.I /etc/sane.d/coolscan.conf
+.TP
+The static library implementing this backend:
+.I /usr/lib64/sane/libsane\-coolscan.a
+.TP
+The shared library implementing this backend:
+.I /usr/lib64/sane/libsane\-coolscan.so
+(present on systems that support dynamic loading)
+
+.SH ENVIRONMENT
+
+.TP
+.B SANE_DEBUG_COOLSCAN
+If the library was compiled with debug support enabled, this environment
+variable controls the debug level for this backend. E.g., a value of 128
+requests all debug output to be printed. Smaller levels reduce verbosity.
+
+Examples:
+
+On bash:
+.br
+export SANE_DEBUG_COOLSCAN=8
+
+On csh:
+.br
+setenv SANE_DEBUG_COOLSCAN 8
+
+.SH BUGS
+
+The autofocus command does not work with some SCSI card/driver combinations.
+.PP
+The gamma table is not implemented for the LS1000 yet.
+.PP
+The dust-removal is not working yet.
+
+.SH SEE ALSO
+.BR sane (7),
+.BR sane\-scsi (5)
+
+.TP
+.I http://andreas.rick.free.fr/sane/
+The homepage of this backend.
+.TP
+.I http://www.sema.be/coolscan/
+The original version of the coolscan backend by Didier.
+
+.SH THANKS TO
+Didier Carlier \- For writing the original Coolscan backend (without it I would not have started this).
+.PP
+Oliver Rauch \- For adapting xsane so quickly to the infrared stuff.
+.PP
+All the other people working on SANE.
+
+.SH AUTHOR
+Andreas Rick
+
+.SH EMAIL-CONTACT
+.I andreas.rick@free.fr