There are currently 157 (more than double) hooks in the 0.9.x branch,
there should probably be a way to document these inside the code
itself.

something like a new doxygen module and grouping of hook documentation
should help

for example
a "\defgroup hook Event hooks" can be defined in index.php / common.php
and then wherever there is an event you should be able to document it as:

/*
 * @{hook
 * Initialize plugin in the full environment
 */
Event::handle('InitializePlugin', array());
..some more code if related...
/*
 * ...some more documentation...
 * @}
 */

see http://www.stack.nl/~dimitri/doxygen/grouping.html for more on this.
_______________________________________________
StatusNet-dev mailing list
[email protected]
http://lists.status.net/mailman/listinfo/statusnet-dev

Reply via email to