Besides some unnecessary personal comments I think that some good ideas came out of the "DRM/DRI porting guide?" thread.
I found especially interesting the idea of the mailing list archive digging from Daryll Strauss and the idea of Ian Romanick to use an automatic documentation system from source. I don't dislike the IRC # idea but it won't generate value into the future as a good documentation would. Before the second idea is put in to practice one has to agree in which source documentation system to use or even use a in-house developed system that better suits the DRI architecture. I personally have had a very good experience with Doxygen (http://www.doxygen.org). Of course that this consensus must be especially among the main developers (those who have the CVS submit access) since this will require to a lot of changes in the tree. Regardless the consensus is reached or not, I plan to develop a script that either converts the existing comments in sources to a standard format or extracts them for a "poor-man" source document. The first idea can be put in practice right now. It's an excellent opportunity for me to learn about DRI and make a contribution at the same time. With that in mind I've developed a quick python script to dump all the dri-devel into a standard unix mbox format and I'm now reading it in my mail reader application. I invite everybody in the same position as I to do the same. (We can then focus special features, merge notes, etc...) You can find the mailbox and the script at http://mefriss1.swan.ac.uk/~jfonseca/dri/ . (There have been some network problems here at the university so the server can be temporarily unavailable sometimes...) By the way, another good tip is to load the whole XFree86 tree in Source Navigator (http://sources.redhat.com/sourcenav/). It allows you to easily browse through the source and quickly find the definition/implementation of any function. Regards, Jose Fonseca _______________________________________________ Dri-devel mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/dri-devel
