[quote author=Udo Klein link=topic=87038.msg652598#msg652598 date=1326529293]
Doxygen is great. I often use it for reverse engineering. However for such small stuff like the Arduino libraries I prefer to see the actual code. For me this is easier to read and understand than long wound library documentation.
Documentation often comes with a price. The same is true for doxygen. The biggest issue is that it clutters your source code. The other issue is generic: documentation creates additional overhead / double maintenance.
IMHO I would like to see integrated version control (e.g. git) before there is more documentation support. Right now most Arduino stuff is small enough to go with C comments.
My recent phi_interfaces library is 1,000 lines of code with a moderate complex class hierarchy. It's all working after testing. Without a decent doc, I am procrastinating its release. I have to use Doxygen. You will be confused just reading the codes.
I type comments while coding anyway so it's not much overhead especially if you want others to use the code. I don't see why double maintenance is needed though. Do you mean modifying the doc after it's automatically generated?