Better phpDoc and inline comments for bp_register_theme_package().

Props ericlewis.  Fixes #5088.

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