U++ forum: Welcome to the forum

Status & Roadmap

Authors & License

Funding Ultimate++

Search on this site

Search in forums

Home » Community » Coffee corner » in code comments - doxygen

Show: Today's Messages :: Show Polls :: Message Navigator
E-mail to friend

Return to the default flat view

Create a new topic

Submit Reply

Re: in code comments - doxygen [message #7951 is a reply to message #6642]

Thu, 01 February 2007 18:27

mr_ped is currently offline

mr_ped
Messages: 825
Registered: November 2005
Location: Czech Republic - Praha

Experienced Contributor

I've been using Doxygen for my own projects, and once you work with it since the very start, it does produce at least average documentation. In case you really pay time and attention, there's no problem to get on good level. (In my eyes most of SW documentations out there are either utter bad, bad or average, so suggesting "good" level is something like admiration)
While Topic++ allows for excellent documentation if enough time and attention is used, I sort of dislike splitting the documentation from the actual code itself.

For high level documentation of course there's no real code, and it starts to be cumbersome to hold this one directly in sources (for Doxygen), and trying out really high abstraction docs was too complex for me. (while I believe that exactly the area where Topic++ can shine)

But when we get back down to commenting the code on low level, I think Doxygen is pretty much ultimate tool.

Report message to a moderator

Send a private message to this user

[Message index]

		in code comments - doxygen By: qwerty on Tue, 21 November 2006 12:24
		Re: in code comments - doxygen By: fallingdutch on Tue, 21 November 2006 18:58
		Re: in code comments - doxygen By: mirek on Tue, 21 November 2006 21:14
		Re: in code comments - doxygen By: Balage on Mon, 18 December 2006 19:23
		Re: in code comments - doxygen By: mirek on Mon, 18 December 2006 19:49
		Re: in code comments - doxygen By: Balage on Mon, 18 December 2006 20:09
		Re: in code comments - doxygen By: mirek on Mon, 18 December 2006 22:26
		Re: in code comments - doxygen By: mr_ped on Thu, 01 February 2007 18:27
		Re: in code comments - doxygen By: mirek on Mon, 05 February 2007 22:57
		Re: in code comments - doxygen By: mr_ped on Tue, 06 February 2007 10:11
		Re: in code comments - doxygen By: mirek on Tue, 06 February 2007 10:27
		Re: in code comments - doxygen By: darrs on Tue, 06 February 2007 20:29
		Re: in code comments - doxygen By: mirek on Tue, 06 February 2007 23:26
		Re: in code comments - doxygen By: fudadmin on Sat, 23 June 2007 03:20
		Re: in code comments - doxygen By: waxblood on Sat, 23 June 2007 07:12
		Re: in code comments - doxygen By: captainc on Mon, 04 August 2008 15:49
		Re: in code comments - doxygen By: mirek on Mon, 04 August 2008 17:05
		Re: in code comments - doxygen By: mr_ped on Tue, 06 February 2007 11:32

Previous Topic:	A Newbie Manual cum Tutorial?
Next Topic:	Ultimate++ Website Logo Text

Goto Forum:

-=] Back to Top [=-

[ Syndicate this forum (XML) ] [

] [

PDF

]

Current Time: Tue May 14 10:15:36 CEST 2024

Total time taken to generate the page: 0.01834 seconds