[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

doxygen for cfengine

From: Eric Sorenson
Subject: doxygen for cfengine
Date: Wed, 26 Jan 2005 15:58:29 -0800 (PST)

I got a round tuit last night and ran the cfengine sources through
doxygen. It took about 5 minutes to complete (on my 2.5G Athlon!)
and ended up looking like this:


I wanted to find all the places that referenced CanonifyName to
see how much trouble it would be to make it reentrant, and it
turns out it wouldn't be so bad.


All of the function names in the graphviz call graphs are imagemaps
that will take you to the definition if you click 'em.  Don't know
if this is helpful to anybody, but I thought it was neat.

Going forward, doxygen might be a good way to do internals documentation
with a minimum of fuss. An extra * on the opening wing of a comment
is all it takes to start including docs in the generated files, a'la


But at the very least, with no additional work, it's a good way
to get a handle on the flow of execution.


 - Eric Sorenson - Explosive Networking - http://eric.explosive.net -

reply via email to

[Prev in Thread] Current Thread [Next in Thread]