Start adding more FAQs. Some copied from the 1.3 FAQ.

I hope to add a few new ones every couple days.


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

7 files changed, 228 insertions, 104 deletions

diff --git a/docs/manual/faq/all_in_one.html.en b/docs/manual/faq/all_in_one.html.en
index 92f0bb4f4a..1a8ac4c82f 100644
--- a/docs/manual/faq/all_in_one.html.en
+++ b/docs/manual/faq/all_in_one.html.en
@@ -32,16 +32,91 @@
     FAQ</a> to see if your question is answered there.</p>
 </div>
 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#topics">Topics</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#background">Background</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#support">Support</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#error">Error Messages</a></li>
 </ul></div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
 <h2><a id="topics" name="topics">Topics</a></h2>
-<dl><dt><a href="#support">Support</a></dt><dd>What do I do when I have problems?</dd>
+<dl><dt><a href="#background">Background</a></dt><dd />
+<dt><a href="#support">Support</a></dt><dd>What do I do when I have problems?</dd>
 <dt><a href="#error">Error Messages</a></dt><dd>What does this error message mean?</dd>
 </dl></div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
+<h2><a name="background" id="background">Background</a></h2>
+
+    <ul>
+    <li><a href="#background.what-is-apache">What is Apache?</a></li>
+    <li><a href="#background.what-is-httpd">What is the Apache HTTP 
+    Server?</a></li>
+    <li><a href="#background.tested">How thoroughly tested is 
+    Apache?</a></li>
+    <li><a href="#background.logo">May I use the Apache logo on my 
+    product or Web site?</a></li>
+    </ul>
+    
+    <h3><a name="background.what-is-apache" id="background.what-is-apache">What is Apache?</a></h3>
+      
+
+      <p>The Apache Software Foundation (ASF) is a 501(c)3 non-profit 
+      organization, originating from the development of the Apache HTTPD 
+      Server.  For details on the history of the ASF, please see the 
+      <a href="">Foundation FAQ</a></p>
+	
+	
+	<h3><a name="background.what-is-httpd" id="background.what-is-httpd">What is the Apache HTTP Server?</a></h3>
+      
+      <ul>
+        <li>is a powerful, flexible, HTTP/1.1 compliant web server</li>
+        <li>implements the latest protocols, including HTTP/1.1 (RFC2616)</li>
+        <li>is highly configurable and extensible with third-party modules</li>
+        <li>can be customised by writing 'modules' using the Apache 
+        module API</li>
+        <li>provides full source code and comes with an 
+        <a href="http://www.apache.org/licenses/LICENSE-2.0">unrestrictive 
+        license</a></li>
+        <li>runs on Windows 2003/XP/2000/NT/9x, Netware 5.x and above, OS/2, 
+        and most versions of Unix, as well as several other operating 
+        systems</li>
+        <li>is actively being developed</li>
+        <li>encourages user feedback through new ideas, bug reports and
+        patches</li>
+      </ul>
+	
+	
+	<h3><a name="background.tested" id="background.tested">How thoroughly tested is Apache?</a></h3>
+      
+      Apache is run on millions of Internet servers.
+      It has been tested thoroughly by both developers and users. The Apache
+      HTTP Server Project maintains rigorous standards before releasing new 
+      versions of our server, and our server runs without a hitch on over 
+      70% of all WWW servers available on the Internet. When bugs do show 
+      up, we release patches and new versions as soon as they are available.
+    
+
+	<h3><a name="background.logo" id="background.logo">How thoroughly tested is Apache?</a></h3>
+      
+      You may <em>NOT</em> use any original artwork from the Apache
+      Software Foundation, nor make or use modified versions of such
+      artwork, except under the following conditions:
+      <ul>
+        <li>You may use the <a href="http://httpd.apache.org/docs/apache_pb.gif">'Powered by Apache'
+        graphic</a> on a Web site that is being served by the Apache HTTP
+        server software.</li>
+        <li>You may use the aforementioned <a href="http://httpd.apache.org/docs/apache_pb.gif">'Powered by Apache'
+        graphic</a> or the <a href="http://www.apache.org/images/asf_logo.gif">Apache Software
+        Foundation logo</a> in product description and promotional material
+        <em>IF and ONLY IF</em> such use can in no way be interpreted as
+        anything other than an attribution. Using the Apache name and 
+        artwork in a manner that implies endorsement of a product or
+        service is <a href="">strictly forbidden.</a></li>
+      </ul>
+      For details, or related issues, please contact the Apache Software
+      Foundation's <a href="">Public Relations Committee</a>.
+    
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
 <h2><a name="support" id="support">Support</a></h2>
     <ul>
     <li><a href="#support.what2do">"Why can't I ...? Why won't ... work?" What
@@ -58,7 +133,7 @@
       take the following steps:</p>
 
       <dl>
-      <dt>Check the errorlog!</dt>
+      <dt>Check the ErrorLog!</dt>
       <dd>Apache tries to be helpful when it encounters a problem. In many
       cases, it will provide some details by writing one or more messages to the
       server error log. Sometimes this is enough for you to diagnose &amp; fix
@@ -67,7 +142,10 @@
       <code>/usr/local/apache2/logs/error_log</code>, but see the <code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code> directive in your config files for the
       location on your server.</dd>
 
-      <dt>Check the <a href="http://httpd.apache.org/docs-2.1/faq/">FAQ</a>!</dt>
+      <dt>Check the ErrorLog again!</dt>
+      <dd>Nearly all problems can be solved by reading the error log.</dd>
+      
+      <dt>Check the <a href="http://httpd.apache.org/docs/2.3/faq/">FAQ</a>!</dt>
       <dd>The latest version of the Apache Frequently-Asked Questions list can
       always be found at the main Apache web site.</dd>
 
@@ -90,49 +168,26 @@
       <p><a href="http://httpd.apache.org/userslist.html">Users
       mailing list</a></p>
 
-      <p>USENET newsgroups:</p>
-
-      <ul>
-      <li>comp.infosystems.www.servers.unix
-      [<a href="news:comp.infosystems.www.servers.unix">news</a>]
-      [<a href="http://groups.google.com/groups?group=comp.infosystems.www.servers.unix">google</a>]
-      </li>
-
-      <li>comp.infosystems.www.servers.ms-windows
-      [<a href="news:comp.infosystems.www.servers.ms-windows">news</a>]
-      [<a href="http://groups.google.com/groups?group=comp.infosystems.www.servers.ms-windows">google</a>]
-      </li>
-
-      <li>comp.infosystems.www.authoring.cgi
-      [<a href="news:comp.infosystems.www.authoring.cgi">news</a>]
-      [<a href="http://groups.google.com/groups?group=comp.infosystems.www.authoring.cgi">google</a>]
-      </li>
-      </ul></dd>
-
-      <dt>If all else fails, report the problem in the bug database</dt>
+      <p><a href="irc://irc.freenode.net/#apache">#apache</a> on 
+      <a href="http://freenode.net">Freenode IRC</a> is also available for 
+      user support issues.</p>
+      </dd>
+      
+      <dt>Please use the bug database for bugs!</dt>
       <dd><p>If you've gone through those steps above that are appropriate and
       have obtained no relief, then please <em>do</em> let the httpd developers
       know about the problem by <a href="http://httpd.apache.org/bug_report.html">logging a bug
       report</a>.</p>
 
       <p>If your problem involves the server crashing and generating a core
-      dump, please include a backtrace (if possible). As an example,</p>
-
-      <div class="example"><p><code>
-        # cd <var>ServerRoot</var><br />
-        # dbx <var>httpd</var> <var>core</var><br />
-        (dbx) where
-      </code></p></div>
-
-      <p>(Substitute the appropriate locations for your <var>ServerRoot</var>
-      and your <var>httpd</var> and <var>core</var> files. You may have to use
-      <code>gdb</code> instead of <code>dbx</code>.)</p>
+      dump, please <a href="http://httpd.apache.org/dev/debugging.html">
+      include a backtrace</a> (if possible).</p>
       </dd>
       </dl>
     
 
     <h3><a name="support.support" id="support.support">Whom do I contact for support?</a></h3>
-      <p>With several million users and fewer than forty volunteer developers,
+      <p>With millions of users and fewer than sixty volunteer developers,
       we cannot provide personal support for Apache. For free support, we
       suggest participating in a <a href="#support.what2do.user-support">user forum</a>.</p>
 
diff --git a/docs/manual/faq/background.xml b/docs/manual/faq/background.xml
new file mode 100644
index 0000000000..066d60efc3
--- /dev/null
+++ b/docs/manual/faq/background.xml
@@ -0,0 +1,96 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE faq SYSTEM "../style/faq.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
+<!-- $LastChangedRevision: 151408 $ -->
+
+<!--
+ Copyright 2003-2005 The Apache Software Foundation or its licensors, as
+ applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<faq metafile="background.xml.meta">
+<parentdocument href="./">FAQ</parentdocument>
+
+<title>Background - Frequently Asked Questions</title>
+<section id="background"><title>Background</title>
+
+    <ul>
+    <li><a href="#background.what-is-apache">What is Apache?</a></li>
+    <li><a href="#background.what-is-httpd">What is the Apache HTTP 
+    Server?</a></li>
+    <li><a href="#background.tested">How thoroughly tested is 
+    Apache?</a></li>
+    <li><a href="#background.logo">May I use the Apache logo on my 
+    product or Web site?</a></li>
+    </ul>
+    
+    <section id="background.what-is-apache">
+      <title>What is Apache?</title>
+
+      <p>The Apache Software Foundation (ASF) is a 501(c)3 non-profit 
+      organization, originating from the development of the Apache HTTPD 
+      Server.  For details on the history of the ASF, please see the 
+      <a href="">Foundation FAQ</a></p>
+	</section>
+	
+	<section id="background.what-is-httpd">
+      <title>What is the Apache HTTP Server?</title>
+      <ul>
+        <li>is a powerful, flexible, HTTP/1.1 compliant web server</li>
+        <li>implements the latest protocols, including HTTP/1.1 (RFC2616)</li>
        <li>is highly configurable and extensible with third-party modules</li>
        <li>can be customised by writing 'modules' using the Apache 
+        module API</li>
        <li>provides full source code and comes with an 
+        <a href="http://www.apache.org/licenses/LICENSE-2.0">unrestrictive 
+        license</a></li>
        <li>runs on Windows 2003/XP/2000/NT/9x, Netware 5.x and above, OS/2, 
+        and most versions of Unix, as well as several other operating 
+        systems</li>
        <li>is actively being developed</li>
        <li>encourages user feedback through new ideas, bug reports and
+        patches</li>
+      </ul>
+	</section>
+	
+	<section id="background.tested">
+      <title>How thoroughly tested is Apache?</title>
+      Apache is run on millions of Internet servers.
+      It has been tested thoroughly by both developers and users. The Apache
+      HTTP Server Project maintains rigorous standards before releasing new 
+      versions of our server, and our server runs without a hitch on over 
+      70% of all WWW servers available on the Internet. When bugs do show 
+      up, we release patches and new versions as soon as they are available.
+    </section>
+
+	<section id="background.logo">
+      <title>How thoroughly tested is Apache?</title>
+      You may <em>NOT</em> use any original artwork from the Apache
+      Software Foundation, nor make or use modified versions of such
+      artwork, except under the following conditions:
+      <ul>
+        <li>You may use the <a 
+        href="http://httpd.apache.org/docs/apache_pb.gif">'Powered by Apache'
+        graphic</a> on a Web site that is being served by the Apache HTTP
+        server software.</li>
+        <li>You may use the aforementioned <a 
+        href="http://httpd.apache.org/docs/apache_pb.gif">'Powered by Apache'
+        graphic</a> or the <a 
+        href="http://www.apache.org/images/asf_logo.gif">Apache Software
+        Foundation logo</a> in product description and promotional material
+        <em>IF and ONLY IF</em> such use can in no way be interpreted as
+        anything other than an attribution. Using the Apache name and 
+        artwork in a manner that implies endorsement of a product or
+        service is <a href="">strictly forbidden.</a></li>
+      </ul>
+      For details, or related issues, please contact the Apache Software
+      Foundation's <a href="">Public Relations Committee</a>.
+    </section>
+ </section>
+</faq>
diff --git a/docs/manual/faq/background.xml.meta b/docs/manual/faq/background.xml.meta
new file mode 100644
index 0000000000..896b2885ec
--- /dev/null
+++ b/docs/manual/faq/background.xml.meta
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<metafile>
+  <basename>background</basename>
+  <path>/faq/</path>
+  <relpath>..</relpath>
+
+  <variants>
+    <variant>en</variant>
+  </variants>
+</metafile>
diff --git a/docs/manual/faq/categories.xml b/docs/manual/faq/categories.xml
index c4ce5856ee..d10e1a4d13 100644
--- a/docs/manual/faq/categories.xml
+++ b/docs/manual/faq/categories.xml
@@ -18,6 +18,7 @@
 -->
 
 <categories>
+  <categoryfile>background.xml</categoryfile>
   <categoryfile>support.xml</categoryfile>
   <categoryfile>error.xml</categoryfile>
 </categories>
diff --git a/docs/manual/faq/index.html.en b/docs/manual/faq/index.html.en
index 6a583dae92..9f47800317 100644
--- a/docs/manual/faq/index.html.en
+++ b/docs/manual/faq/index.html.en
@@ -36,7 +36,8 @@
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
 <h2><a id="topics" name="topics">Topics</a></h2>
-<dl><dt><a href="support.html">Support</a></dt><dd>What do I do when I have problems?</dd>
+<dl><dt><a href="background.html">Background</a></dt><dd />
+<dt><a href="support.html">Support</a></dt><dd>What do I do when I have problems?</dd>
 <dt><a href="error.html">Error Messages</a></dt><dd>What does this error message mean?</dd>
 </dl></div></div>
 <div class="bottomlang">
diff --git a/docs/manual/faq/support.html.en b/docs/manual/faq/support.html.en
index b4ca2df03d..9b7b5991c8 100644
--- a/docs/manual/faq/support.html.en
+++ b/docs/manual/faq/support.html.en
@@ -41,7 +41,7 @@
       take the following steps:</p>
 
       <dl>
-      <dt>Check the errorlog!</dt>
+      <dt>Check the ErrorLog!</dt>
       <dd>Apache tries to be helpful when it encounters a problem. In many
       cases, it will provide some details by writing one or more messages to the
       server error log. Sometimes this is enough for you to diagnose &amp; fix
@@ -50,7 +50,10 @@
       <code>/usr/local/apache2/logs/error_log</code>, but see the <code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code> directive in your config files for the
       location on your server.</dd>
 
-      <dt>Check the <a href="http://httpd.apache.org/docs-2.1/faq/">FAQ</a>!</dt>
+      <dt>Check the ErrorLog again!</dt>
+      <dd>Nearly all problems can be solved by reading the error log.</dd>
+      
+      <dt>Check the <a href="http://httpd.apache.org/docs/2.3/faq/">FAQ</a>!</dt>
       <dd>The latest version of the Apache Frequently-Asked Questions list can
       always be found at the main Apache web site.</dd>
 
@@ -73,49 +76,26 @@
       <p><a href="http://httpd.apache.org/userslist.html">Users
       mailing list</a></p>
 
-      <p>USENET newsgroups:</p>
-
-      <ul>
-      <li>comp.infosystems.www.servers.unix
-      [<a href="news:comp.infosystems.www.servers.unix">news</a>]
-      [<a href="http://groups.google.com/groups?group=comp.infosystems.www.servers.unix">google</a>]
-      </li>
-
-      <li>comp.infosystems.www.servers.ms-windows
-      [<a href="news:comp.infosystems.www.servers.ms-windows">news</a>]
-      [<a href="http://groups.google.com/groups?group=comp.infosystems.www.servers.ms-windows">google</a>]
-      </li>
-
-      <li>comp.infosystems.www.authoring.cgi
-      [<a href="news:comp.infosystems.www.authoring.cgi">news</a>]
-      [<a href="http://groups.google.com/groups?group=comp.infosystems.www.authoring.cgi">google</a>]
-      </li>
-      </ul></dd>
-
-      <dt>If all else fails, report the problem in the bug database</dt>
+      <p><a href="irc://irc.freenode.net/#apache">#apache</a> on 
+      <a href="http://freenode.net">Freenode IRC</a> is also available for 
+      user support issues.</p>
+      </dd>
+      
+      <dt>Please use the bug database for bugs!</dt>
       <dd><p>If you've gone through those steps above that are appropriate and
       have obtained no relief, then please <em>do</em> let the httpd developers
       know about the problem by <a href="http://httpd.apache.org/bug_report.html">logging a bug
       report</a>.</p>
 
       <p>If your problem involves the server crashing and generating a core
-      dump, please include a backtrace (if possible). As an example,</p>
-
-      <div class="example"><p><code>
-        # cd <var>ServerRoot</var><br />
-        # dbx <var>httpd</var> <var>core</var><br />
-        (dbx) where
-      </code></p></div>
-
-      <p>(Substitute the appropriate locations for your <var>ServerRoot</var>
-      and your <var>httpd</var> and <var>core</var> files. You may have to use
-      <code>gdb</code> instead of <code>dbx</code>.)</p>
+      dump, please <a href="http://httpd.apache.org/dev/debugging.html">
+      include a backtrace</a> (if possible).</p>
       </dd>
       </dl>
     
 
     <h3><a name="support.support" id="support.support">Whom do I contact for support?</a></h3>
-      <p>With several million users and fewer than forty volunteer developers,
+      <p>With millions of users and fewer than sixty volunteer developers,
       we cannot provide personal support for Apache. For free support, we
       suggest participating in a <a href="#support.what2do.user-support">user forum</a>.</p>
 
diff --git a/docs/manual/faq/support.xml b/docs/manual/faq/support.xml
index 42f58f635b..27d587d1ce 100644
--- a/docs/manual/faq/support.xml
+++ b/docs/manual/faq/support.xml
@@ -42,7 +42,7 @@
       take the following steps:</p>
 
       <dl>
-      <dt>Check the errorlog!</dt>
+      <dt>Check the ErrorLog!</dt>
       <dd>Apache tries to be helpful when it encounters a problem. In many
       cases, it will provide some details by writing one or more messages to the
       server error log. Sometimes this is enough for you to diagnose &amp; fix
@@ -52,8 +52,11 @@
       module="core">ErrorLog</directive> directive in your config files for the
       location on your server.</dd>
 
+      <dt>Check the ErrorLog again!</dt>
+      <dd>Nearly all problems can be solved by reading the error log.</dd>
+      
       <dt>Check the <a
-      href="http://httpd.apache.org/docs-2.1/faq/">FAQ</a>!</dt>
+      href="http://httpd.apache.org/docs/2.3/faq/">FAQ</a>!</dt>
       <dd>The latest version of the Apache Frequently-Asked Questions list can
       always be found at the main Apache web site.</dd>
 
@@ -77,26 +80,12 @@
       <p><a href="http://httpd.apache.org/userslist.html">Users
       mailing list</a></p>
 
-      <p>USENET newsgroups:</p>
-
-      <ul>
-      <li>comp.infosystems.www.servers.unix
-      [<a href="news:comp.infosystems.www.servers.unix">news</a>]
-      [<a href="http://groups.google.com/groups?group=comp.infosystems.www.servers.unix">google</a>]
-      </li>
-
-      <li>comp.infosystems.www.servers.ms-windows
-      [<a href="news:comp.infosystems.www.servers.ms-windows">news</a>]
-      [<a href="http://groups.google.com/groups?group=comp.infosystems.www.servers.ms-windows">google</a>]
-      </li>
-
-      <li>comp.infosystems.www.authoring.cgi
-      [<a href="news:comp.infosystems.www.authoring.cgi">news</a>]
-      [<a href="http://groups.google.com/groups?group=comp.infosystems.www.authoring.cgi">google</a>]
-      </li>
-      </ul></dd>
-
-      <dt>If all else fails, report the problem in the bug database</dt>
+      <p><a href="irc://irc.freenode.net/#apache">#apache</a> on 
+      <a href="http://freenode.net">Freenode IRC</a> is also available for 
+      user support issues.</p>
+      </dd>
+      
+      <dt>Please use the bug database for bugs!</dt>
       <dd><p>If you've gone through those steps above that are appropriate and
       have obtained no relief, then please <em>do</em> let the httpd developers
       know about the problem by <a
@@ -104,23 +93,14 @@
       report</a>.</p>
 
       <p>If your problem involves the server crashing and generating a core
-      dump, please include a backtrace (if possible). As an example,</p>
-
-      <example>
-        # cd <var>ServerRoot</var><br />
-        # dbx <var>httpd</var> <var>core</var><br />
-        (dbx) where
-      </example>
-
-      <p>(Substitute the appropriate locations for your <var>ServerRoot</var>
-      and your <var>httpd</var> and <var>core</var> files. You may have to use
-      <code>gdb</code> instead of <code>dbx</code>.)</p>
+      dump, please <a href="http://httpd.apache.org/dev/debugging.html">
+      include a backtrace</a> (if possible).</p>
       </dd>
       </dl>
     </section>
 
     <section id="support.support"><title>Whom do I contact for support?</title>
-      <p>With several million users and fewer than forty volunteer developers,
+      <p>With millions of users and fewer than sixty volunteer developers,
       we cannot provide personal support for Apache. For free support, we
       suggest participating in a <a href="#support.what2do.user-support"
       >user forum</a>.</p>