diff options
| author | Albrecht Schlosser <albrechts.fltk@online.de> | 2016-07-09 17:14:22 +0000 |
|---|---|---|
| committer | Albrecht Schlosser <albrechts.fltk@online.de> | 2016-07-09 17:14:22 +0000 |
| commit | d1b9d1032f8ec819ade30643f21f44fe81bd47e5 (patch) | |
| tree | 982e38fdb1ef7628c26afa2df9c24c79cefb91c3 /src/Fl_Menu_.cxx | |
| parent | 05d60bd29d05289609c9a0f14c47e36c31ac61ae (diff) | |
Documentation fixes and clarifications.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3-porting@11802 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
Diffstat (limited to 'src/Fl_Menu_.cxx')
| -rw-r--r-- | src/Fl_Menu_.cxx | 14 |
1 files changed, 7 insertions, 7 deletions
diff --git a/src/Fl_Menu_.cxx b/src/Fl_Menu_.cxx index 6ab3797a3..487641a36 100644 --- a/src/Fl_Menu_.cxx +++ b/src/Fl_Menu_.cxx @@ -3,7 +3,7 @@ // // Common menu code for the Fast Light Tool Kit (FLTK). // -// Copyright 1998-2010 by Bill Spitzak and others. +// Copyright 1998-2016 by Bill Spitzak and others. // // This library is free software. Distribution and use rights are outlined in // the file "COPYING" which should have been included with this file. If this @@ -154,8 +154,8 @@ const Fl_Menu_Item * Fl_Menu_::find_item(const char *pathname) { } /** - Find the index the menu array for given \p item. - + Find the index into the menu array for a given \p item. + A way to convert a menu item pointer into an index. Does \b not handle items that are in submenu pointers (FL_SUBMENU_POINTER). @@ -175,7 +175,7 @@ const Fl_Menu_Item * Fl_Menu_::find_item(const char *pathname) { if ( index == -1 ) { ..error.. } \endcode - \param item The *item to be found + \param[in] item The item to be found \returns The index of the item, or -1 if not found. \see menu() */ @@ -212,7 +212,7 @@ int Fl_Menu_::find_index(Fl_Callback *cb) const { To get the menu item pointer for a pathname, use find_item() - \param pathname The path and name of the menu item index to find + \param[in] pathname The path and name of the menu item to find \returns The index of the matching item, or -1 if not found. \see item_pathname() @@ -254,7 +254,7 @@ int Fl_Menu_::find_index(const char *pathname) const { internationalisation and a menu item can not be found using its label. This search is also much faster. - \param cb find the first item with this callback + \param[in] cb find the first item with this callback \returns The item found, or NULL if not found \see find_item(const char*) */ @@ -482,7 +482,7 @@ void Fl_Menu_::clear() { is done to make a private array. \warning Since this method can change the internal menu array, any menu - item pointers or indecies the application may have cached can become + item pointers or indices the application may have cached can become stale, and should be recalculated/refreshed. \b Example: |
