I'd like to see an API-Documentation for upcoming versions of the SDK.
The header files are basically documented, but they lack details to a certain degree that often makes development a bit hard for module/plugin coders.
The most practical reason for that: SendMessage to DD.
It isnt always exactly clear how to use certain Messages.
My most recent struggle: DDMODAPI_CHL_GET_POINTER.
Rather than reading the file directly, I wanted to use built-in stuff to let DD take care of that. Simply using it with SendMessage, passing a PCHL as lParam didnt work.
The question: Do I have to call DDMODAPI_CHL_LOAD first? Does it return a Handle/Pointer/whatever that has to be passed to CHL_GET_POINTER, which then returns a PCHL address as return value of SendMessage?
Stuff like that should be documented in some way, as it isnt always the most convinient way to "simply" ask some other coder that already found out how to do this and that *blinks over to ScanMan*.
I'd at least like to see some more verbose comments in the header files, like mentioned above telling us to call some other func first, or what types to pass/get back as return.
I do not expect some fully blown CHM Helpfile, but at least something that makes live easier for those who love DD, and want to enhance it