Document wxTopLevelWindow::Restore().

This was never documented, probably because it's not actually very clear to
understand what exactly does it do.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@75900 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

interface/wx/toplevel.h

@@ -208,7 +208,7 @@ public:
         @param iconize
             If @true, iconizes the window; if @false, shows and restores it.
 
-        @see IsIconized(), Maximize(), wxIconizeEvent.
+        @see IsIconized(), Restore()(), wxIconizeEvent.
     */
     virtual void Iconize(bool iconize = true);
 
@@ -265,7 +265,7 @@ public:
         @param maximize
             If @true, maximizes the window, otherwise it restores it.
 
-        @see Iconize()
+        @see Restore(), Iconize()
     */
     virtual void Maximize(bool maximize = true);
 
@@ -315,6 +315,18 @@ public:
     */
     virtual void RequestUserAttention(int flags = wxUSER_ATTENTION_INFO);
 
+    /**
+        Restore a previously iconized or maximized window to its normal state.
+
+        In wxGTK this method currently doesn't return the maximized window to
+        its normal state and you must use Maximize() with @false argument
+        explicitly for this. In the other ports, it both unmaximizes the
+        maximized windows and uniconizes the iconized ones.
+
+        @see Iconize(), Maximize()
+     */
+    void Restore();
+
     /**
         Changes the default item for the panel, usually @a win is a button.