--- webapps/docs/config/valve.xml	(revision 1696359)
+++ webapps/docs/config/valve.xml	(working copy)
@@ -1729,6 +1729,61 @@ 
 
 </section>
 
+<section name="Semaphore Valve">
+
+  <subsection name="Introduction">
+
+    <p>The <strong>Semaphore Valve</strong> is able to limit the number of
+    request processing thread concurrency.</p>
+    <p><strong>org.apache.catalina.valves.SemaphoreValve</strong> provide
+    methods which are able to extend in order to override by subclass.</p>
+    <ul>
+    <li><b><code>controlConcurrency</code></b> method is able to extend in
+    order to add conditions</li>
+    <li><b><code>permitDenied</code></b> method is able to extend in order to
+    add error handling when a permit isn't granted</li>
+    </ul>
+
+  </subsection>
+
+  <subsection name="Attributes">
+
+    <p>The <strong>Semaphore Valve</strong> supports the following
+    configuration attributes:</p>
+
+    <attributes>
+
+      <attribute name="block" required="false">
+        <p>Flag to determine if thread is blocked until a permit is available.
+        The default value is <strong>true</strong>.</p>
+      </attribute>
+
+      <attribute name="className" required="true">
+        <p>Java class name of the implementation to use. This MUST be set to
+        <strong>org.apache.catalina.valves.SemaphoreValve</strong>.</p>
+      </attribute>
+
+      <attribute name="concurrency" required="false">
+        <p>Concurrency level of the semaphore. The default value is
+        <strong>10</strong>.</p>
+      </attribute>
+
+      <attribute name="fairness" required="false">
+        <p>Fairness of the semaphore. The default value is
+        <strong>false</strong>.</p>
+      </attribute>
+
+      <attribute name="interruptible" required="false">
+        <p>Flag to determine if thread allow the interrupt until a permit is
+        available. The default value is <strong>false</strong>.</p>
+      </attribute>
+
+    </attributes>
+
+  </subsection>
+
+</section>
+
 </body>