Docs generator

strale · Post by **strale** » Tue Sep 26, 2006 8:45 am

Hi

sorry if this topic has been already discussed i did not find on a search.

i was wondering about what kind of doc generator are used by developpers

.

i experienced doxygen and i found great but sometimes it seems that it does not write all my coomments that i spoil all around my functions, (may bee my fault).

Thanks

vitek · Post by **vitek** » Tue Sep 26, 2006 4:38 pm

It is very likely your fault. You need to format your comments so that doxygen can process them. Once you get used to doing it, it is pretty easy.

3ddev · Post by **3ddev** » Wed Sep 27, 2006 6:40 am

Continue with doxygen! It is by far the best *free* doc compiler on the web. I tried many others before I used it. The learning curve is a bit steep, granted, but well worthwhile for the stunning output files!

strale · Post by **strale** » Wed Sep 27, 2006 7:23 am

Thak you for the replay

also speking with some friends told me this is actually the best.

bye

EmmanuelD · Post by **EmmanuelD** » Wed Sep 27, 2006 10:18 am

Personnally, I find that NaturalDocs is also quite good. It lets you write comments that are not cluttered with strange symbols. Unfortunately, the C++ support is not completed yet, so you may find it less powerfull than doxygen.

strale · Post by **strale** » Thu Sep 28, 2006 7:37 am

Hi EmmanuelD

Thank you for the link , yesterdy i read a little the documentation
it seem appealing

if i do not mistake it could be used to document source not tagged
it could be very useful.
and the ouput generate is pleasant

it seem to have not a GUI/Wizzard

but this is not a very problem
and also the loss of commands culd give some trouble as it use a style to format docs, so we must learn format style instead of commands.

thank