From 4c4ca4e7138bdc27e0bcbc542712b14b8430095d Mon Sep 17 00:00:00 2001
From: alexrp <xtzgzorex@gmail.com>
Date: Wed, 14 Mar 2012 14:30:17 +0100
Subject: [PATCH] Document that synchronized supports recursive locking.

---
 statement.dd | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/statement.dd b/statement.dd
index 6394faa228..2f60cf86c2 100644
--- a/statement.dd
+++ b/statement.dd
@@ -1404,6 +1404,12 @@ synchronized { ... }
         $(P This implements a standard critical section.
         )
 
+        $(P Synchronized statements support recursive locking; that is, a
+        function wrapped in synchronized is allowed to recursively call
+        itself and the behavior will be as expected: The mutex will be
+        locked and unlocked as many times as there is recursion.
+        )
+
 <h2>$(LNAME2 TryStatement, Try Statement)</h2>
 
         Exception handling is done with the try-catch-finally statement.