[deployment-guide/comm-rel: 617/727] Updated the MaxClients directive description.

[Jaromir Hradilek]

commit b939e6edacfb56f4c631a74521aa183256a5affa
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Tue Sep 7 17:25:23 2010 +0200

    Updated the MaxClients directive description.

 en-US/The_Apache_HTTP_Server.xml |   24 ++++++++++++++++++------
 1 files changed, 18 insertions(+), 6 deletions(-)
---
diff --git a/en-US/The_Apache_HTTP_Server.xml b/en-US/The_Apache_HTTP_Server.xml
index d007d40..9c8bec7 100644
--- a/en-US/The_Apache_HTTP_Server.xml
+++ b/en-US/The_Apache_HTTP_Server.xml
@@ -2706,12 +2706,24 @@ ErrorDocument 404 /404-not_found.html</screen>
       <para>
         The following MPM directives are commonly used in <filename>/etc/httpd/conf/httpd.conf</filename>:
       </para>
-      <formalpara id="s3-apache-maxclients">
-        <title>MaxClients</title>
-        <para>
-          <command>MaxClients</command> sets a limit on the total number of server processes, or simultaneously connected clients, that can run at one time. The main purpose of this directive is to keep a runaway Apache HTTP Server from crashing the operating system. For busy servers this value should be set to a high value. The server's default is set to 150 regardless of the MPM in use. However, it is not recommended that the value for <command>MaxClients</command> exceeds <command>256</command> when using the <command>prefork</command> MPM.
-        </para>
-      </formalpara>
+      <variablelist>
+        <varlistentry>
+          <term><option>MaxClients</option></term>
+          <listitem>
+            <para>
+              The <option>MaxClients</option> directive allows you to specify the maximum number of simultaneously connected clients to process at one time. It takes the following form:
+            </para>
+            <screen>MaxClients <replaceable>number</replaceable></screen>
+            <para>
+              A high <replaceable>number</replaceable> can improve the performance of the server, although it is not recommended to exceed <literal>256</literal> when using the <systemitem class="resource">prefork</systemitem> MPM.
+            </para>
+            <example id="example-apache-mpm-maxclients">
+              <title>Using the <option>MaxClients</option> directive</title>
+              <screen>MaxClients 256</screen>
+            </example>
+          </listitem>
+        </varlistentry>
+      </variablelist>
       <formalpara id="s3-apache-maxrequestsperchild">
         <title>MaxRequestsPerChild</title>
         <para>