summaryrefslogtreecommitdiff
path: root/doc/descriptions-external/template.desc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/descriptions-external/template.desc')
-rw-r--r--doc/descriptions-external/template.desc77
1 files changed, 77 insertions, 0 deletions
diff --git a/doc/descriptions-external/template.desc b/doc/descriptions-external/template.desc
new file mode 100644
index 0000000..ce5d077
--- /dev/null
+++ b/doc/descriptions-external/template.desc
@@ -0,0 +1,77 @@
+;
+; SANE Backend specification file
+;
+; It's basically emacs-lisp --- so ";" indicates comment to end of line.
+; All syntactic elements are keyword tokens, followed by a string or
+; keyword argument, as specified.
+;
+; ":backend" *must* be specified.
+; All other information is optional (but what good is the file without it?).
+;
+; See doc/descriptions.txt for details.
+
+:backend "template" ; name of backend
+:version "0.42" ; version of backend (or "unmaintained")
+:manpage "sane-template" ; name of manpage (if it exists)
+:url "http://www.luser.com/temp/" ; backend's web page
+:url "http://www.luser.com/b/" ; another backend webpage
+:comment "This backend supports only the USB and SCSI models"
+ ; comment about the backend
+
+:devicetype :scanner ; start of a list of devices....
+ ; other types: :stillcam, :vidcam,
+ ; :meta, :api
+
+:mfg "TemPlate" ; name a manufacturer
+:url "http://www.template.com/" ; manufacturer's URL
+:url "http://www.template.de/" ; another manufacturer URL
+:comment "TemPlate scanners are sometimes labeled \"TMP\""
+ ; comment about the manufacturer
+
+:model "Templ Z" ; name models for above-specified mfg.
+:status :untested ; :minimal, :basic, :good, :complete
+ ; :untested, or :unsupported
+:interface "SCSI" ; interface type of the device:
+ ; "SCSI", "USB", "Parport (EPP)",
+ ; "Parport (SPP)", "Parport (ECP)",
+ ; "Serial port", "IEEE-1394", "JetDirect",
+ ; or "Proprietary".
+:usbid "0x1234" "0x4321" ; Vendor and product ids of an USB device
+:url "http://www.tmp.com/z.html" ; model's URL
+:comment "With Z-Axis scrolling" ; comment about the model
+
+:model "Templ ZS"
+:interface "USB"
+:usbid "0x1234" "0x4322"
+:status :unsupported
+:comment "No support yet, but we have docs."
+
+:model "Templ ZQ"
+:interface "USB"
+:usbid "0x1234" "0x4323"
+:status :minimal
+
+:model "Templ ZY"
+:interface "SCSI"
+:status :basic
+
+:model "Templ ZZ"
+:interface "SCSI"
+:status :good
+
+:mfg "ArmorPlate" ; another manufacturer...
+:url "http://www.armorplate.com/"
+
+:model "AmplScan II"
+:interface "SCSI"
+:status :complete
+:comment "AmplScan *II*, not AmplScan!"
+
+:devicetype :api ; specify a different type
+:desc "Interface to FrObYz API" ; describe a non-hardware device
+:comment "Only FrObYz version 2.0 is supported!"
+
+; :comment and :url specifiers are optional after :mfg, :model, :desc,
+; and at the top-level.
+
+; :status specifier is optional after :model and at the top-level