From ca8c5feb1640f1d9da2cfb30346fb63fbfaa7fea Mon Sep 17 00:00:00 2001
From: Manolo Gouy <mgouy@biomp2.home>
Date: Mon, 31 Dec 2018 16:03:46 +0100
Subject: Document global variable fl_sys_menu_bar.

---
 FL/Fl_Sys_Menu_Bar.H | 1 +
 FL/mac.H             | 4 ----
 2 files changed, 1 insertion(+), 4 deletions(-)

(limited to 'FL')

diff --git a/FL/Fl_Sys_Menu_Bar.H b/FL/Fl_Sys_Menu_Bar.H
index 551ebc387..2f282df1e 100644
--- a/FL/Fl_Sys_Menu_Bar.H
+++ b/FL/Fl_Sys_Menu_Bar.H
@@ -102,6 +102,7 @@ public:
   static void create_window_menu();
 };
 
+/** The system menu bar. */
 extern Fl_Sys_Menu_Bar *fl_sys_menu_bar;
 
 #endif // Fl_Sys_Menu_Bar_H
diff --git a/FL/mac.H b/FL/mac.H
index 6acb0900d..7e4f345ff 100644
--- a/FL/mac.H
+++ b/FL/mac.H
@@ -135,10 +135,6 @@ void fl_mac_set_about(Fl_Callback *cb, void *user_data, int shortcut = 0);
  */
 extern int fl_mac_os_version;
 
-/** The system menu bar.
- */
-//extern class Fl_Sys_Menu_Bar *fl_sys_menu_bar;
-
 struct Fl_Menu_Item;
 
 class Fl_Mac_App_Menu {
-- 
cgit v1.2.3


From e118532c724e271644463b40b50eafcf11d27f17 Mon Sep 17 00:00:00 2001
From: Manolo Gouy <mgouy@biomp2.home>
Date: Mon, 31 Dec 2018 16:37:36 +0100
Subject: Document global variable fl_sys_menu_bar - continued.

---
 FL/Fl_Sys_Menu_Bar.H | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

(limited to 'FL')

diff --git a/FL/Fl_Sys_Menu_Bar.H b/FL/Fl_Sys_Menu_Bar.H
index 2f282df1e..4d009a26c 100644
--- a/FL/Fl_Sys_Menu_Bar.H
+++ b/FL/Fl_Sys_Menu_Bar.H
@@ -16,6 +16,11 @@
 //     http://www.fltk.org/str.php
 //
 
+/** \file
+ Definition of class Fl_Sys_Menu_Bar.
+ */
+
+
 #ifndef Fl_Sys_Menu_Bar_H
 #define Fl_Sys_Menu_Bar_H
 
@@ -102,7 +107,8 @@ public:
   static void create_window_menu();
 };
 
-/** The system menu bar. */
+/** The system menu bar.
+ */
 extern Fl_Sys_Menu_Bar *fl_sys_menu_bar;
 
 #endif // Fl_Sys_Menu_Bar_H
-- 
cgit v1.2.3


From b027da8322cde4bc33cf7e85a113365abe2b69c3 Mon Sep 17 00:00:00 2001
From: Manolo Gouy <mgouy@biomp2.home>
Date: Wed, 2 Jan 2019 19:41:44 +0100
Subject: Document global variable fl_sys_menu_bar - continued.

---
 FL/Fl_Sys_Menu_Bar.H | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

(limited to 'FL')

diff --git a/FL/Fl_Sys_Menu_Bar.H b/FL/Fl_Sys_Menu_Bar.H
index 4d009a26c..ecf72ff15 100644
--- a/FL/Fl_Sys_Menu_Bar.H
+++ b/FL/Fl_Sys_Menu_Bar.H
@@ -49,7 +49,8 @@ class Fl_Sys_Menu_Bar_Driver;
  Changes to the menu state are immediately visible in the menubar when they are made
  using member functions of the Fl_Sys_Menu_Bar class. Other changes (e.g., by a call to
  Fl_Menu_Item::set()) should be followed by a call to update() to be
- visible in the menubar across all platforms.
+ visible in the menubar across all platforms. Global variable \ref fl_sys_menu_bar points to
+ the unique, current system menu bar.
  
  A few FLTK menu features are not supported by the Mac System menu:
   \li no symbolic labels
-- 
cgit v1.2.3