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