Transaction

j"1LAnZuoQdcKCkpDBKQMCgziGMoPC4VQUckM% <div class="post">Hello to the other developers, I finally got a working build environment set up on my Ubuntu machine here and have been perusing the sourcecode a bit. &nbsp;So far I like what I am seeing, the program makes use of the standard template library to avoid messy data structure code and the class structure seems to make pretty good use of public/private access to promote modularity.<br/><br/>The thing that really seems to be lacking though is a good organizational structure between the .h and .cpp files, as well as a lack of function documentation. &nbsp;I would be happy to start writing documentation for the functions using the <a href="http://www.doxygen.org">doxygen</a> documentation system. &nbsp;I am using this on <a href="http://sourceforge.net/projects/opendungeons/">OpenDungeons</a> which is a game I am the lead coder on and it has served me well.<br/><br/>For those that are unfamiliar with it, Doxygen works by reading your sourcefiles to extract information which it automatically collects (like function parameters, class organization and inheritance, etc), as well as information you add yourself (comments describing what functions do, what variables are used for, etc). &nbsp;After it parses all of the code it produces &nbsp;a directory containing a bunch of HTML files which are very well crosslinked and easy to navigate. &nbsp;It can also be configured to autogenerate neat little call graphs showing what subfunctions are called from each function (so you can trace dependancies/bugs).<br/><br/>All in all Doxygen is an excellent system and I would be happy to get it set up and begin writing documentation for the functions (at least the ones I can figure out anyway) and provide patches so they can be uploaded to SVN. &nbsp;I don't want to do this though if other developers would be opposed to it so I wanted to post here before I got started. &nbsp;Let me know if you would like me to do this.<br/><br/>EDIT:&nbsp; In case people want to see what the documentation on an existing system looks like, here is a <a href="http://www.ogre3d.org/docs/api/html/">link</a> to the documentation for the OGRE 3d rendering system.&nbsp; The best place to get a feel for the documentation is to click the "Classes" link at the top and then look at the pages for a couple of classes.<br/><br/>-Buck</div> text/html