Although the automatic documentation generation issue isn't resolved yet (Ticket #22), I decided to make some experiments by manually replacing the XML's special characters for their correspondent entities.
I quickly found out that documentation generation did not consider third party library directories. :-|
My sugestion was that, by default, a separate XML documentation file was generated for each of the libraries ('lib', 'lib3rdParty1', 'lib3rdParty2', etc). Nevertheless, the ideal was that it could be configured somewhere (changing between a single/multiple documentation files). :-)
Funcional automatic documentation generation would be a great feature to have correctly supported, as the power of XML schemas (XSD) could easily (?) turn the currently generated format into a nice looking document. This is also valid for jsolait's documentation, for which an automatic 'wikifier' could be build afterwards. ;-)
Hope to see the feature available soon so that documentation experiments can be made! :-)
Best regards,
Helder
