I would like to use doxygen to improve my style and my documentation.

I´ve found some old threads for it but I don´t really know were to start.
It would be nice if you could share your experiences with doxygen, the pros and cons as well as some tipps about the integration with Lite-c.

Thank you very much & stay pixelated

hi buddy,i am not sure but once i wanted to learn it,and i found very good tutorial about it,just give some time i will find it for you.

No one uses Doxygen here? I can´t believe it somehow.
I´ll try to get the hang of it, if I´m successful I´ll share my experiences.

I use Doxygen, but not for Lite-C, so I can't help you with this (but I think it should work like a normal C application).

Well, the pros are that it's really nice and has alot of features, the cons are the UI. I can only talk about the Mac UI, but, it's a pain. Really.

What do you need to know?

I'm using Doxygen with Lite-C and it's working just fine:

http://firoball.de/stuff/toolbox_manual/


You need to know what you want to have int he manual. And then run the Doxygen wizard to setup everything right.
In my case I disabled the inclusion of source listings in the help files.
And I installed the Microsoft HTML Help workshop to build up a .chm file right away with a single click.


Sample of a doxied code file: http://pastebin.com/c3fK7VZ4

My "Doxyfile": http://pastebin.com/nTYiXBxH

My batchfile to generate the documentation: http://pastebin.com/re9qs19W

Will need path adjustment.
I'm placing the documentation in a subfolder of the project.

So I have the following line in the doxy config for finding the project files:
INPUT = ..

and output is placed into the same folder as the Doxygen config. I have only tried to do HTML help, so I've set the HTML output folder like this (the folder is named "html"):
HTML_OUTPUT = html

The batch script shown above starts Doxygen, then starts the HTML Help workshop and finally copies the final .chm file out of the "html" folder.

Really nice!
I´ll examine it in the evening, because I´ve got some work to do.
Thank you very much!