Return-Path: 
 <cvs-return-12957-apmail-httpd-cvs-archive=httpd.apache.org@httpd.apache.org>
Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org
Received: (qmail 3863 invoked by uid 500); 25 Aug 2002 03:53:46 -0000
Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@httpd.apache.org
list-help: <mailto:cvs-help@httpd.apache.org>
list-unsubscribe: <mailto:cvs-unsubscribe@httpd.apache.org>
list-post: <mailto:cvs@httpd.apache.org>
Delivered-To: mailing list cvs@httpd.apache.org
Received: (qmail 3835 invoked by uid 500); 25 Aug 2002 03:53:45 -0000
Delivered-To: apmail-httpd-2.0-cvs@apache.org
Date: 25 Aug 2002 03:53:41 -0000
Message-ID: <20020825035341.60279.qmail@icarus.apache.org>
From: slive@apache.org
To: httpd-2.0-cvs@apache.org
Subject: cvs commit: httpd-2.0/docs/manual/mod mod_auth_dbm.xml
 mod_auth_dbm.html.en mod_rewrite.xml mod_rewrite.html.en
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

slive       2002/08/24 20:53:41

  Modified:    docs/manual install.xml install.html.en
               docs/manual/mod mod_auth_dbm.xml mod_auth_dbm.html.en
                        mod_rewrite.xml mod_rewrite.html.en
  Log:
  Add a little documentation on how to select DBMs during build
  and update the RerwiteMap and AuthDBMType directives to point
  to it.
  
  The build docs could still use a great deal of work.  There
  are tons of things that aren't documented at all.
  
  Revision  Changes    Path
  1.2       +26 -0     httpd-2.0/docs/manual/install.xml
  
  Index: install.xml
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/install.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -d -b -u -r1.1 -r1.2
  --- install.xml	15 Aug 2002 14:49:54 -0000	1.1
  +++ install.xml	25 Aug 2002 03:53:41 -0000	1.2
  @@ -509,6 +509,32 @@
       </dl>
   </section>
   
  +<section id="dbm"><title>DBM</title>
  +
  +    <p>Several Apache features, including
  +    <module>mod_auth_dbm</module> and <module>mod_rewrite</module>'s
  +    DBM <directive module="mod_rewrite">RewriteMap</directive> use
  +    simple key/value databases for quick lookups of information.  Apache
  +    includes SDBM with its source-code, so this database is always
  +    available.  If you would like to use other database types, the
  +    following <code>configure</code> options are available:</p>
  +
  +<dl>
  +<dt><code>--with-gdbm[=<em>path</em>]</code></dt>
  +<dt><code>--with-ndbm[=<em>path</em>]</code></dt>
  +<dt><code>--with-berkeley-db[=<em>path</em>]</code></dt> 
  +
  +<dd>If no <em>path</em> is specified, Apache will search for the
  +include files and libraries in the usual search paths.  An explict
  +<em>path</em> will cause Apache to look in
  +<em>path</em><code>/lib</code> and
  +<em>path</em><code>/include</code> for the relevant files.  Finally,
  +the <em>path</em> may specify specific include and library paths
  +seperated by a colon.</dd>
  +</dl>
  +</section>
  +
  +
   <section id="suexec"><title>Suexec</title>
   
       <p>Apache includes a support program called <a
  
  
  
  1.43      +27 -1     httpd-2.0/docs/manual/install.html.en
  
  Index: install.html.en
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/install.html.en,v
  retrieving revision 1.42
  retrieving revision 1.43
  diff -u -d -b -u -r1.42 -r1.43
  --- install.html.en	15 Aug 2002 14:49:54 -0000	1.42
  +++ install.html.en	25 Aug 2002 03:53:41 -0000	1.43
  @@ -16,7 +16,7 @@
       like many other Open Source projects.</p>
   
   <ul><li><a href="#overview">Overview for the
  -    impatient</a></li><li><a href="#requirements">Requirements</a></li><li><a href="#download">Download</a></li><li><a href="#extract">Extract</a></li><li><a href="#configure">Configuring the source tree</a><ul><li><a href="#environment">Environment Variables</a></li><li><a href="#output">autoconf Output Options</a></li><li><a href="#pathnames">Pathnames</a></li><li><a href="#modules">Modules</a></li><li><a href="#suexec">Suexec</a></li></ul></li><li><a href="#compile">Build</a></li><li><a href="#install">Install</a></li><li><a href="#customize">Customize</a></li><li><a href="#test">Test</a></li></ul><hr><h2><a name="overview">Overview for the
  +    impatient</a></li><li><a href="#requirements">Requirements</a></li><li><a href="#download">Download</a></li><li><a href="#extract">Extract</a></li><li><a href="#configure">Configuring the source tree</a><ul><li><a href="#environment">Environment Variables</a></li><li><a href="#output">autoconf Output Options</a></li><li><a href="#pathnames">Pathnames</a></li><li><a href="#modules">Modules</a></li><li><a href="#dbm">DBM</a></li><li><a href="#suexec">Suexec</a></li></ul></li><li><a href="#compile">Build</a></li><li><a href="#install">Install</a></li><li><a href="#customize">Customize</a></li><li><a href="#test">Test</a></li></ul><hr><h2><a name="overview">Overview for the
       impatient</a></h2>
   
       <table>
  @@ -480,6 +480,32 @@
   
         <dd>Choose the mpm <em>NAME</em>.</dd>
       </dl>
  +
  +
  +<h3><a name="dbm">DBM</a></h3>
  +
  +    <p>Several Apache features, including
  +    <code><a href="./mod/mod_auth_dbm.html">mod_auth_dbm</a></code> and <code><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>'s
  +    DBM <a href="./mod/mod_rewrite.html#rewritemap" class="directive"><code class="directive">RewriteMap</code></a> use
  +    simple key/value databases for quick lookups of information.  Apache
  +    includes SDBM with its source-code, so this database is always
  +    available.  If you would like to use other database types, the
  +    following <code>configure</code> options are available:</p>
  +
  +<dl>
  +<dt><code>--with-gdbm[=<em>path</em>]</code></dt>
  +<dt><code>--with-ndbm[=<em>path</em>]</code></dt>
  +<dt><code>--with-berkeley-db[=<em>path</em>]</code></dt> 
  +
  +<dd>If no <em>path</em> is specified, Apache will search for the
  +include files and libraries in the usual search paths.  An explict
  +<em>path</em> will cause Apache to look in
  +<em>path</em><code>/lib</code> and
  +<em>path</em><code>/include</code> for the relevant files.  Finally,
  +the <em>path</em> may specify specific include and library paths
  +seperated by a colon.</dd>
  +</dl>
  +
   
   
   <h3><a name="suexec">Suexec</a></h3>
  
  
  
  1.4       +2 -2      httpd-2.0/docs/manual/mod/mod_auth_dbm.xml
  
  Index: mod_auth_dbm.xml
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_auth_dbm.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -d -b -u -r1.3 -r1.4
  --- mod_auth_dbm.xml	23 May 2002 14:50:11 -0000	1.3
  +++ mod_auth_dbm.xml	25 Aug 2002 03:53:41 -0000	1.4
  @@ -123,7 +123,7 @@
   <name>AuthDBMType</name>
   <description>Sets the type of database file that is used to
   store passwords</description>
  -<syntax>AuthDBMType default|SDBM|GDBM|DB</syntax>
  +<syntax>AuthDBMType default|SDBM|GDBM|NDBM|DB</syntax>
   <default>AuthDBMType default</default>
   <contextlist><context>directory</context><context>.htaccess</context>
   </contextlist>
  @@ -135,7 +135,7 @@
   <p>Sets the type of database file that is used to store the passwords.
   The default database type is determined at compile time.  The
   availability of other types of database files also depends on
  -compile-time settings.</p>
  +<a href="../install.html#dbm">compile-time settings</a>.</p>
   
   <p>It is crucial that whatever program you use to create your password
   files is configured to use the same type of database.</p>
  
  
  
  1.6       +2 -2      httpd-2.0/docs/manual/mod/mod_auth_dbm.html.en
  
  Index: mod_auth_dbm.html.en
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_auth_dbm.html.en,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -d -b -u -r1.5 -r1.6
  --- mod_auth_dbm.html.en	2 Aug 2002 04:35:22 -0000	1.5
  +++ mod_auth_dbm.html.en	25 Aug 2002 03:53:41 -0000	1.6
  @@ -109,7 +109,7 @@
   <hr><h2><a name="AuthDBMType">AuthDBMType</a> <a name="authdbmtype">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap"><strong>Description: 
                     </strong></td><td>Sets the type of database file that is used to
   store passwords</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:
  -                  </a></td><td>AuthDBMType default|SDBM|GDBM|DB</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default: 
  +                  </a></td><td>AuthDBMType default|SDBM|GDBM|NDBM|DB</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default: 
                       </a></td><td><code>AuthDBMType default</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:
                     </a></td><td>directory, .htaccess</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Override" class="help">Override:
                       </a></td><td>AuthConfig</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:
  @@ -120,7 +120,7 @@
   <p>Sets the type of database file that is used to store the passwords.
   The default database type is determined at compile time.  The
   availability of other types of database files also depends on
  -compile-time settings.</p>
  +<a href="../install.html#dbm">compile-time settings</a>.</p>
   
   <p>It is crucial that whatever program you use to create your password
   files is configured to use the same type of database.</p>
  
  
  
  1.7       +13 -9     httpd-2.0/docs/manual/mod/mod_rewrite.xml
  
  Index: mod_rewrite.xml
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_rewrite.xml,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -d -b -u -r1.6 -r1.7
  --- mod_rewrite.xml	31 Jul 2002 05:38:55 -0000	1.6
  +++ mod_rewrite.xml	25 Aug 2002 03:53:41 -0000	1.7
  @@ -537,16 +537,20 @@
           </li>
   
           <li>
  -          <strong>Hash File</strong><br />
  -           MapType: <code>dbm</code>, MapSource: Unix filesystem
  +          <strong>Hash File</strong><br /> MapType:
  +          <code>dbm[=<em>type</em>]</code>, MapSource: Unix filesystem
             path to valid regular file 
   
  -          <p>Here the source is a binary NDBM format file
  -          containing the same contents as a <em>Plain Text</em>
  -          format file, but in a special representation which is
  -          optimized for really fast lookups. You can create such a
  -          file with any NDBM tool or with the following Perl
  -          script:</p>
  +          <p>Here the source is a binary format DBM file containing
  +          the same contents as a <em>Plain Text</em> format file, but
  +          in a special representation which is optimized for really
  +          fast lookups. The <em>type</em> can be sdbm, gdbm, ndbm, or
  +          db depending on <a href="../install.html#dbm">compile-time
  +          settings</a>.  If the <em>type</em> is ommitted, the
  +          compile-time default will be chosen. You can create such a
  +          file with any DBM tool or with the following Perl
  +          script.  Be sure to adjust it to create the appropriate
  +          type of DBM.  The example creates an NDBM file.</p>
   
   <example>
   <pre>
  
  
  
  1.7       +13 -9     httpd-2.0/docs/manual/mod/mod_rewrite.html.en
  
  Index: mod_rewrite.html.en
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_rewrite.html.en,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -d -b -u -r1.6 -r1.7
  --- mod_rewrite.html.en	2 Aug 2002 04:35:22 -0000	1.6
  +++ mod_rewrite.html.en	25 Aug 2002 03:53:41 -0000	1.7
  @@ -951,16 +951,20 @@
           </li>
   
           <li>
  -          <strong>Hash File</strong><br>
  -           MapType: <code>dbm</code>, MapSource: Unix filesystem
  +          <strong>Hash File</strong><br> MapType:
  +          <code>dbm[=<em>type</em>]</code>, MapSource: Unix filesystem
             path to valid regular file 
   
  -          <p>Here the source is a binary NDBM format file
  -          containing the same contents as a <em>Plain Text</em>
  -          format file, but in a special representation which is
  -          optimized for really fast lookups. You can create such a
  -          file with any NDBM tool or with the following Perl
  -          script:</p>
  +          <p>Here the source is a binary format DBM file containing
  +          the same contents as a <em>Plain Text</em> format file, but
  +          in a special representation which is optimized for really
  +          fast lookups. The <em>type</em> can be sdbm, gdbm, ndbm, or
  +          db depending on <a href="../install.html#dbm">compile-time
  +          settings</a>.  If the <em>type</em> is ommitted, the
  +          compile-time default will be chosen. You can create such a
  +          file with any DBM tool or with the following Perl
  +          script.  Be sure to adjust it to create the appropriate
  +          type of DBM.  The example creates an NDBM file.</p>
   
   <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
   <pre>