[Sdldoc-devel] Updating for 1.2.5; future development

[Max H. <ma...@qu...>]

Yo there (whoever is out there),

I just noticed akawaka/Martin Donlon actually added me to the sdldoc 
project at SF.net recently :-) Not sure if this list is used at all, or 
if anybody is on it (akawaka? are you here? :-).  But anyway, it would 
be nice to get things rolling...

in particular, the following things are amongst those I'd like to see 
happening with sdldoc (and I am willing to work on them, too):

* getting the many many user comments merged into the docs where 
appropriate
* fixing any other problems we find in the content or which are being 
reported
* updating the descriptions to SDL 1.2.5 where/if needed
* streamline some other things, e.g. the "Events" section of the SDL 
reference is different from all the others in index in that it doesn't 
list all its API there (it's one level deeper in the hierarchy). This 
should be unified one way or the other, IMHO.

To this end, I'd like to know if the version of the sdldoc' stuff in 
the SF.net CVS is up-to-date, or not? If not, could it be made?

The other thing Martin and me would like to tackle is to maybe switch 
to a new format for the docs. Maybe it would be a good time to list 
what that new format would need to fulfill to be suitable? Martin, I 
believe you had such a list, or even already a plan on what you wanted 
to use (TeX?).

Anyway, while a new format maybe is a good thing on the long run, I 
believe that first fixing up the existing sdldoc may be a good first 
step. To this end it would be nice to have the latest version in CVS so 
that multiple persons can get working on it. BTW is there a particular 
reason not to use the webspace SF.net provides us? Using it would have 
the convenience bonus, that any project members can make fixes on the 
site, they don't have to be funneled thru Martin. But of course maybe 
there are good reasons which make using the SF.net webspace a bad idea, 
I'll wait for Martin to comment on this :-)



Cheers,

Max