[sane-devel] [PATCH] doc/descriptions.txt: Document the `:scsi` keyword

[Paul Menzel]

Date: Fri, 15 Feb 2013 12:18:56 +0100

The `:scsi` keyword is introduced in the following commit.

    commit acc2b0fccf0c67b5b7851314dce340fdba1cb960
    Author: Julien BLACHE <jb at jblache.org>
    Date:   Tue Jan 13 21:17:16 2009 +0000

        Add a new :scsi keyword for SCSI devices, add support for SCSI devices in the udev and HAL FDI outputs.
---
Please apply with `git am /path/to/this/mbox`.

 doc/descriptions.txt |   13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/descriptions.txt b/doc/descriptions.txt
index d4cab94..95ed9e1 100644
--- a/doc/descriptions.txt
+++ b/doc/descriptions.txt
@@ -91,6 +91,19 @@ be used if no vendor or product ids are given intentionally, e.g. for a group of
 scanners.
 Example: `:usbid "0x1234" "0x4321"'
 
+`:scsi' defines the SCSI vendor and model name of the device and should be used
+for devices advertising itself as a SCSI processor device, which are not dealt
+with in the wild card rule for SCSI scanner devices advertising themselves
+correctly as a SCSI scanner device.
+(See <http://en.wikipedia.org/wiki/SCSI_Peripheral_Device_Type>.)
+The keyword has three arguments, which can be retrieved by the `lsscsi' command
+or `udevadm info -a -p /sys/class/scsi_generic/…'. The first one is the vendor id,
+the second one theh model name. The third argument has to be `processor'.
+Otherwise `sane-desc` will abort.
+The keyword is optional, and applicable for devices with `:interface "SCSI"'.
+only, and should be used only once per model.
+Example: `:scsi "HP" "C5110A" "processor"'
+
 The keyword `:status' is an indication of the level of support for the model.
 It's followed by one of the following keyword arguments: `:unsupported',
 `:untested', `:minimal', `:basic', `:good', or `:complete'. The `:status'
-- 
1.7.10.4
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part
URL: <http://lists.alioth.debian.org/pipermail/sane-devel/attachments/20130215/014287f6/attachment.pgp>