httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From n.@apache.org
Subject cvs commit: httpd-2.0/docs/manual/style/xsl faq.xsl common.xsl
Date Wed, 16 Apr 2003 22:39:38 GMT
nd          2003/04/16 15:39:37

  Modified:    docs/manual/faq all_in_one.html.en
               docs/manual/style/xsl common.xsl
  Added:       docs/manual/faq all_in_one.xml all_in_one.xml.meta
                        categories.xml index.html.en index.xml
                        index.xml.meta support.html.en support.xml
                        support.xml.meta
               docs/manual/style faq.dtd
               docs/manual/style/xsl faq.xsl
  Removed:     docs/manual/faq index.html support.html
  Log:
  the faq html/ssi format bites me all the time.
  Add initial xml/xsl version of the faq data.
  
  (includes a build.xml/deps.xml update)
  
  Revision  Changes    Path
  1.2       +138 -40   httpd-2.0/docs/manual/faq/all_in_one.html.en
  
  Index: all_in_one.html.en
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/faq/all_in_one.html.en,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- all_in_one.html.en	16 Apr 2003 02:03:36 -0000	1.1
  +++ all_in_one.html.en	16 Apr 2003 22:39:34 -0000	1.2
  @@ -1,41 +1,139 @@
  -<!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>
  -
  -    <h2>Categories</h2>
  -    <dl>
  -      <dt><a href="#support.html">Support</a></dt>
  -
  -      <dd>What do I do when I have problems?</dd>
  -    </dl>
  -    <hr />
  -    <!--#set var="ONEPAGE" value="YES" -->
  -    <!--#include virtual="support.html" -->
  -
  -    <!--#include virtual="footer.html" -->
  -  </body>
  -</html>
  -
  +</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>
  +
  +      <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
  
  
  
  1.1                  httpd-2.0/docs/manual/faq/all_in_one.xml
  
  Index: all_in_one.xml
  ===================================================================
  <?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>
  
  
  
  
  1.1                  httpd-2.0/docs/manual/faq/all_in_one.xml.meta
  
  Index: all_in_one.xml.meta
  ===================================================================
  <?xml version="1.0" encoding="UTF-8" ?>
  
  <metafile>
    <basename>all_in_one</basename>
    <path>/faq/</path>
    <relpath>..</relpath>
  
    <variants>
      <variant>en</variant>
    </variants>
  </metafile>
  
  
  
  1.1                  httpd-2.0/docs/manual/faq/categories.xml
  
  Index: categories.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8" ?>
  
  <categories>
    <categoryfile>support.xml</categoryfile>
  </categories>
  
  
  
  1.1                  httpd-2.0/docs/manual/faq/index.html.en
  
  Index: index.html.en
  ===================================================================
  <?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>
  
  
  1.1                  httpd-2.0/docs/manual/faq/index.xml
  
  Index: index.xml
  ===================================================================
  <?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>
  
  
  
  
  1.1                  httpd-2.0/docs/manual/faq/index.xml.meta
  
  Index: index.xml.meta
  ===================================================================
  <?xml version="1.0" encoding="UTF-8" ?>
  
  <metafile>
    <basename>index</basename>
    <path>/faq/</path>
    <relpath>..</relpath>
  
    <variants>
      <variant>en</variant>
    </variants>
  </metafile>
  
  
  
  1.1                  httpd-2.0/docs/manual/faq/support.html.en
  
  Index: support.html.en
  ===================================================================
  <?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>
  
  
  1.1                  httpd-2.0/docs/manual/faq/support.xml
  
  Index: support.xml
  ===================================================================
  <?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>
  
  
  
  
  1.1                  httpd-2.0/docs/manual/faq/support.xml.meta
  
  Index: support.xml.meta
  ===================================================================
  <?xml version="1.0" encoding="UTF-8" ?>
  
  <metafile>
    <basename>support</basename>
    <path>/faq/</path>
    <relpath>..</relpath>
  
    <variants>
      <variant>en</variant>
    </variants>
  </metafile>
  
  
  
  1.1                  httpd-2.0/docs/manual/style/faq.dtd
  
  Index: faq.dtd
  ===================================================================
  <?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;>
  
  
  
  1.28      +1 -0      httpd-2.0/docs/manual/style/xsl/common.xsl
  
  Index: common.xsl
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/style/xsl/common.xsl,v
  retrieving revision 1.27
  retrieving revision 1.28
  diff -u -r1.27 -r1.28
  --- common.xsl	14 Apr 2003 17:50:49 -0000	1.27
  +++ common.xsl	16 Apr 2003 22:39:36 -0000	1.28
  @@ -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
  
  
  
  1.1                  httpd-2.0/docs/manual/style/xsl/faq.xsl
  
  Index: faq.xsl
  ===================================================================
  <?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>
  
  
  

Mime
View raw message