Package: libsane
Version: 1.0.17-1
Severity: normal
Tags: patch
Found some typos in '/usr/share/man/man5/sane-apple.5.gz', a '.diff' is
attached.
About the 'normal' severity, instead of the usual 'minor'. It's not
minor; while correcting typos, I attempted to remove needless words and
fix a host of English grammar errors, while preserving the exact
meaning of the original, and as much as possible of the style.
Caveat, or "beware of diff": there's so many corrections it makes the
'diff' rather 'diff'-icult to read, perhaps even headache-inducing. It
might be less labor for the maintainer to just patch it to a temp man
page, and skim that to see if anything looks wrong -- and consult the
'diff' file only for the odd bits.
Hope this helps...
-- System Information:
Debian Release: testing/unstable
APT prefers unstable
APT policy: (500, 'unstable')
Architecture: i386 (i686)
Shell: /bin/sh linked to /bin/bash
Kernel: Linux 2.6.15-1-686
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968) (ignored: LC_ALL set to C)
Versions of packages libsane depends on:
ii adduser 3.85 Add and remove users and groups
ii libc6 2.3.6-3 GNU C Library: Shared libraries an
ii libgphoto2-2 2.1.6-6 gphoto2 digital camera library
ii libgphoto2-port0 2.1.6-6 gphoto2 digital camera port librar
ii libieee1284-3 0.2.10-1 cross-platform library for paralle
ii libjpeg62 6b-12 The Independent JPEG Group's JPEG
ii libusb-0.1-4 2:0.1.11-6 userspace USB programming library
ii makedev 2.3.1-80 creates device files in /dev
Versions of packages libsane recommends:
ii hotplug 0.0.20040329-25 Linux Hotplug Scripts
ii sane-utils 1.0.17-1 API library for scanners -- utilit
-- no debconf information
--- sane-apple.5 2005-12-18 11:20:14.000000000 -0500
+++ /tmp/sane-apple.5 2006-03-18 01:07:14.000000000 -0500
@@ -45,7 +45,7 @@
.IR /dev/sge ,
for example. See sane-scsi(5) for details.
.SH CONFIGURATION
-The contents of the
+The
.I apple.conf
file is a list of options and device names that correspond to Apple
scanners. Empty lines and lines starting with a hash mark (#) are
@@ -53,16 +53,16 @@
device name.
.PP
Options come in two flavors: global and positional ones. Global
-options apply to all devices managed by the backend whereas positional
+options apply to all devices managed by the backend, whereas positional
options apply just to the most recently mentioned device. Note that
this means that the order in which the options appear matters!
.SH SCSI ADAPTER TIPS
SCSI scanners are typically delivered with an ISA SCSI adapter.
Unfortunately, that adapter is not worth much since it is not
-interrupt driven. It is (sometimes) possible to get the supplied card
-to work, but without interrupt line, scanning will put so much load on
-the system, that it becomes almost unusable for other tasks.
+interrupt driven. It is sometimes possible to get the supplied card
+to work, but without an interrupt line, scanning will put so much load on
+the system that it becomes almost unusable for other tasks.
.SH FILES
.TP
.I /etc/sane.d/apple.conf
@@ -79,30 +79,28 @@
.SH ENVIRONMENT
.TP
.B SANE_CONFIG_DIR
-This environment variable specifies the list of directories that may
-contain the configuration file. Under UNIX, 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 /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
+This environment variable is list of directories where SANE looks
+for the configuration file. Under UNIX directory names are
+separated by a colon (`:'), under OS/2 by a semi-colon (`;').
+If SANE_CONFIG_DIR is not set, SANE defaults to
+searching the current working directory (".") and then /etc/sane.d.
+If the value of $SANE_CONFIG_DIR ends with the separator
+character, the default directories are searched after the directory list.
+For example, setting
.B SANE_CONFIG_DIR
to "/tmp/config:" would result in directories "tmp/config", ".", and
-"/etc/sane.d" being searched (in this order).
+"/etc/sane.d" being searched (in that order).
.TP
.B SANE_DEBUG_APPLE
-If the library was compiled with debug support enabled, this
-environment variable controls the debug level for this backend. E.g.,
-a value of 255 requests all debug output to be printed. Smaller
-levels reduce verbosity.
+Controls the debug level. A value of 255 prints
+all debug output. Smaller values reduce verbosity. Requires a
+library compiled with debug support.
.SH CURRENT STATUS
The apple backend is now in version 0.3 (Tue Jul 21 1998). Since
I only have the AppleScanner and not the other models (OneScanner,
ColorOneScanner) I can only develop/test for the AppleScanner effectively.
-However with this release I almost complete the gui part of all scanners.
+However with this release I almost completed the gui part of all scanners.
Most of the functionality is there. At least OneScanner should scan
at the AppleScanner's compatible modes (LineArt, HalfTone, Gray16). My
personal belief is that with a slight touch of debugging the OneScanner
@@ -110,89 +108,90 @@
is of course almost fully supported.
.SH MISSING FUNCTIONALITY
-Currently all 3 models are lacking upload/dowload support.
+Currently all three models lack upload/download support.
.TP
.B AppleScanner
Cannot up/download a halftone pattern.
.TP
.B OneScanner
-Cannot up/download halftone pattern and calibration vector.
+Cannot up/download halftone patterns or calibration vectors.
.TP
.B ColorOneScanner
-Cannot up/download halftone pattern, calibration vectors,
-custom Color Correction Table (CCT) and of course custom gamma tables.
+Cannot up/download halftone patterns, calibration vectors,
+custom Color Correction Tables (CCT) and of course custom gamma tables.
.TP
.B Park/UnPark (OneScanner, ColorOneScanner)
.PP
-The above functionalities are not only missing because I don't actually
-have the hardware to experiment on it. Another reason is the lack
-of understanding of how SANE API could provide enaugh means to me
-to actually describe other array types than the gamma one.
+The above functionalities are missing because I don't
+have the hardware to experiment on. Another reason is my lack
+of understanding as to how or if the SANE API provide means
+to describe any array type besides gamma.
+
.SH UNSUPPORTED FEATURES
-The following "features" will never be supported. At least as I am maintaining
+The following "features" will never be supported, at least while I maintain
the sane-apple backend.
.TP
.B NoHome (AppleScanner)
The scanner lamp stays on and the carriage assembly remains where it stops
at the end of the scan. After two minutes, if the scanner does not receive
-another SCAN command the lamp goes off and the carriage returns to the home
+another SCAN command, the lamp goes off and the carriage returns to the home
position.
.TP
.B Compression (AppleScanner)
-The Scanner can compress data with CCITT Group III, one dimensional algorithm
-(fax), and the Skip White Line algorithm.
+The Scanner can compress data with CCITT Group III one dimensional algorithm
+(fax) and the Skip White Line algorithm.
.TP
.B Multiple Windows (AppleScanner)
AppleScanner may support multiple windows. It would be a cool feature
-and a challenge for me to code it if you could intermix different options
-for different windows (scan areas). This way you could scan a document
-in LineArt mode but the figures in it on Gray and in a different resolution.
+and a challenge for me to code if it could intermix different options
+for different windows (scan areas). This way it could scan a document
+in LineArt mode but the figures in it in Gray and at a different resolution.
Unfortunately this is impossible.
.TP
.B Scan Direction (OneScanner)
It controls the scan direction. (?)
.TP
.B Status/Reset Button (OneScanner)
-This option controls the status of the button in OneScanner model. You can
+This option controls the status of the button on the OneScanner model. You can
also reset the button status by software.
.SH BUGS
-The bugs in a sane backend are divided in two classes. We have
+SANE backend bugs are divided in two classes. We have
.B GUI
bugs and
.B scanner specific
bugs.
.PP
-We know we have a GUI bug when a parameter is not showing up itself when it
-should (active) or vice versa. To find out which parameters are active
-accross various Apple modes and models from the documentation
+We know we have a GUI bug when a parameter is not showing up when it
+should (active) or vice versa. Finding out which parameters are active
+across various Apple modes and models from the documentation
.B
ftp://ftpdev.info.apple.com/devworld/Technical_Documentation/Peripherals_Documentation/
-is an interesting exercise. I may missed some dependancies. For example
-for the threshold parameter the Apple Scanners Programming guide says
-nothing. I had to assume that is valid only in LineArt mode.
+is an interesting exercise. I may have missed some dependencies. For example
+of the threshold parameter the Apple Scanners Programming Guide says
+nothing. I had to assume it is valid only in LineArt mode.
.PP
-Scanner specific bugs are mostly due to mandatory round offs in order to
-scan. In the documentation in some place states that the width of the
-scan area should be a byte multiple. In an other place says that the
+Scanner specific bugs are mostly due to mandatory round-offs in order to
+scan. In the documentation in one place states that the width of the
+scan area should be a byte multiple. In another place it says that the
width of the scan area should be an even byte multiple. Go figure...
.PP
-Other source of bugs are due to scsi communcation, scsi connects and
+Other sources of bugs are due to scsi communication, scsi connects and
disconnects. However the classical bugs are still there. So you may
-encouter buffer overruns, null pointers, memory corruption and
+encounter buffer overruns, null pointers, memory corruption and
.B SANE
API violations.
.TP
.B SIGSEGV on SliceBars
When you try to modify the scan area from the slice bar you have a nice
-little cute core dump. I don't know why. If you select the scan are from
-the preview window, or by hand typing the numbers everything is fine. The
+little cute core dump. I don't know why. If you select the scan area from
+the preview window or by hand typing the numbers everything is fine. The
SIGSEGV happens deep in gtk library (gdk). I really cannot debug it.
.TP
.B Options too much
-It is possible, especially for the ColorOneScanner, that the backend's
-options panel to exceed from your screen. It happens with mine
-and I am running at 1024x768 my X Server. What can I say? Try smaller
+It is possible, especially for the ColorOneScanner, for the backend's
+options panel to extend beyond your screen. It happens with mine
+and I am running my X Server at 1024x768. What can I say? Try smaller
fonts in the X server, or virtual screens.
.TP
.B Weird SCSI behaviour
@@ -211,36 +210,36 @@
hardware, or may be bugs in your driver or in SANE itself...
.SH DEBUG
-If you encounter a GUI bug please set the environment variable
-SANE_DEBUG_APPLE to 255 and rerun the excact sequence of keystrokes
+If you encounter a GUI bug please set the environmental variable
+SANE_DEBUG_APPLE to 255 and rerun the exact sequence of keystrokes
and menu selections to reproduce it. Then send me a report with the
log attached.
.PP
-It would be very helpfull if you have handy an Apple machine (I am not sure
-how Mackintoshs are spelled) with the AppleScanners driver installed and check
-what option are grayed out (inactive) in what modes and report back to me.
+If you have an Apple Macintosh with the AppleScanners driver installed,
+reporting to me which options are grayed out (inactive) in what modes
+would be very helpful.
.PP
-If you want to offer some help but you don't have a scanner or you
-don't have the model you would like to offer some help, or you are
-a sane developer and you just want to take a look at how the apple backend
-looks like. Goto to apple.h and #define the NEUTRALIZE_BACKEND
+If you want to offer some help but you don't have a scanner, or you
+don't have the model you would like to help with, or you are
+a SANE developer and you just want to take a look at how the apple backend
+looks like, goto to apple.h and #define the NEUTRALIZE_BACKEND
macro. You can select the scanner model through the APPLE_MODEL_SELECT
macro. Available options are APPLESCANNER, ONESCANNER, COLORONESCANNER.
.PP
If you encounter a SCSI bus error or trimmed and/or displaced images please
-also set the environment variable SANE_DEBUG_SANEI_SCSI to 255 before sendme
+set the environment variable SANE_DEBUG_SANEI_SCSI to 255 before sending me
the report.
.SH TODO
.TP
.B Non Blocking Support
-Make sane-apple a non blocking backend. Properly support for
+Make sane-apple a non blocking backend. Properly support
.B sane_set_io_mode
and
.B sane_get_select_fd
.TP
.B Scan
-Make scan possible for all models in all supported modes.
+Make scanning possible for all models in all supported modes.
.TP
.B Missing Functionality
