On Aug 30, 2013, at 2:14 PM, Mandeep Simak wrote:

> On Fri, Aug 30, 2013 at 8:59 AM, Christopher Sean Morrison
> <[email protected]> wrote:
>> You could certainly patch our actual Doxyfiles in misc/ or provide entirely 
>> new ones.
> 
> I checked Doxyfile in misc/ folder. Only few folders from src/ are
> included as INPUT and doxygen_structure file which is used to organize
> modules. So, I have updated my Doxyfile according to this.
> 
> Here is new doc: http://202.164.53.122/~mandeepadmin/brlcad/doc/html/

Nice, that's looking like an improvement.  Still a ways to go, I see, as most 
of those modules should belong to some library or other high-level group.

> There are files that contain comments that do not confirm doxygen
> style. Do I need to modify those?

Yeah, I would think so.  I suggest starting incrementally, though, like with 
just one file or directory so we can see what those changes are going to look 
like before working on other files.  If you work from an SVN source repository 
checkout (svn co http://svn.code.sf.net/p/brlcad/code/brlcad/trunk brlcad), a 
patch file can be easily generated by running "svn diff" and directing that 
output to a file (after first visually inspecting the changes, e.g., svn diff | 
less followed by svn diff > mydiff.patch).

Cheers!
Sean


------------------------------------------------------------------------------
Learn the latest--Visual Studio 2012, SharePoint 2013, SQL 2012, more!
Discover the easy way to master current and previous Microsoft technologies
and advance your career. Get an incredible 1,500+ hours of step-by-step
tutorial videos with LearnDevNow. Subscribe today and save!
http://pubads.g.doubleclick.net/gampad/clk?id=58040911&iu=/4140/ostg.clktrk
_______________________________________________
BRL-CAD Developer mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/brlcad-devel

Reply via email to