[sane-devel] Sensors and buttons

[Ralph Little]

Hi,
I just have a comment about terminology in sane which I find very confusing.

I was just looking at the output of options from scanimage -h for a 
genesys device:

   Sensors:
     --scan[=(yes|no)] [no] [hardware]
         Scan button
     --email[=(yes|no)] [no] [hardware]
         Email button
     --copy[=(yes|no)] [no] [hardware]
         Copy button
   Buttons:
     --clear-calibration
         Clear calibration cache
     --force-calibration
         Force calibration ignoring all and any calibration caches
     --ignore-internal-offsets
         Acquires the image including the internal calibration areas of the
         scanner

At a quick glance I assumed that this was an error: the "buttons" and 
"sensors" titles are obviously the wrong way round.
I was halfway through crafting a patch when I realised that the 
situation is far from clear.

Here we have a set of options about scanner push buttons under the 
sensors group, and CIS sensor options related to calibration under the 
buttons group.
However, the scan/email/copy items are sensors (in the sense that they 
are sensed) and the calibration options are "button" value type in that 
they have a side-effect.

Does anyone have a comment on this? Am I completely wrong?

Cheers,
Ralph