Not exactly wrong, but let's face it, it's quite boring to read. In my opinion, there should be examples in the documentation. It's easier to understand how a funcion works, what she does and how to use it. Ok, you have examples in the site, but you have to stop reading the documentation, open a browser, search for the examples... not very productive.
This is something we're working on. One of the big objectives for the PalmSource developer services group is to improve the cross-referencing of sample code on our website. We're trying to get to a system like MSDN where the documentation for API calls points to code that shows how they are used. This hasn't been the Palm OS documentation philosophy in the past, but we're trying to change and make things better.
-- Ben Combee, Technical Lead, Developer Services, PalmSource, Inc. "Combee on Palm OS" weblog: http://palmos.combee.net/ Developer Fourm Archives: http://news.palmos.com/read/all_forums/
-- For information on using the Palm Developer Forums, or to unsubscribe, please see http://www.palmos.com/dev/support/forums/
