Moin,
On Wednesday 19 April 2006 20:58, Brion Vibber wrote:
Ashar Voultoiz wrote:
Brion Vibber wrote:
FYI, I tried running phpdoc over the current code
and found it
breaking the memory limit of 256 megabytes I have set on my server.
We might want to consider a new documentation parser that can handle
our code. :)
Hello,
r13740 migrated trunk from phpdoc to doxygen, I even updated the
mwdocgen.php.
Neat! Now being autogenerated daily at
http://svn.wikimedia.org/doc/
Cool. Although the documention is still largely, well, not usefull:
Example:
Parser::$mTitle
Reimplemented in ParserXML.
Definition at line 108 of file Parser.php.
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?
(Sorry for sounding so picky! :-)
best wishes,
Tels
--
Signed on Wed Apr 19 21:22:12 2006 with key 0x93B84C15.
Visit my photo gallery at
http://bloodgate.com/photos/
PGP key on
http://bloodgate.com/tels.asc or per email.
"helft den armen vögeln" -- gegen kleinschreibung