OS/2, eCS & ArcaOS - Technical > Programming
Doxygen and XWorkplace
(1/1)
Martin Iturbide:
"Doxygen is the de facto standard tool for generating documentation from annotated C++ sources, but it also supports other popular programming languages such as C, Objective-C, C#, PHP, Java, Python, IDL (Corba, Microsoft, and UNO/OpenOffice flavors), Fortran, VHDL, Tcl, and to some extent D."
http://www.stack.nl/~dimitri/doxygen/
It is open source, there not an updated version for OS/2, and the GUI tool for OS/2 seems to only run on X11.
So I tried on Windows first and made a quick and dirty report from the XWorkplace code.
I really liked what the tool generated.
Mentore:
ISTR Doxygen is used to document a number of big projects, like OpenSG (I'm using it at work).
Still, it is a (albeit good) starting point: I feel that a real documentation needs to explain not only the class structures but many other things.
For one, the same OpenSG I'm using is thoroughly described by the Doxygen pages over the web, but still is poorly documented and fairly difficult to use.
Dave Yeo:
Helps to have good doxygen compatible comments.
Navigation
[0] Message Index
Go to full version