Re: [Sdldoc-devel] Re: Updating for 1.2.5; future development

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

[...]

>
>> 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
> A dump of all the user comments is in cvs somewhere.
>
Ah found it, "devdocs/2003-05_SDLNotes" in the "sdldoc" CVS module.

>> * 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.
> yup, yup, yup.
>
>> 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?
> Whats in cvs of sf is currently the most up to date version.
>
Cool. That means I can get working on it :-)

>> 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?).
> Yeah, I did mention this on IRC, but the amount of work involved is
> probably huge and I'm not sure what the benefits will be.
>

I suggest we first work with the old format to get the things mentioned 
above done. We can then decide if we want to switch to something else, 
or not.


[...]

> The only reason I run the site on my own site is because I don't know 
> if
> sf provides a db that I need for the user comments system, I'd be happy
> to move over to sf if they do.
>
They have MySQL, works well for e.g. Fink.


Cheers,

Max