Issue #2140157 by rbp, jhodgdon, joachim: menu return constants not properly explained - MENU_NOT_FOUND, MENU_ACCESS_DENIED

1 files changed, 10 insertions, 2 deletions

diff --git a/includes/menu.inc b/includes/menu.inc
index 140e67e71..1fe5a6470 100644
--- a/includes/menu.inc
+++ b/includes/menu.inc
@@ -229,12 +229,20 @@ define('MENU_CONTEXT_INLINE', 0x0002);
 define('MENU_FOUND', 1);
 
 /**
- * Internal menu status code -- Menu item was not found.
+ * Menu status code -- Not found.
+ *
+ * This can be used as the return value from a page callback, although it is
+ * preferable to use a load function to accomplish this; see the hook_menu()
+ * documentation for details.
  */
 define('MENU_NOT_FOUND', 2);
 
 /**
- * Internal menu status code -- Menu item access is denied.
+ * Menu status code -- Access denied.
+ *
+ * This can be used as the return value from a page callback, although it is
+ * preferable to use an access callback to accomplish this; see the hook_menu()
+ * documentation for details.
  */
 define('MENU_ACCESS_DENIED', 3);