On Tue, Jun 4, 2013 at 1:40 PM, Brad Jorsch bjorsch@wikimedia.org wrote:
On Tue, Jun 4, 2013 at 12:00 PM, Antoine Musso hashar+wmf@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