Updating comments

main/inc/lib/main_api.lib.php

@@ -992,6 +992,7 @@ function api_get_user_courses($userid, $fetch_session = true) {
 
 /**
  * Formats user information into a standard array
+ * This function should be only used inside api_get_user_info()
  *
  * @param array Non-standard user array
  * @return array Standard user array

main/inc/lib/usermanager.lib.php

@@ -880,6 +880,7 @@ class UserManager {
 	 * @param	string	The id
 	 * @param	boolean	Whether to return the user's extra fields (defaults to false)
 	 * @return	array 	All user information as an associative array
+     * @todo    Use api_get_user_info() instead
 	 */
 	public static function get_user_info_by_id($user_id, $user_fields = false) {
 		$user_id = intval($user_id);