From f2fbc84dcb056ec2a6bd6ad414746ebdd888f2fb Mon Sep 17 00:00:00 2001
From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Fri, 7 Mar 2014 01:19:07 +0000
Subject: [PATCH] Document Insert() and Prepend() overloads taking wxMenu.

Document these methods in addition to AppendSubMenu().

Closes #16052.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@76091 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 interface/wx/menu.h | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/interface/wx/menu.h b/interface/wx/menu.h
index 42d5f74648..9a0b6d6993 100644
--- a/interface/wx/menu.h
+++ b/interface/wx/menu.h
@@ -652,6 +652,8 @@ public:
         Adds the given @a submenu to this menu. @a text is the text shown in the
         menu for it and @a help is the help string shown in the status bar when the
         submenu item is selected.
+
+        @see Insert(), Prepend()
     */
     wxMenuItem* AppendSubMenu(wxMenu* submenu, const wxString& text,
                               const wxString& help = wxEmptyString);
@@ -865,6 +867,16 @@ public:
                        const wxString& helpString = wxEmptyString,
                        wxItemKind kind = wxITEM_NORMAL);
 
+    /**
+        Inserts the given @a submenu before the position @a pos.
+        @a text is the text shown in the menu for it and @a help is the
+        help string shown in the status bar when the submenu item is selected.
+
+        @see AppendSubMenu(), Prepend()
+    */
+    wxMenuItem* Insert(size_t pos, int id, const wxString& text,
+                       wxMenu* submenu, const wxString& help = wxEmptyString);
+
     /**
         Inserts a checkable item at the given position.
 
@@ -930,6 +942,14 @@ public:
                         const wxString& helpString = wxEmptyString,
                         wxItemKind kind = wxITEM_NORMAL);
 
+    /**
+        Inserts the given @a submenu at position 0.
+
+        @see AppendSubMenu(), Insert()
+    */
+    wxMenuItem* Prepend(int id, const wxString& text, wxMenu* submenu,
+                        const wxString& help = wxEmptyString);
+
     /**
         Inserts a checkable item at position 0.