Commenting is always a matter of personal style mixed with a need for document the code, preferrably so that someone (or even yourself) can come back to the code 6 months or a year or longer afterwards and be able to make sense of it without too much difficulty. Good documentation is never a bad thing-just be aware that comments too far from the code it applies to can be bad, although this looks quite useful for documenting the function overall.

Others, I noted, suggested converting the documentation to POD format, which would also be a good idea.

(Personally, I prefer too much information if I'm having to come behind and dig thru it than too little, but that is just me.)