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.