in reply to Am I over-commenting my code?

Turn your comments into POD style, and you can generate a man page from it....