>Look, guys, I *know* why it doesn't work, but don't you think, logically, it
>*should* work as expected???
Oh, you wanted a value judgement! I see. Sure, it should always do what
you expected, whatever it was that you expected. That's the undocumented
DmDoWhatIWant() routine, but don't tell anyone about it.
>Based on David's answer, I suppose that means "don't use DmDeleteCategory(),
>it's broken. Just do what it's supposed to do, only don't implement our bug"
We're getting pedantic. That routine was written to remove the records
from a category (note the singular usage). "All" isn't a category. It
would be nice if it had a special case for dmAllCategories but it doesn't.
It isn't broken; you're wanting it to do something that it wasn't written
to do. You could just as well want to remove things from two categories at
once, which it doesn't support either.
But who cares? So it doesn't do what you expected, fine, write a loop or
call DmDeleteDatabase.
>Follow-up question... David said that DmDeleteCategory() uses
>DmRemoveRecord()... should it not use DmDeleteRecord() instead??? I would
>think you'd call it DmRemoveCategory().
To continue to be pedantic, I didn't say that DmDeleteCategory uses
DmRemoveRecord; I said that DmDeleteDatabase does. DmDeleteCategory uses
neither DmDeleteRecord nor DmRemoveRecord, but instead (at least currently)
goes a layer below those APIs and does the remove-without-a-trace
functionality itself.
>In any case, the docs are mute on what the call
>actually does (Delete, Remove, Save a copy...) Maybe they
>could be clarified for PalmOS 5.0?
Now there's a practical suggestion :-) Sure, I'll send a note to the doc
writers. And if we're nice to them, it might well happen before 5.0.
They're typing as fast as they can, but there's quite a lot to document all
at once, and they've also got the challenge of fixing all the past
omissions too.
-David Fedor
Palm Developer Support
--
For information on using the Palm Developer Forums, or to unsubscribe, please see
http://www.palm.com/devzone/mailinglists.html
