You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by sl...@apache.org on 2007/05/04 16:45:54 UTC
svn commit: r535267 - /httpd/httpd/branches/2.2.x/docs/manual/faq/
Author: slive
Date: Fri May 4 07:45:52 2007
New Revision: 535267
URL: http://svn.apache.org/viewvc?view=rev&rev=535267
Log:
Backport r535248
As discussed on docs@httpd, remove the FAQ and replace it with the contents
of the old support.xml and a pointer to the wiki.
Of possible interest: I've also removed the link to the professional support
database, since it was returning error 500 for some time and nobody
seemed to care.
Removed:
httpd/httpd/branches/2.2.x/docs/manual/faq/all_in_one.html
httpd/httpd/branches/2.2.x/docs/manual/faq/all_in_one.html.en
httpd/httpd/branches/2.2.x/docs/manual/faq/all_in_one.html.ja.euc-jp
httpd/httpd/branches/2.2.x/docs/manual/faq/all_in_one.html.ko.euc-kr
httpd/httpd/branches/2.2.x/docs/manual/faq/all_in_one.xml
httpd/httpd/branches/2.2.x/docs/manual/faq/all_in_one.xml.ja
httpd/httpd/branches/2.2.x/docs/manual/faq/all_in_one.xml.ko
httpd/httpd/branches/2.2.x/docs/manual/faq/all_in_one.xml.meta
httpd/httpd/branches/2.2.x/docs/manual/faq/background.html
httpd/httpd/branches/2.2.x/docs/manual/faq/background.html.en
httpd/httpd/branches/2.2.x/docs/manual/faq/background.xml
httpd/httpd/branches/2.2.x/docs/manual/faq/background.xml.meta
httpd/httpd/branches/2.2.x/docs/manual/faq/categories.xml
httpd/httpd/branches/2.2.x/docs/manual/faq/categories.xml.ja
httpd/httpd/branches/2.2.x/docs/manual/faq/categories.xml.ko
httpd/httpd/branches/2.2.x/docs/manual/faq/error.html
httpd/httpd/branches/2.2.x/docs/manual/faq/error.html.en
httpd/httpd/branches/2.2.x/docs/manual/faq/error.html.ja.euc-jp
httpd/httpd/branches/2.2.x/docs/manual/faq/error.html.ko.euc-kr
httpd/httpd/branches/2.2.x/docs/manual/faq/error.xml
httpd/httpd/branches/2.2.x/docs/manual/faq/error.xml.ja
httpd/httpd/branches/2.2.x/docs/manual/faq/error.xml.ko
httpd/httpd/branches/2.2.x/docs/manual/faq/error.xml.meta
httpd/httpd/branches/2.2.x/docs/manual/faq/index.html.ja.euc-jp
httpd/httpd/branches/2.2.x/docs/manual/faq/index.html.ko.euc-kr
httpd/httpd/branches/2.2.x/docs/manual/faq/index.xml.ja
httpd/httpd/branches/2.2.x/docs/manual/faq/index.xml.ko
httpd/httpd/branches/2.2.x/docs/manual/faq/support.html
httpd/httpd/branches/2.2.x/docs/manual/faq/support.html.en
httpd/httpd/branches/2.2.x/docs/manual/faq/support.html.ja.euc-jp
httpd/httpd/branches/2.2.x/docs/manual/faq/support.html.ko.euc-kr
httpd/httpd/branches/2.2.x/docs/manual/faq/support.xml
httpd/httpd/branches/2.2.x/docs/manual/faq/support.xml.ja
httpd/httpd/branches/2.2.x/docs/manual/faq/support.xml.ko
httpd/httpd/branches/2.2.x/docs/manual/faq/support.xml.meta
Modified:
httpd/httpd/branches/2.2.x/docs/manual/faq/index.html
httpd/httpd/branches/2.2.x/docs/manual/faq/index.html.en
httpd/httpd/branches/2.2.x/docs/manual/faq/index.xml
httpd/httpd/branches/2.2.x/docs/manual/faq/index.xml.meta
Modified: httpd/httpd/branches/2.2.x/docs/manual/faq/index.html
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/faq/index.html?view=diff&rev=535267&r1=535266&r2=535267
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/faq/index.html (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/faq/index.html Fri May 4 07:45:52 2007
@@ -1,11 +1,3 @@
URI: index.html.en
Content-Language: en
Content-type: text/html; charset=ISO-8859-1
-
-URI: index.html.ja.euc-jp
-Content-Language: ja
-Content-type: text/html; charset=EUC-JP
-
-URI: index.html.ko.euc-kr
-Content-Language: ko
-Content-type: text/html; charset=EUC-KR
Modified: httpd/httpd/branches/2.2.x/docs/manual/faq/index.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/faq/index.html.en?view=diff&rev=535267&r1=535266&r2=535267
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/faq/index.html.en (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/faq/index.html.en Fri May 4 07:45:52 2007
@@ -10,7 +10,7 @@
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
-<body id="manual-page" class="no-sidebar"><div id="page-header">
+<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.2</p>
<img alt="" src="../images/feather.gif" /></div>
@@ -18,31 +18,88 @@
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.2</a></div><div id="page-content"><div id="preamble"><h1>Frequently Asked Questions</h1>
<div class="toplang">
-<p><span>Available Languages: </span><a href="../en/faq/" title="English"> en </a> |
-<a href="../ja/faq/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
-<a href="../ko/faq/" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+<p><span>Available Languages: </span><a href="../en/faq/" title="English"> en </a></p>
</div>
- <p>The latest version of this FAQ is always available from the
- main Apache web site, at <<a href="http://httpd.apache.org/docs/2.2/faq/">http://httpd.apache.org/docs/2.2/faq/</a>>. In addition, you
- can view this FAQ <a href="all_in_one.html">all in one page</a> for easy
- searching and printing.</p>
-
- <p>If you don't find the answer to your question in the below
- sections, please also consult the <a href="http://httpd.apache.org/docs/misc/FAQ.html">Apache 1.3
- FAQ</a> to see if your question is answered there.</p>
+ <p>This document is not a traditional FAQ, but rather a quick
+ guide showing you what to do when you run into problems with the
+ Apache HTTP Server.</p>
+
+ <p>A more traditional but quite outdated document is the <a href="http://httpd.apache.org/docs/misc/FAQ.html">Apache 1.3
+ FAQ</a>.</p>
</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#support.what2do">"Why can't I ...? Why won't ... work?" What to do in case of
+ problems</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#support.support">Whom do I contact for support?</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="background.html">Background</a></dt><dd>Background information about the Apache HTTP Server.</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>
+<h2><a name="support.what2do" id="support.what2do">"Why can't I ...? Why won't ... work?" What to do in case of
+ problems</a></h2>
+
+
+ <p>If you are having trouble with your Apache server software, you should
+ take the following steps:</p>
+
+ <dl>
+ <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 and fix
+ the problem yourself (such as file permissions or the like). The default
+ location of the error log is
+ <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>Consult the wiki</dt>
+ <dd>The <a href="http://wiki.apache.org/httpd/">Apache HTTP
+ Server Wiki</a> contains guides to solving many common
+ problems.</dd>
+
+ <dt>Check the Apache bug database</dt> <dd>Most problems that
+ get reported to The Apache Group are recorded in the <a href="http://httpd.apache.org/bug_report.html">bug database</a>.
+ <strong>Do not</strong> submit a new bug report until you have
+ checked existing reports (open <em>and</em> closed) and asked
+ about your problem in a user-support forum (see below). If you
+ find that your issue has already been reported, please
+ <em>don't</em> add a "me, too" report.</dd>
+
+ <dt><a id="support.what2do.user-support" name="support.what2do.user-support">Ask in a user support forum</a></dt>
+ <dd><p>Apache has an active community of users who are willing to share
+ their knowledge. Participating in this community is usually the best and
+ fastest way to get answers to your questions and problems.</p>
+
+ <p><a href="http://httpd.apache.org/userslist.html">Users
+ mailing list</a></p>
+
+ <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 <a href="http://httpd.apache.org/dev/debugging.html">
+ include a backtrace</a> (if possible).</p>
+ </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="support.support" id="support.support">Whom do I contact for support?</a></h2>
+ <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 user forum (see above).</p>
+
+ <p>Professional, commercial support for Apache is available from
+ a number of companies.</p>
+ </div></div>
<div class="bottomlang">
-<p><span>Available Languages: </span><a href="../en/faq/" title="English"> en </a> |
-<a href="../ja/faq/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
-<a href="../ko/faq/" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+<p><span>Available Languages: </span><a href="../en/faq/" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
Modified: httpd/httpd/branches/2.2.x/docs/manual/faq/index.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/faq/index.xml?view=diff&rev=535267&r1=535266&r2=535267
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/faq/index.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/faq/index.xml Fri May 4 07:45:52 2007
@@ -1,7 +1,5 @@
-<?xml version="1.0" encoding="UTF-8" ?>
-<!DOCTYPE faq SYSTEM "../style/faq.dtd" [
- <!ENTITY categories SYSTEM "categories.xml">
-]>
+<?xml version='1.0' encoding='UTF-8' ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
<!-- $LastChangedRevision$ -->
@@ -22,26 +20,88 @@
limitations under the License.
-->
-<faq metafile="index.xml.meta">
-<parentdocument href="../" />
+<manualpage metafile="index.xml.meta">
+<parentdocument href="../"/>
<title>Frequently Asked Questions</title>
<summary>
- <p>The latest version of this FAQ is always available from the
- main Apache web site, at <<a
- href="http://httpd.apache.org/docs/&httpd.docs;/faq/"
- >http://httpd.apache.org/docs/&httpd.docs;/faq/</a>>. In addition, you
- can view this FAQ <a href="all_in_one.html">all in one page</a> for easy
- searching and printing.</p>
+ <p>This document is not a traditional FAQ, but rather a quick
+ guide showing you what to do when you run into problems with the
+ Apache HTTP Server.</p>
- <p>If you don't find the answer to your question in the below
- sections, please also consult the <a
+ <p>A more traditional but quite outdated document is the <a
href="http://httpd.apache.org/docs/misc/FAQ.html">Apache 1.3
- FAQ</a> to see if your question is answered there.</p>
+ FAQ</a>.</p>
</summary>
-&categories;
-
-</faq>
+ <section id="support.what2do">
+ <title>"Why can't I ...? Why won't ... work?" What to do in case of
+ problems</title>
+
+ <p>If you are having trouble with your Apache server software, you should
+ take the following steps:</p>
+
+ <dl>
+ <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 and fix
+ the problem yourself (such as file permissions or the like). The default
+ location of the error log is
+ <code>/usr/local/apache2/logs/error_log</code>, but see the <directive
+ module="core">ErrorLog</directive> directive in your config files for the
+ location on your server.</dd>
+
+ <dt>Consult the wiki</dt>
+ <dd>The <a href="http://wiki.apache.org/httpd/">Apache HTTP
+ Server Wiki</a> contains guides to solving many common
+ problems.</dd>
+
+ <dt>Check the Apache bug database</dt> <dd>Most problems that
+ get reported to The Apache Group are recorded in the <a
+ href="http://httpd.apache.org/bug_report.html">bug database</a>.
+ <strong>Do not</strong> submit a new bug report until you have
+ checked existing reports (open <em>and</em> closed) and asked
+ about your problem in a user-support forum (see below). If you
+ find that your issue has already been reported, please
+ <em>don't</em> add a "me, too" report.</dd>
+
+ <dt><a id="support.what2do.user-support"
+ name="support.what2do.user-support">Ask in a user support forum</a></dt>
+ <dd><p>Apache has an active community of users who are willing to share
+ their knowledge. Participating in this community is usually the best and
+ fastest way to get answers to your questions and problems.</p>
+
+ <p><a href="http://httpd.apache.org/userslist.html">Users
+ mailing list</a></p>
+
+ <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 <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 millions of users and fewer than sixty volunteer developers,
+ we cannot provide personal support for Apache. For free support, we
+ suggest participating in a user forum (see above).</p>
+
+ <p>Professional, commercial support for Apache is available from
+ a number of companies.</p>
+ </section>
+</manualpage>
\ No newline at end of file
Modified: httpd/httpd/branches/2.2.x/docs/manual/faq/index.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/faq/index.xml.meta?view=diff&rev=535267&r1=535266&r2=535267
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/faq/index.xml.meta (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/faq/index.xml.meta Fri May 4 07:45:52 2007
@@ -7,7 +7,5 @@
<variants>
<variant>en</variant>
- <variant outdated="yes">ja</variant>
- <variant outdated="yes">ko</variant>
</variants>
</metafile>