From 6be8fc666727281a3887560a5038d6cd50f07cbc Mon Sep 17 00:00:00 2001
From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Mon, 17 Feb 2014 23:52:50 +0000
Subject: [PATCH] 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 | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/interface/wx/toplevel.h b/interface/wx/toplevel.h
index 27775eb513..e7f5c3423f 100644
--- a/interface/wx/toplevel.h
+++ b/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.