From 2291c07d2bf9b3d47eb1b419fe1d75dea67ee707 Mon Sep 17 00:00:00 2001
From: mattias <nc-gaertnma@netcologne.de>
Date: Wed, 26 Oct 2016 08:14:59 +0000
Subject: [PATCH] lcl: doc

git-svn-id: trunk@53214 -
---
 docs/xml/lcl/forms.xml | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/docs/xml/lcl/forms.xml b/docs/xml/lcl/forms.xml
index b9be0680a9..bcb4d72cd4 100644
--- a/docs/xml/lcl/forms.xml
+++ b/docs/xml/lcl/forms.xml
@@ -3016,9 +3016,14 @@
       <element name="TCustomForm.ShowModal">
         <short>Show this form as a modal Dialog.
         </short>
-        <descr>The call doesn't return until the form is closed.
-          The application switches to modal state until then.
-        </descr>
+        <descr>Shows the form in modal state and waits til it is closed by the user or by the program.
+Modal state means that neither the user nor the program can switch to forms, that were already visible before ShowModal.
+
+The form must have Visible=false when calling ShowModal.
+The call doesn't return until the form is closed.
+The application switches to modal state until then.
+ShowModal creates its own event loop calling ProcessMessages.
+</descr>
         <errors>EInvalidOperation if the form cannot be shown modally.
         </errors>
         <seealso/>