> From: David Bronaugh <[EMAIL PROTECTED]> > Date: 2002-01-17 23:11:46 > > > >Perhaps a good idea here would be to have some sort of a function > >documentation tracking project.. I have been doing a hell of a lot of > PHP > > See above text why function documentation is not necessarily the best > approach. To briefly re-iterate: knowing what a function does still > doesn't tell you which functions or in what order, the DRI infrastructure > > requires for a complete driver write. There's no program flow > information. > The API is still undefined. > > >comments/information on specific functions, then there could be a list > of > >links to those functions on another page, so that people could easily > >find what others have contributed about that function). As well, I guess > >there could be some sort of general overview section (I'm not clear at > >this time how that'd work). > > What I think would be a great idea and maybe your experience can help in > is the following: > > First we define the conceptual components of the DRI project: > DRM > DRI 2D > DRI 3D > Mesa > GLX
I like your idea here of splitting these up, and having some kind of a linkage structure. Yes, I can code this (it's not so easy as otherwise, but still within the realm of time possibility). I'm not exactly sure what people here want to end up with though, so before I do anything I want much, much more comment on this. I want as much input as people are willing to give me about how people want to make this work. It's pretty easy to do some really sleazy code to rip all the comments out and try to associate them with functions for some really preliminary docs.. then my idea was users who were in on the weekly IRC sessions could comment and perhaps fill in a lot of details, and every so often someone (someone who's trusted and reasonably competent) could assimilate the comments of the users into the core documentation, and we'd go through another cycle. Somewhat similar to php.net, but much more person-administered. By the way, if you want to see what are (in my opinion) excellent docs and an excellent system, php.net is it. David Bronaugh _______________________________________________ Dri-devel mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/dri-devel
