[gtk-mac-integration] Bug 744597 - Document that gtk_menu_reorder_child() doesn't update the menu.

[John Ralls <jralls src gnome org>]

commit 5ffb2c4e55da18babdaed84d8b8f1bf08aad0237
Author: John Ralls <jralls ceridwen us>
Date:   Mon Feb 23 10:46:24 2015 -0800

    Bug 744597 - Document that gtk_menu_reorder_child() doesn't update the menu.

 src/gtkosxapplication.c |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)
---
diff --git a/src/gtkosxapplication.c b/src/gtkosxapplication.c
index c31cf7b..e66c248 100644
--- a/src/gtkosxapplication.c
+++ b/src/gtkosxapplication.c
@@ -166,6 +166,11 @@
  * gtkosx_application_sync_menubar(theApp)
  * ]|
  *
+ * N.B.: One GtkMenu function, gtk_menu_reorder_child(), changes the
+ * menu appearance without emitting a signal, so if you use that
+ * function in your code you'll need to call
+ * gtkosx_application_sync_menubar() afterwards.
+ *
  * ## Dock Support
  * The dock is that bar of icons that normally lives at the bottom of
  * the display on a Mac (though it can be moved to one of the other