]> git.ipfire.org Git - thirdparty/apache/httpd.git/commitdiff
the faq html/ssi format bites me all the time.
authorAndré Malo <nd@apache.org>
Wed, 16 Apr 2003 22:39:37 +0000 (22:39 +0000)
committerAndré Malo <nd@apache.org>
Wed, 16 Apr 2003 22:39:37 +0000 (22:39 +0000)
Add initial xml/xsl version of the faq data.

(includes a build.xml/deps.xml update)

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

15 files changed:
docs/manual/faq/all_in_one.html.en
docs/manual/faq/all_in_one.xml [new file with mode: 0644]
docs/manual/faq/all_in_one.xml.meta [new file with mode: 0644]
docs/manual/faq/categories.xml [new file with mode: 0644]
docs/manual/faq/index.html [deleted file]
docs/manual/faq/index.html.en [new file with mode: 0644]
docs/manual/faq/index.xml [new file with mode: 0644]
docs/manual/faq/index.xml.meta [new file with mode: 0644]
docs/manual/faq/support.html [deleted file]
docs/manual/faq/support.html.en [new file with mode: 0644]
docs/manual/faq/support.xml [new file with mode: 0644]
docs/manual/faq/support.xml.meta [new file with mode: 0644]
docs/manual/style/faq.dtd [new file with mode: 0644]
docs/manual/style/xsl/common.xsl
docs/manual/style/xsl/faq.xsl [new file with mode: 0644]

index c6d3e8b9c56252faa15fa23e833d8d26e388a1d7..64d49dcfc3469bafef0f68859ae536386707c18c 100644 (file)
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta name="generator" content="HTML Tidy, see www.w3.org" />
-
-    <title>Apache Server Frequently Asked Questions</title>
-  </head>
-
-  <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
-  vlink="#000080" alink="#FF0000">
-    <!--#include virtual="header.html" -->
-
-    <h1 align="center">Frequently Asked Questions</h1>
-
-    <p>The latest version of this FAQ is always available from the
-    main Apache web site, at &lt;<a
-    href="http://httpd.apache.org/docs-2.1/faq/"
-    rel="Help"><samp>http://httpd.apache.org/docs-2.1/faq/</samp></a>&gt;.
-    </p>
-
-    <p>Since Apache 2.0 is very new, we don't yet know what the
-    <em>Frequently Asked Questions</em> will be. While this section
-    fills up, you should also consult the <a
-    href="http://httpd.apache.org/docs/misc/FAQ.html">Apache 1.3
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+              This file is generated from xml source: DO NOT EDIT
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+      -->
+<title>Frequently Asked Questions - Apache HTTP Server</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<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"><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.1</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.1</a> &gt; <a href="./">FAQ</a></div><div id="page-content"><div id="preamble"><h1>Frequently Asked Questions</h1>
+    <p>The latest version of this FAQ is always available from the main Apache
+    web site, at &lt;<a href="http://httpd.apache.org/docs-2.1/faq/">http://httpd.apache.org/docs-2.1/faq/</a>&gt;.</p>
+
+    <p>Since Apache 2.0 is quite new, we don't yet know what the <em>Frequently
+    Asked Questions</em> will be. While this section fills up, you should 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>
+</div>
+<div id="quickview"><ul id="toc"><li><a href="#topics">Topics</a></li>
+<li><a href="#support">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="#support">Support</a></dt><dd>What do I do when I have problems?</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" id="support">Support</a></h2>
+    <ul>
+    <li><a href="#support.what2do">"Why can't I ...? Why won't ... work?" What
+    to do in case of problems</a></li>
+
+    <li><a href="#support.support">Whom do I contact for support?</a></li>
+    </ul>
+
+    <h3><a name="support.what2do" id="support.what2do">"Why can't I ...? Why won't ... work?" What to do in case of
+    problems</a></h3>
+    
+
+      <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 messages to the
+      server error log. Sometimes this is enough for you to diagnose &amp; 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>Check the <a href="http://httpd.apache.org/docs-2.1/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>
+
+      <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>Please</strong> check the existing reports, open
+      <strong>and</strong> closed, before adding one. If you find that your
+      issue has already been reported, please <em>don't</em> add a "me, too"
+      report. If the original report isn't closed yet, we suggest that you
+      check it periodically. You might also consider contacting the original
+      submitter, because there may be an email exchange going on about the
+      issue that isn't getting recorded in the database.</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>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>
+      <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>
 
-    <h2>Categories</h2>
-    <dl>
-      <dt><a href="#support.html">Support</a></dt>
+      <div class="example"><p><code>
+        # cd <var>ServerRoot</var><br />
+        # dbx <var>httpd</var> <var>core</var><br />
+        (dbx) where
+      </code></p></div>
 
-      <dd>What do I do when I have problems?</dd>
-    </dl>
-    <hr />
-    <!--#set var="ONEPAGE" value="YES" -->
-    <!--#include virtual="support.html" -->
+      <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>
+      </dd>
+      </dl>
+    
 
-    <!--#include virtual="footer.html" -->
-  </body>
-</html>
+    <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,
+      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>
 
+      <p>Professional, commercial support for Apache is available from
+      <a href="http://www.apache.org/info/support.cgi">a number of
+      companies</a>.</p>
+    
+</div></div>
+<div id="footer">
+<p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</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>
+</body></html>
\ No newline at end of file
diff --git a/docs/manual/faq/all_in_one.xml b/docs/manual/faq/all_in_one.xml
new file mode 100644 (file)
index 0000000..621685d
--- /dev/null
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE faq SYSTEM "../style/faq.dtd" [
+    <!ENTITY categories SYSTEM "categories.xml">
+]>
+<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
+
+<faq metafile="all_in_one.xml.meta" all-in-one="yes">
+<parentdocument href="./">FAQ</parentdocument>
+
+<title>Frequently Asked Questions</title>
+
+<summary>
+    <p>The latest version of this FAQ is always available from the main Apache
+    web site, at &lt;<a href="http://httpd.apache.org/docs-2.1/faq/"
+    >http://httpd.apache.org/docs-2.1/faq/</a>&gt;.</p>
+
+    <p>Since Apache 2.0 is quite new, we don't yet know what the <em>Frequently
+    Asked Questions</em> will be. While this section fills up, you should 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>
+</summary>
+
+&categories;
+
+</faq>
+
diff --git a/docs/manual/faq/all_in_one.xml.meta b/docs/manual/faq/all_in_one.xml.meta
new file mode 100644 (file)
index 0000000..d6afea7
--- /dev/null
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<metafile>
+  <basename>all_in_one</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
new file mode 100644 (file)
index 0000000..7feb6b7
--- /dev/null
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<categories>
+  <categoryfile>support.xml</categoryfile>
+</categories>
diff --git a/docs/manual/faq/index.html b/docs/manual/faq/index.html
deleted file mode 100644 (file)
index 5a9e298..0000000
+++ /dev/null
@@ -1,44 +0,0 @@
-<!--#if expr="$QUERY_STRING = ONEPAGE"
---><!--#include virtual="all_in_one.html.en" --><!--#else
--->
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta name="generator" content="HTML Tidy, see www.w3.org" />
-
-    <title>Apache Server Frequently Asked Questions</title>
-  </head>
-
-  <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
-  vlink="#000080" alink="#FF0000">
-    <!--#include virtual="header.html" -->
-
-    <h1 align="center">Frequently Asked Questions</h1>
-
-    <p>The latest version of this FAQ is always available from the
-    main Apache web site, at &lt;<a
-    href="http://httpd.apache.org/docs-2.1/faq/"
-    rel="Help"><samp>http://httpd.apache.org/docs-2.1/faq/</samp></a>&gt;.
-    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>Since Apache 2.0 is very new, we don't yet know what the
-    <em>Frequently Asked Questions</em> will be. While this section
-    fills up, you should 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>
-
-    <h2>Categories</h2>
-
-    <dl>
-      <dt><a href="support.html">Support</a></dt>
-
-      <dd>What do I do when I have problems?</dd>
-    </dl>
-    <!--#include virtual="footer.html" -->
-  </body>
-</html><!--#endif -->
diff --git a/docs/manual/faq/index.html.en b/docs/manual/faq/index.html.en
new file mode 100644 (file)
index 0000000..4c0f369
--- /dev/null
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+              This file is generated from xml source: DO NOT EDIT
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+      -->
+<title>Frequently Asked Questions - Apache HTTP Server</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<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">
+<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.1</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="../"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.1</a></div><div id="page-content"><div id="preamble"><h1>Frequently Asked Questions</h1>
+    <p>The latest version of this FAQ is always available from the
+    main Apache web site, at &lt;<a href="http://httpd.apache.org/docs-2.1/faq/">http://httpd.apache.org/docs-2.1/faq/</a>&gt;. 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>Since Apache 2.0 is quite new, we don't yet know what the
+    <em>Frequently Asked Questions</em> will be. While this section fills up,
+    you should 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>
+</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.html">Support</a></dt><dd>What do I do when I have problems?</dd>
+</dl></div></div>
+<div id="footer">
+<p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</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>
+</body></html>
\ No newline at end of file
diff --git a/docs/manual/faq/index.xml b/docs/manual/faq/index.xml
new file mode 100644 (file)
index 0000000..93c65b4
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE faq SYSTEM "../style/faq.dtd" [
+    <!ENTITY categories SYSTEM "categories.xml">
+]>
+<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
+
+<faq 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 &lt;<a href="http://httpd.apache.org/docs-2.1/faq/"
+    >http://httpd.apache.org/docs-2.1/faq/</a>&gt;. 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>Since Apache 2.0 is quite new, we don't yet know what the
+    <em>Frequently Asked Questions</em> will be. While this section fills up,
+    you should 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>
+</summary>
+
+&categories;
+
+</faq>
+
diff --git a/docs/manual/faq/index.xml.meta b/docs/manual/faq/index.xml.meta
new file mode 100644 (file)
index 0000000..0811f3b
--- /dev/null
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<metafile>
+  <basename>index</basename>
+  <path>/faq/</path>
+  <relpath>..</relpath>
+
+  <variants>
+    <variant>en</variant>
+  </variants>
+</metafile>
diff --git a/docs/manual/faq/support.html b/docs/manual/faq/support.html
deleted file mode 100644 (file)
index d29f25e..0000000
+++ /dev/null
@@ -1,160 +0,0 @@
-<!--#if expr="!$ONEPAGE" -->
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta name="generator" content="HTML Tidy, see www.w3.org" />
-
-    <title>Support - Apache Server Frequently Asked
-    Questions</title>
-  </head>
-  <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
-
-  <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
-  vlink="#000080" alink="#FF0000">
-    <!--#include virtual="header.html" -->
-
-    <h1 align="center">Frequently Asked Questions</h1>
-    <!--#endif -->
-
-    <h2><a id="support.html" name="support.html">Support</a></h2>
-
-    <ul>
-      <li><a href="#what2do">"Why can't I ...? Why won't ... work?"
-      What to do in case of problems</a></li>
-
-      <li><a href="#support">Whom do I contact for
-      support?</a></li>
-    </ul>
-    <hr />
-
-    <h3><a id="what2do" name="what2do">"Why can't I ...? Why won't
-    ... work?" What to do in case of problems</a></h3>
-
-    <p>If you are having trouble with your Apache server software,
-    you should take the following steps:</p>
-
-    <ol>
-      <li>
-        <strong>Check the errorlog!</strong> 
-
-        <p>Apache tries to be helpful when it encounters a problem.
-        In many cases, it will provide some details by writing one
-        or messages to the server error log. Sometimes this is
-        enough for you to diagnose &amp; fix the problem yourself
-        (such as file permissions or the like). The default
-        location of the error log is
-        <samp>/usr/local/apache2/logs/error_log</samp>, but see the
-        <a
-        href="../mod/core.html#errorlog"><samp>ErrorLog</samp></a>
-        directive in your config files for the location on your
-        server.</p>
-      </li>
-
-      <li>
-        <strong>Check the <a
-        href="http://httpd.apache.org/docs-2.1/faq/">FAQ</a>!</strong>
-        
-
-        <p>The latest version of the Apache Frequently-Asked
-        Questions list can always be found at the main Apache web
-        site.</p>
-      </li>
-
-      <li>
-        <strong>Check the Apache bug database</strong> 
-
-        <p>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>. <em><strong>Please</strong> check the
-        existing reports, open <strong>and</strong> closed, before
-        adding one.</em> If you find that your issue has already
-        been reported, please <em>don't</em> add a "me, too"
-        report. If the original report isn't closed yet, we suggest
-        that you check it periodically. You might also consider
-        contacting the original submitter, because there may be an
-        email exchange going on about the issue that isn't getting
-        recorded in the database.</p>
-      </li>
-
-      <li>
-        <strong><a id="user-support" name="user-support">Ask in a
-        user support forum</a></strong> 
-
-        <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>USENET newsgroups:</p>
-
-        <ul>
-          <li>comp.infosystems.www.servers.unix [<a
-          href="news:comp.infosystems.www.servers.unix">nntp</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">nntp</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>
-      </li>
-
-      <li>
-        <strong>If all else fails, report the problem in the bug
-        database</strong> 
-
-        <p>If you've gone through those steps above that are
-        appropriate and have obtained no relief, then please
-        <em>do</em> let The Apache Group 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>
-
-        <dl>
-          <dd><code># cd <em>ServerRoot</em><br />
-           # dbx httpd core<br />
-           (dbx) where</code></dd>
-        </dl>
-
-        <p>(Substitute the appropriate locations for your
-        <samp>ServerRoot</samp> and your <samp>httpd</samp> and
-        <samp>core</samp> files. You may have to use
-        <code>gdb</code> instead of <code>dbx</code>.)</p>
-      </li>
-    </ol>
-    <hr />
-
-    <h3><a id="support" name="support">Whom do I contact for
-    support?</a></h3>
-
-    <p>With several million users and fewer than forty volunteer
-    developers, we cannot provide personal support for Apache. For
-    free support, we suggest participating in a <a
-    href="#user-support">user forum</a>.</p>
-
-    <p>Professional, commercial support for Apache is available
-    from <a href="http://www.apache.org/info/support.cgi">a number
-    of companies</a>.</p>
-    <!--#if expr="!$ONEPAGE" -->
-    <!--#include virtual="footer.html" -->
-  </body>
-</html>
-    <!--#endif -->
-
diff --git a/docs/manual/faq/support.html.en b/docs/manual/faq/support.html.en
new file mode 100644 (file)
index 0000000..64f2bde
--- /dev/null
@@ -0,0 +1,124 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+              This file is generated from xml source: DO NOT EDIT
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+      -->
+<title>Support - Frequently Asked Questions - Apache HTTP Server</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<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">
+<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.1</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.1</a> &gt; <a href="./">FAQ</a></div><div id="page-content"><div id="preamble"><h1>Support - Frequently Asked Questions</h1></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
+    to do in case of problems</a></li>
+
+    <li><a href="#support.support">Whom do I contact for support?</a></li>
+    </ul>
+
+    <h3><a name="support.what2do" id="support.what2do">"Why can't I ...? Why won't ... work?" What to do in case of
+    problems</a></h3>
+    
+
+      <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 messages to the
+      server error log. Sometimes this is enough for you to diagnose &amp; 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>Check the <a href="http://httpd.apache.org/docs-2.1/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>
+
+      <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>Please</strong> check the existing reports, open
+      <strong>and</strong> closed, before adding one. If you find that your
+      issue has already been reported, please <em>don't</em> add a "me, too"
+      report. If the original report isn't closed yet, we suggest that you
+      check it periodically. You might also consider contacting the original
+      submitter, because there may be an email exchange going on about the
+      issue that isn't getting recorded in the database.</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>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>
+      <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>
+      </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,
+      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>
+
+      <p>Professional, commercial support for Apache is available from
+      <a href="http://www.apache.org/info/support.cgi">a number of
+      companies</a>.</p>
+    
+</div></div>
+<div id="footer">
+<p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</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>
+</body></html>
\ No newline at end of file
diff --git a/docs/manual/faq/support.xml b/docs/manual/faq/support.xml
new file mode 100644 (file)
index 0000000..c2b3c82
--- /dev/null
@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE faq SYSTEM "../style/faq.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
+
+<faq metafile="support.xml.meta">
+<parentdocument href="./">FAQ</parentdocument>
+
+<title>Support - Frequently Asked Questions</title>
+<description>What do I do when I have problems?</description>
+
+<section id="support"><title>Support</title>
+    <ul>
+    <li><a href="#support.what2do">"Why can't I ...? Why won't ... work?" What
+    to do in case of problems</a></li>
+
+    <li><a href="#support.support">Whom do I contact for support?</a></li>
+    </ul>
+
+    <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 messages to the
+      server error log. Sometimes this is enough for you to diagnose &amp; 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>Check the <a
+      href="http://httpd.apache.org/docs-2.1/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>
+
+      <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>Please</strong> check the existing reports, open
+      <strong>and</strong> closed, before adding one. If you find that your
+      issue has already been reported, please <em>don't</em> add a "me, too"
+      report. If the original report isn't closed yet, we suggest that you
+      check it periodically. You might also consider contacting the original
+      submitter, because there may be an email exchange going on about the
+      issue that isn't getting recorded in the database.</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>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>
+      <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>
+
+      <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>
+      </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,
+      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>
+
+      <p>Professional, commercial support for Apache is available from
+      <a href="http://www.apache.org/info/support.cgi">a number of
+      companies</a>.</p>
+    </section>
+</section>
+
+</faq>
+
diff --git a/docs/manual/faq/support.xml.meta b/docs/manual/faq/support.xml.meta
new file mode 100644 (file)
index 0000000..bc67d1c
--- /dev/null
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<metafile>
+  <basename>support</basename>
+  <path>/faq/</path>
+  <relpath>..</relpath>
+
+  <variants>
+    <variant>en</variant>
+  </variants>
+</metafile>
diff --git a/docs/manual/style/faq.dtd b/docs/manual/style/faq.dtd
new file mode 100644 (file)
index 0000000..6d11d5c
--- /dev/null
@@ -0,0 +1,18 @@
+<?xml version='1.0' encoding='UTF-8' ?>
+
+<!ENTITY % common SYSTEM "common.dtd">
+%common;
+
+<!-- <faq> is the root element -->
+<!ELEMENT faq (parentdocument?, title, description?, summary?,
+seealso*, (section | categories))>
+
+<!ATTLIST faq metafile   CDATA        #REQUIRED
+              all-in-one (yes | no ) "no"
+>
+
+<!ELEMENT categories (categoryfile*)>
+
+<!ELEMENT categoryfile (#PCDATA)>
+
+<!ELEMENT description %Inline;>
index 72ef306685fac3effd2b422b6cefa69a5a2f5125..2b2528fb96b393a0c98c1b5b3e6b79122159f052 100644 (file)
@@ -34,6 +34,7 @@
   <xsl:include href="sitemap.xsl"/>
   <xsl:include href="indexpage.xsl"/>
   <xsl:include href="quickreference.xsl"/>
+  <xsl:include href="faq.xsl"/>
 
   <!-- make sure, we set relative anchors
        only, if we're actually transforming
diff --git a/docs/manual/style/xsl/faq.xsl b/docs/manual/style/xsl/faq.xsl
new file mode 100644 (file)
index 0000000..ebcc68a
--- /dev/null
@@ -0,0 +1,179 @@
+<?xml version="1.0"?>
+<!DOCTYPE xsl:stylesheet [
+    <!ENTITY nbsp SYSTEM "util/nbsp.xml">
+]>
+<xsl:stylesheet version="1.0"
+              xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                  xmlns="http://www.w3.org/1999/xhtml">
+
+  <!--                                                    -->
+  <!-- <manualpage>                                       -->
+  <!-- Process an entire document into an HTML page       -->
+  <!--                                                    -->
+  <xsl:template match="faq">
+    <html xml:lang="{$messages/@lang}" lang="{$messages/@lang}">
+      <xsl:call-template name="head"/>
+
+<xsl:text>
+</xsl:text> <!-- insert line break -->
+
+      <body id="manual-page">
+        <!-- unsqueeze if there's no sidebar -->
+        <xsl:if test="not(count(section) > 1 or (/faq/@all-in-one = 'yes') or seealso)">
+          <xsl:attribute name="class">no-sidebar</xsl:attribute>
+        </xsl:if>
+
+        <xsl:call-template name="top"/>          
+
+        <div id="page-content">
+          <div id="preamble">        
+            <h1>
+              <xsl:value-of select="title"/>
+            </h1>
+
+            <xsl:apply-templates select="summary"/>
+          </div> <!-- /preamble -->
+          
+<xsl:text>
+</xsl:text> <!-- insert line break -->
+
+          <xsl:if test="count(section) > 1 or (/faq/@all-in-one = 'yes') or seealso">
+            <div id="quickview">
+              <xsl:if test="count(section) > 1">
+                <ul id="toc">
+                  <xsl:apply-templates select="section" mode="index"/>
+                </ul>
+              </xsl:if>
+
+              <xsl:if test="/faq/@all-in-one = 'yes'">
+                <ul id="toc">
+                  <li>
+                    <a href="#topics">
+                      <xsl:value-of select="$messages/message[@name='topics']"/>
+                    </a>
+                  </li>
+
+<xsl:text>
+</xsl:text>
+
+                  <xsl:apply-templates select="categories/categoryfile" mode="toc"/>
+                </ul>
+              </xsl:if>
+
+              <xsl:if test="seealso">
+                <h3>
+                  <xsl:value-of select="$messages/message[@name='seealso']"/>
+                </h3>
+                <ul class="seealso">
+                  <xsl:for-each select="seealso">
+                    <li>
+                      <xsl:apply-templates/>
+                    </li>
+                  </xsl:for-each>
+                </ul>
+              </xsl:if>
+
+           </div> <!-- /quickview -->
+
+<xsl:text>
+</xsl:text> <!-- insert line break -->
+
+          </xsl:if>
+
+          <!-- either one ... -->
+          <xsl:apply-templates select="section"/>
+          <!-- ... or the other is allowed -->
+          <xsl:apply-templates select="categories"/>
+        </div> <!-- /page-content -->
+
+<xsl:text>
+</xsl:text> <!-- insert line break -->
+
+        <xsl:call-template name="bottom"/>
+
+<xsl:text>
+</xsl:text> <!-- insert line break -->
+
+      </body>
+    </html>
+  </xsl:template>
+
+  <xsl:template match="categories">
+
+    <xsl:call-template name="toplink"/>
+
+<xsl:text>
+</xsl:text> <!-- insert line break -->
+
+    <div class="section">
+
+<xsl:text>
+</xsl:text> <!-- insert line break -->
+
+      <!-- Section heading -->
+      <h2>
+        <a name="topics" id="topics">
+          <xsl:value-of select="$messages/message[@name='topics']"/>
+        </a>
+      </h2>
+
+<xsl:text>
+</xsl:text> <!-- insert line break -->
+
+      <dl>
+        <xsl:apply-templates select="categoryfile" mode="index"/>
+      </dl>
+    </div> <!-- /.section -->
+
+    <xsl:if test="/faq/@all-in-one = 'yes'">
+      <xsl:apply-templates select="categoryfile" mode="suckin"/>
+    </xsl:if>
+
+  </xsl:template>
+
+  <xsl:template match="categories/categoryfile" mode="index">
+    <xsl:variable name="current" select="document(.)/faq" />
+
+    <dt>
+      <a>
+        <xsl:attribute name="href"><xsl:choose>
+          <xsl:when test="/faq/@all-in-one = 'yes'">
+            <xsl:value-of select="concat('#', $current/section/@id)" />
+          </xsl:when>
+
+          <xsl:otherwise>
+            <xsl:value-of select="concat(document($current/@metafile)/metafile/basename, '.html')" />
+          </xsl:otherwise></xsl:choose>
+        </xsl:attribute>
+
+        <xsl:value-of select="$current/section/title" />
+      </a>
+    </dt>
+    <dd>
+      <xsl:apply-templates select="$current/description/node()" />
+    </dd>
+
+<xsl:text>
+</xsl:text>
+
+  </xsl:template>
+
+  <xsl:template match="categories/categoryfile" mode="toc">
+    <xsl:variable name="current" select="document(.)/faq" />
+
+    <li>
+      <a href="#{$current/section/@id}">
+        <xsl:value-of select="$current/section/title" />
+      </a>
+    </li>
+
+<xsl:text>
+</xsl:text>
+
+  </xsl:template>
+
+  <xsl:template match="categories/categoryfile" mode="suckin">
+    <xsl:apply-templates select="document(.)/faq/section" />
+  </xsl:template>
+
+</xsl:stylesheet>