Comments, questions and corrections for programmers manual

Petter Reinholdtsen (pere@hungry.com)
Mon, 23 Nov 1998 13:26:26 +0100

4.2.8 Device Descriptor Type

Table uses 'Noname' while text describes 'None' as the virtual device vendor. Typo?

4.3.4 sane_open:

'As a special case, an empty device name requests opening the first
available device (if there is such a device).'

What is 'an empty name'? Is it NULL, or ""? I beleave
sane_open(NULL, &handle) should return the first available scanner,
but is that according to plan?

4.3.14 sane_strstatus

How long is the return pointer valid? Until next call to strstatus()
or forever?

4.4 Code Flow

'Once all desired frames has been acquired, function sane_cancel()
must be called.'

Do I need to call sane_cancel() even if sane_read() has returned
SANE_STATIS_EOF?

5.2.8 SANE_NET_START

If the reply value byte_order contains the byte order, there should be
no need for the data record to start with length spesified as unsigned
integer in big-endian format. Why is this inconsistency there?

Big endian format is the same as network order. The text should make
a comment about that.

5.2.10 SANE_NET_AUTHORIZE

Must the protocol be changed to handle encrypted network
communications when it comes to username/password?

This network request should contain which encryption method is used to
hide the password. Maybe there also should be a new message type to
get a challenge/public key from the server to use when encrypting the
password.

--
Source code, list archive, and docs: http://www.mostang.com/sane/
To unsubscribe: echo unsubscribe sane-devel | mail majordomo@mostang.com