Add hook documentation in bp-activity-functions.php.

Props tw2113.
See #5938.

git-svn-id: https://buddypress.svn.wordpress.org/trunk@9135 cdf35c40-ae34-48e0-9cc9-0c9da1808c22