Introduce `bp_core_mark_notifications_from_user()` for completeness, though it's currently unused. Also fix some phpdoc. See #5148.

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