DOC the code

Hi
Finally the exam is out!
SAOL has been a good choice.
thanks to J.Lazzaro for it's great tools SFRONT and great book "The MPEG-4 Structured Audio Book"

Now is the turn of Emyl and Pasq. good luck guis.



Apart this, today I have tried a tool to automatically generate documentation for my source code: "doxygen"
Yes, java users uses javadoc but doxygen have many usefull features that javadoc have not.
It's too long to explain here (this is a blog!) but synthetically doxygen can :

• generate source documentation in a fashion way for a variety of languages (C, C++, Java, C#, PHP and some others) with the result that, if you write in different languages, you can maintain an homogeneous style for your docs.
  
• generate documentation in many languages (still italian!)
  
• The output may be in many differt formats, from HTML to rtf to PDF...interesting thing no?
  

the only snag that I have found is the needed of discrete amount of hardware resources' to produce complex documentation for large project (up to 1000 files I mean)
But I'm distrust that others tools can do it better.

As usually, if you know a bettr solution, let me know ;-)

good weekend to everybody!