[Bf-committers] Doxygen project

Casey Corn bf-committers@blender.org
Mon, 9 Jun 2003 10:14:12 -0700 (PDT)


Hi all,
--- Ton Roosendaal <ton@blender.org> wrote:
> Hi,
> 
> (changed the subject to attract more attention!)
> 
> Everyone, please give feedback on doxy strategies...
> it's nice to say "go ahead" but it really involves
> some more thinking... it especially should give a
> result that's actually *used* by people. Since I'm
> not the typical representative for a coder here, I
> need you to help casey with doing the right stuff.

Yes please!  I'm in the dark, especially when it comes
to "the right stuff" ;) .  What do you all need to
see?
 
> Right now, my opinion is simple:
> 
> - doxify the classes/headers and external API only
> - no doxy comments inside the code, but restrict to
> .h files
> - only document what would give additional added
> value.
> - Code readability and layout should never be
> sacrified
> 
> -Ton-

I have no problem with this, or with what Nathan
wrote, except for one thing: source/blender/src . 
This is where I personally have the most difficult
time understanding the code (am I the only one?). 
This also appears to be the core of blender, with
mesh/curve manipulations, gui stuff, texturing, etc. 
The other source/blender directories appear to be
fairly well seperated into modules.  Also, only one of
the 80 or so files is a .h file.

While I don't plan on documenting src soon (nor do I
know of anyone else who is going to ;) ), I don't
think it's too early to talk about it.

Thanks for the feedback,
Casey


__________________________________
Do you Yahoo!?
Yahoo! Calendar - Free online calendar with sync to Outlook(TM).
http://calendar.yahoo.com