On Tue, Apr 16, 2002 at 11:42:05PM +1200, Chris Tutty wrote:
> FtrGet is documented as returning 0 if no error. Can someone check
> the source to see whether it actually returns errNone (in which case
> I'll raise a documentation bug).
Since errNone is a preprocessor symbol expanding to something equivalent
to (and of the same type as) 0, and that value (of course) can't change
for reasons of binary compatibility:
How will you tell the difference?
There's a point of view that says the documentation ought to be written
in terms of "high level" names like errNone. There's another point of
view that says the overuse of pointless names for things is confusing in
itself and that 0 is in fact more comprehensible than errNone, especially
when you try to explain what the difference between errNone, hostErrNone,
pwrErrNone, and inetErrNone might or might not be.
(The answer to your question btw, in the 3.0, 3.5, and 4.0 publicly
released source, is that the code says "0", and everyone knows that's the
same as errNone. Oh, and Aaron should read the question next time :-).)
John
--
For information on using the Palm Developer Forums, or to unsubscribe, please see
http://www.palmos.com/dev/support/forums/
