From 47a9a87d5140d8da6057d235f3c44cd67e3fc6ff Mon Sep 17 00:00:00 2001
From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Sat, 19 Jan 2002 21:45:58 +0000
Subject: [PATCH] documented new CaptureMouse() behaviour

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@13662 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 docs/latex/wx/window.tex | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/latex/wx/window.tex b/docs/latex/wx/window.tex
index a4fceac35d..22eeb905ee 100644
--- a/docs/latex/wx/window.tex
+++ b/docs/latex/wx/window.tex
@@ -127,6 +127,12 @@ functions so should not be required by the application programmer.
 Directs all mouse input to this window. Call \helpref{wxWindow::ReleaseMouse}{wxwindowreleasemouse} to
 release the capture.
 
+Note that wxWindows maintains the stack of windows having captured the mouse
+and when the mouse is released the capture returns to the window which had had
+captured it previously and it is only really released if there were no previous
+window. In particular, this means that you must release the mouse as many times
+as you capture it.
+
 \wxheading{See also}
 
 \helpref{wxWindow::ReleaseMouse}{wxwindowreleasemouse}