Moin,
On Wednesday 19 April 2006 21:34, Rob Church wrote:
On 19/04/06, Tels nospam-abuse@bloodgate.com wrote:
It doesn't say what it is for, or what values it could have, or whatever. Almost every member or class definition I looked at looks like this, circulare references between files but nowhere any real doc beyond "it exist and is called foo".
Since at least for members there are usually comments (like for mTitle), should't the autogenerated doc pick them up and display them somehow?
As Avar said in a previous message; the documentation is limited in terms of the original code; if the comments to document it were not there, then the generated documentation will be sparse.
I _know_. :)
What I wanted to say is that the *comments* are there, but not in the proper format:
$sFoo = ''; // This variable stores a string
The comment there is ignored by the doc generator. So presumable the comments need to be reformated, or whatever (I am not familiar on how doxygen works exactly). Of course, it would be quite some work. But maybe it could be semi-automated.
Best wishes,
Tels