At 4:26 PM -0800 2000/03/20, Robert Herold wrote:
>A suggestion for the Palm team: move all APIs which developers should not
>use out of the public headers. Put them into Palm-internal header files
>which are not made available to developers.
We actually have some very good reasons for not doing so with some APIs. For example,
Palm licensees also use our SDKs to create their products. Some of these products
require the use of system-use-only APIs for which we've built special versions of the
Palm OS. But since we do not wish to create a multitude of custom SDKs, one for each
licensee, we simply include the appropriate trap definitions (etc.) in the SDK,
documenting them as system use only.
Grep-ing the headers therefore isn't always the right thing to do to see if a function
is available for use. Rather, checking the documentation is. How else would you
discover how a function works, its restrictions, any side-effects, etc.?
Regards,
Jim Schram
Palm Incorporated
Partner Engineering
--
For information on using the Palm Developer Forums, or to unsubscribe, please see
http://www.palm.com/devzone/mailinglists.html
