From: markt <markt@13f79535-47bb-0310-9956-ffa450edef68>
Date: Tue, 27 Oct 2009 22:34:04 +0000 (+0000)
Subject: Document new listener
X-Git-Url: https://git.internetallee.de/?a=commitdiff_plain;h=da39378952fa31c2ce51d636a27fc35587a4b172;p=tomcat7.0

Document new listener

git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@830378 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/webapps/docs/config/listeners.xml b/webapps/docs/config/listeners.xml
index b6498e58a..ed7b374d5 100644
--- a/webapps/docs/config/listeners.xml
+++ b/webapps/docs/config/listeners.xml
@@ -218,6 +218,29 @@ service:jmx:rmi://&lt;hostname&gt;:10002/jndi/rmi://&lt;hostname&gt;:10001/jmxrm
 
     </attributes>
 
+    <h3>JRE Memory Leak Prevention Listener
+        (org.apache.catalina.core.JreMemoryLeakPreventionListener)</h3>
+
+    <p>The <strong>JRE Memory Leak Prevention Listener</strong> provides
+    work-arounds for known places where the Java Runtime environment uses
+    the context class loader to load a singleton as this will cause a memory
+    leak if a web application class loader happens to be the context class
+    loader at the time. The work-around is to initialise these singletons when
+    this listener starts as Tomcat's common class loader is the context class
+    loader at that time.</p>
+    
+    <p>Currently the <strong>JRE Memory Leak Prevention Listener</strong>
+    provides work-arounds for the following:</p>
+    <ul>
+      <li><code>sun.awt.AppContext.getAppContext()</code></li>
+    </ul>
+
+    <p>This listener must only be nested within <a href="server.html">Server</a>
+    elements.</p>
+
+    <p>No additional attributes are support by the <strong>JRE Memory Leak
+    Prevention Listener</strong>.</p>
+
   </subsection>
 
 </section>