On Tue, Jun 4, 2013 at 1:40 PM, Brad Jorsch <bjorsch(a)wikimedia.org> wrote:
On Tue, Jun 4, 2013 at 12:00 PM, Antoine Musso
<hashar+wmf(a)free.fr> wrote:
Since we introduced hooks in MediaWiki, the documentation has been
maintained in a flat file /docs/hooks.txt . Over the week-end I have
converted the content of that file to let Doxygen recognize it.
The patchset is:
https://gerrit.wikimedia.org/r/#/c/66128/
The result is pretty. But personally I'll probably continue to just
look in hooks.txt if I need the info in there, and the markup in the
(now-misnamed) file is rather ugly. Not that the existing file isn't
also ugly, just less so.
I'm with Brad. Considering we document this in the tree and on
mw.org, I'm not entirely sure what the benefit of having it done
via Doxygen is.
-Chad