Automatic documentation (humour)

[Indiepath]

Anyone using this :rolleyes:
http://www.cenqua.com/commentator/

[Sharpfish]

Haha! It was funnier than I thought it would be, though I am guilty of a couple of things.. mostly the "put 'TODO' in empty blocks" (though in fairness they are usually constructors/destructors).


This part:

/************************************************** *****
* okay, finally we are ready to take the important step of
* summing the integer elements of a. I've researched the
* most efficient algorithm and settled on this one,
* presented by Knuth. I don't quite agree with his
* reasoning but the algorithm is sound (did I tell you
* about the cheque I got from Knuth? no? It was back
* in my uni days when I was writing my thesis (youngest
* ever accepted into the program) in TeX on the PDP-10.
* I just couldn't get it to format my differential
* equations properly, and a quick look under the hood...
/************************************************** *****

Has 'Lamothe' written all over it, anyone who has read any of his books will spot the dig at him. Though I guess it can apply to a lot of more experienced coders (especially ones who also write books).

nice post - Where can I download the utility? ;)