>Let me put in a request that the documentation be improved to add
>information about which versions of the PalmOS support each function.
>
>For SelectOneTime, the docs say "Implemented only if 3.1 New Feature Set is
>present." which gives me a clue that I can't use this function with pre-3.1
>systems. However, in other cases, such as SerReceive, there is nothing that
>tells me that this function does not exist prior to PalmOS 2.0.
That's precisely why we added the Compatibility appendix. You're right, it
doesn't talk about SerReceive; that seems to be a bug in the docs. But
there are plenty of other functions listed in there... I presume that's
what you want, though with SerReceive added?
>I am also going to take this opportunity to complain LOUDLY about the
>naming convention for OS functions.
We beat this topic to death in a thread here a while back. The reasoning
from the folks who originally used this convention was that the initial
versions of the APIs would go away in the future, and so when people
upgraded their SDK they should use the new form. The arguments in the
other direction were clearly (and repeatedly) stated... FWIW, there weren't
any parameter changes like this in 3.1 or 3.2.
-David Fedor
Palm Developer Support
