diff --git a/includes/menu.inc b/includes/menu.inc
index fa5a71e..edde9e7 100644
--- a/includes/menu.inc
+++ b/includes/menu.inc
@@ -3048,8 +3048,9 @@ function _menu_delete_item($item, $force = FALSE) {
  *
  * @param $item
  *   An associative array representing a menu link item, with elements:
- *   - link_path: (required) The path of the menu item, which should be
- *     normalized first by calling drupal_get_normal_path() on it.
+ *   - link_path: (required) The real (not aliased) path of the menu item, 
+ *     which should be normalized first by calling drupal_get_normal_path() 
+ *     on it.
  *   - link_title: (required) Title to appear in menu for the link.
  *   - menu_name: (optional) The machine name of the menu for the link.
  *     Defaults to 'navigation'.
@@ -3061,6 +3062,11 @@ function _menu_delete_item($item, $force = FALSE) {
  *     to insert a new link.
  *   - plid: (optional) The mlid of the parent.
  *   - router_path: (optional) The path of the relevant router item.
+ *   - language: (optional) The language code (e.g. 'en'). If you want to make
+ *     the item translatable, then it is required to set the language code and
+ *     you must set customized to TRUE.
+ *   - customized: (optional) Boolean that must be TRUE in order to not display 
+ *     the link in any language. 
  * @param $existing_item
  *   Optional, the current record from the {menu_links} table as an array.
  * @param $parent_candidates