hwmon: lm63: Use ARRAY_SIZE at appropriate place

[oweals/u-boot.git] / doc / README.menu

diff --git a/doc/README.menu b/doc/README.menu
index f55eb801b9a6862dc68fe28066cb7bb976eb531c..a8999cab51188c1e12c09e38f2cde8c15d4415e1 100644 (file)
--- a/doc/README.menu
+++ b/doc/README.menu
@@ -25,6 +25,11 @@ the interfaces should be available.
 Menus are composed of items. Each item has a key used to identify it in
 the menu, and an opaque pointer to data controlled by the consumer.
 
+If you want to show a menu, instead starting the shell, define
+CONFIG_MENU_SHOW. You have to code the int menu_show(int bootdelay)
+function, which handle your menu. This function returns the remaining
+bootdelay.
+
 Interfaces
 ----------
 #include "menu.h"
@@ -45,8 +50,10 @@ struct menu;
 /*
  * menu_create() - Creates a menu handle with default settings
  */
-struct menu *menu_create(char *title, int prompt,
-                               void (*item_data_print)(void *));
+struct menu *menu_create(char *title, int timeout, int prompt,
+                               void (*item_data_print)(void *),
+                               char *(*item_choice)(void *),
+                               void *item_choice_data);
 
 /*
  * menu_item_add() - Adds or replaces a menu item
@@ -58,9 +65,14 @@ int menu_item_add(struct menu *m, char *item_key, void *item_data);
  */
 int menu_default_set(struct menu *m, char *item_key);
 
+/*
+ * menu_default_choice() - Set *choice to point to the default item's data
+ */
+int menu_default_choice(struct menu *m, void **choice);
+
 /*
  * menu_get_choice() - Returns the user's selected menu entry, or the
- * default if the menu is set to not prompt.
+ * default if the menu is set to not prompt or the timeout expires.
  */
 int menu_get_choice(struct menu *m, void **choice);
 
@@ -69,6 +81,11 @@ int menu_get_choice(struct menu *m, void **choice);
  */
 int menu_destroy(struct menu *m);
 
+/*
+ * menu_display_statusline(struct menu *m);
+ * shows a statusline for every menu_display call.
+ */
+void menu_display_statusline(struct menu *m);
 
 Example Code
 ------------
@@ -90,14 +107,14 @@ char *pick_a_tool(void)
        int i;
        char *tool = NULL;
 
-       m = menu_create("Tools", 1, NULL);
+       m = menu_create("Tools", 0, 1, NULL);
 
        for(i = 0; tools[i]; i++) {
                if (menu_item_add(m, tools[i], tools[i]) != 1) {
                        printf("failed to add item!");
                        menu_destroy(m);
                        return NULL;
-                }
+               }
        }
 
        if (menu_get_choice(m, (void **)&tool) != 1)