Has anyone used such systems as doxygen or doc++ for documentation generators, it seems such systems are based heavily on the javadoc syntax. I've looked at a coupe of examples, and though the html output is good looking, it would seem large projects would quickly become an eyesore for the developer(s), Are they all javadoc based or perhaps someone could recomend one that uses some other commenting standard?

What i mean by eyesore, is particulary when you comment methods and member data, I much rather move these comments into the cpp file, as a header above each method definition. So as not to clutter the class declaration.

All I can find is these javadoc based generators. Any ideas? or should I learn to live with it.