Moin,
On Wednesday 19 April 2006 21:34, Rob Church wrote:
On 19/04/06, Tels <nospam-abuse(a)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
--
Signed on Wed Apr 19 22:36:41 2006 with key 0x93B84C15.
Visit my photo gallery at
http://bloodgate.com/photos/
PGP key on
http://bloodgate.com/tels.asc or per email.
"I can imagine what you're thinking though: this girl keeps her brains
in her backside! But actually only the more primitive parts of my brain
are in my butt. The more interesting parts are kept in a PC - my spinal
cord is actually an RS232 lead!" - Lucy, the OrangUtan Robot Girl
http://tinyurl.com/3fv6z