I am new to doxygen and I have never used it before until yesterday I saw some promising posts on the Web saying how good and how easy DoxyGen is. Then I downloaded the command line version and tried to run it on some of my personal projects. Unfortunately, the result is a bit disappointed.
I had no documentation generated for my classes. I thought I may have mis-configured to cause this. Then I ended up installing the GUI version. The same thing happens. The project is very small and it only consists a few user controls and window forms. No documents are generated for my classes except for "Properties::Resources" that I used for storing images and key-value pairs - still, the content is completely empty for "Properties::Resources". And I don't understand why DoxyGen generates this class for me? It is not my class - it generates by .NET automatically. I have no idea what it is going on. I don't found that there is someone who has reported this problem.
Then I tried to run DoxyGen on my class library project which have more classes. Yes, I have some documents generated but only the classes don't inherit from .NET framework. It looks like all my components inheriting from TreeNode, TreeView, and etc., won't be scanned or detected. Thus, there is no documentation for them. What documentation I have for my classes are those standalone. Is it the limitation of DoxyGen? Or does DoxyGen not understand the XML documentation rules set by MS? Or is there any tag I need to enable or set in order to make it work? I can see that DoxyGen scans all my individual source file but it somehow ignores all the classes inheriting from .NET framework.
Java provides JavaDoc when it was first launched; I have never had documentation problem with it. For .NET, it has been at least 6-7 years now since it is available; MS is still unable to provide any workable documenter for it. It is really disappointed.
Anyway, is there someone giving me some insight on how to use DoxyGen on C#?
McLai
