Le 04/06/13 19:40, Brad Jorsch a écrit :
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.
An interesting Doxygen feature is the ability to generate man pages. One
could add in its MANPATH $IP/docs/man and then do something like man 3
page_hooks_list . That shows up a nicely formatted list of hooks.
You can give it a try with:
git-review -d 66128
php maintenance/mwdocgen.php --generate-man --file=docs/hooks.txt
man man docs/man/man3/page_hooks_list.3
Should probably make the section named mw-hooks-list or something :)
Example:
Language*
Language::getMessagesFileName
Parameters:
$code The language code or the language we are looking for a
messages file for
&$file The messages file path, you can override this to
change the location.
--
Antoine "hashar" Musso