Index: services/menu_service/menu_service.inc
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/services/services/menu_service/Attic/menu_service.inc,v
retrieving revision 1.1.2.4.2.1
diff -u -p -r1.1.2.4.2.1 menu_service.inc
--- services/menu_service/menu_service.inc	23 Jan 2010 15:35:34 -0000	1.1.2.4.2.1
+++ services/menu_service/menu_service.inc	21 Feb 2010 03:12:24 -0000
@@ -10,8 +10,14 @@
 /**
  * Get the menu from the database.
  *
+ * @param $menu_id
+ *   The named menu links to return. Defaults to 'primary-links'.
+ * @param $fields
+ *   An array of fields to be returned, for use in limiting the
+ *   size of data returned to only that which is necessary.
+ *
  * @return
- *   Array. A list of all children menu items from a given menu item.
+ *   An array of all child menu items from a given menu item.
  */
 function menu_service_get($menu_id = NULL, $fields = array()) {
   if ($menu_id === NULL || trim($menu_id) === '') {
@@ -25,10 +31,14 @@ function menu_service_get($menu_id = NUL
 }
 
 /**
- * Recursively returns menu items
+ * Recursively returns menu items, optionally limited by an array of fields.
+ *
+ * @param $data
+ *   The menu item whose children should be returned
+ * @param $fields
+ *   An array of fields to be returned, for use in limiting the
+ *   size of data returned to only that which is necessary.
  *
- * @param data
- *   Array. The current menu item.
  * @return
  *   Array. All children menu items from a given menu item.
  */