Index: bp-activity/bp-activity-classes.php
===================================================================
--- bp-activity/bp-activity-classes.php	(revision 7108)
+++ bp-activity/bp-activity-classes.php	(working copy)
@@ -256,7 +256,7 @@
 			$activity_user_ids = wp_list_pluck( $activities, 'user_id' );
 			$activity_user_ids = implode( ',', wp_parse_id_list( $activity_user_ids ) );
 
-			if ( !empty( $activity_user_ids ) ) {				
+			if ( !empty( $activity_user_ids ) ) {
 				if ( $names = $wpdb->get_results( "SELECT user_id, value AS user_fullname FROM {$bp->profile->table_name_data} WHERE field_id = 1 AND user_id IN ({$activity_user_ids})" ) ) {
 					foreach ( (array) $names as $name )
 						$tmp_names[$name->user_id] = $name->user_fullname;
@@ -584,6 +584,16 @@
 		return $comments;
 	}
 
+	/**
+	 * Rebuild nested comment tree under an activity or activity comment.
+	 *
+	 * @global BuddyPress $bp The one true BuddyPress instance
+	 * @global wpdb $wpdb WordPress database object
+	 * @param int parent_id ID of an activty or activity comment
+	 * @param int left node boundary start for activity or activity comment
+	 * @return int Right node boundary of activity or activity comment
+	 * @since BuddyPress (1.1.3)
+	 */
 	function rebuild_activity_comment_tree( $parent_id, $left = 1 ) {
 		global $wpdb, $bp;
 
@@ -608,12 +618,29 @@
 		return $right + 1;
 	}
 
+	/**
+	 * Get child comments of an activity or activity comment
+	 *
+	 * @global BuddyPress $bp The one true BuddyPress instance
+	 * @global wpdb $wpdb WordPress database object
+	 * @param int parent_id ID of an activty or activity comment
+	 * @return object Numerically indexed array of child comments
+	 * @since BuddyPress (1.2)
+	 */
 	function get_child_comments( $parent_id ) {
 		global $bp, $wpdb;
 
 		return $wpdb->get_results( $wpdb->prepare( "SELECT id FROM {$bp->activity->table_name} WHERE type = 'activity_comment' AND secondary_item_id = %d", $parent_id ) );
 	}
 
+	/**
+	 * Get a unique list of components that have related activity recorded to them
+	 *
+	 * @global BuddyPress $bp The one true BuddyPress instance
+	 * @global wpdb $wpdb WordPress database object
+	 * @return array The components
+	 * @since BuddyPress (1.2)
+	 */
 	function get_recorded_components() {
 		global $wpdb, $bp;
 
