A rave post about Doxygen and the OpenCOBOL source tree, along side an OpenCOBOL application for beautifully complete technical documentation. …
Well met,
I just raved posted this to the http://opencobol.org forum. Life is fun.
Holy umm, something Batman
I was horsing around, ran another Doxygen pass over cobc Feb2009. Holy umm, moly. Dimitri has a wicked smart generator now.
Take a look at http://opencobol.add1tocobol.com/doxy/
This took no effort. A few Doxyfile config settings and a mainpage.h. The freekin' latex dir produces a 15 meg, 1400 page beauty of a reference manual too. Sweet. Click here to see: http://opencobol.add1tocobol.com/doxy/ocrefman.pdf (but really don't, it's 15 meg of fairly dry technical totally cool material).
I'm surprised and completely blown away by the quality. Anyone wanting to grok over the OpenCOBOL compiler, start here: http://opencobol.add1tocobol.com/doxy/
Thanks to Dimitri van Heesch, Roger and Keisuke.
Cheers,
Brian
Wheeeeeeeee!
Edit:
Second round, I included the C code generated from Gary's OCic.cbl, in a –save-temps subdir in the compiler tree and reran Doxygen. It creates call graphs that exercise the runtime and shows how an OpenCOBOL program interacts with OpenCOBOL, right down to the compiler's internals. I'm not sure I'm going to post it though. These are super easy to create at home. The html tree for the second run is 253 meg. 🙂 The PDF is 81meg, 2950 beautiful pages. It changes the P.O.V. from compiler study to application programmer aid. And, umm, for now I'd rather promote compiler study with these pages. 😉
Wheeeeeeeee!
Edit:
Ok, fine, it's too cool. Have to show it off. http://opencobol.add1tocobol.com/doxyapp/ Application coders, have some fun.
Edit:
Oh yeah, let it be known. This is NOT a complete picture of the OpenCOBOL build environment. Roger has gone to great lengths to libtoolize the source trees, it's missing many of those supporting files. There isn't a proper copyright notice on mainpage yet. Etc. First cut total fan boy posting. Too easy. Deserving of a few 9 e wheees.
Cheers,
Brianhr
