[sane-devel] [fujitsu] Documentation patch: scsi-buf-size notes

[Paul Walmsley]

This documentation patch adds some extra notes about the scsi-buf-size 
option in the sane-fujitsu driver.  


- Paul


--- sane-backends/doc/sane-fujitsu.man	Tue Jul  6 00:53:34 2004
+++ sane-backends-patched/doc/sane-fujitsu.man	Tue Jul  6 00:54:43 2004
@@ -151,13 +151,27 @@
 
 .br
 
 The only other configuration option supported is "scsi-buf-size=xxx",
 allowing you to set the SCSI buffer size to something other than the
-compiled-in default. Especially with the M3091 scanner, some users
-had the problem that the scanner would "hang" mid-page, and this can
-often be alleviated by using "scsi-buf-size=32768".
+compiled-in default. Especially with the M3091 scanner, some users had
+the problem that the scanner would "hang" mid-page, and this can often
+be alleviated by using "scsi-buf-size=32768".  This option is also
+useful for scanners which require all image data to be fetched in a
+single SCSI read, as is the case for most of the M30xx series if
+they do not have the CMP-2 board installed.  With these scanners,
+sane-fujitsu will only return a partial page image unless the SCSI
+buffer size is large enough to hold an entire page's image data. 
+
+.br
+
+For the "scsi-buf-size" option to be effective, it must be
+specified in the configuration file
+.B before
+any "scsi" directives.  Also, on Linux, if "scsi-buf-size" is set to
+something large, you will probably have to set the SANE_SG_BUFFERSIZE
+environment variable to at least the same value.
 
 .SH "SEE ALSO"
 sane(7),
 sane\-scsi(5),
 sane\-sp15c(5)