From f4e2292f8049576d3a60d22e3e8fb83184406214 Mon Sep 17 00:00:00 2001
From: Manolo Gouy <Manolo>
Date: Tue, 11 Feb 2014 13:55:42 +0000
Subject: [PATCH] Added some missing Doxygen comments in the Fl_Sys_Menu_Bar
 class.

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10101 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
---
 FL/Fl_Sys_Menu_Bar.H | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/FL/Fl_Sys_Menu_Bar.H b/FL/Fl_Sys_Menu_Bar.H
index 14ab8d0dd..c5c5b97e3 100644
--- a/FL/Fl_Sys_Menu_Bar.H
+++ b/FL/Fl_Sys_Menu_Bar.H
@@ -27,8 +27,9 @@
 /**
  \brief A class to create, modify and delete menus that appear on Mac OS X in the menu bar at the top of the screen.
  
-  On other than Mac OS X platforms, Fl_Sys_Menu_Bar is a synonym of class Fl_Menu_Bar.
-  Some FLTK features are not supported by the Mac System menu:
+  On other than Mac OS X platforms, Fl_Sys_Menu_Bar is a synonym of class Fl_Menu_Bar,
+ except for Fl_Sys_Menu_Bar::update() defined for Mac OS X only.
+  \n Some FLTK features are not supported by the Mac System menu:
   \li no symbolic labels
   \li no embossed labels
   \li no font sizes
@@ -43,21 +44,27 @@ protected:
 public:
   Fl_Sys_Menu_Bar(int x,int y,int w,int h,const char *l=0);
   ~Fl_Sys_Menu_Bar();
+  /** Return the system menu's array of Fl_Menu_Item's */
   const Fl_Menu_Item *menu() const {return Fl_Menu_::menu();}
   void menu(const Fl_Menu_Item *m);
   int add(const char* label, int shortcut, Fl_Callback*, void *user_data=0, int flags=0);
+  /** Adds a new menu item. 
+   \see Fl_Menu_::add(const char* label, int shortcut, Fl_Callback*, void *user_data=0, int flags=0)
+   */
   int add(const char* label, const char* shortcut, Fl_Callback* cb, void *user_data=0, int flags=0) {
     return add(label, fl_old_shortcut(shortcut), cb, user_data, flags);
     }
   int insert(int index, const char* label, int shortcut, Fl_Callback *cb, void *user_data=0, int flags=0);
   void remove(int n);
   void replace(int rank, const char *name);
-#ifdef __APPLE__
   void update();
-#else
-  void update() {}
-#endif
+  /** Set the Fl_Menu_Item array pointer to null, indicating a zero-length menu. 
+   \see Fl_Menu_::clear()
+   */
   void clear();
+  /** Clears the specified submenu pointed to by index of all menu items.
+   \see Fl_Menu_::clear_submenu(int index)
+   */
   int clear_submenu(int index);
 };