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


_______________________________________________
Wikitech-l mailing list
[email protected]
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

Reply via email to