You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by sl...@apache.org on 2002/05/27 00:08:58 UTC

cvs commit: httpd-2.0/docs/manual/mod mod_suexec.xml mod_vhost_alias.xml mod_usertrack.xml mod_userdir.xml

slive       02/05/26 15:08:58

  Modified:    docs/manual/mod mod_suexec.xml mod_vhost_alias.xml
                        mod_usertrack.xml mod_userdir.xml
  Log:
  Small mod doc updates.
  
  Revision  Changes    Path
  1.5       +10 -8     httpd-2.0/docs/manual/mod/mod_suexec.xml
  
  Index: mod_suexec.xml
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_suexec.xml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -d -b -u -r1.4 -r1.5
  --- mod_suexec.xml	23 May 2002 14:50:11 -0000	1.4
  +++ mod_suexec.xml	26 May 2002 22:08:58 -0000	1.5
  @@ -13,27 +13,29 @@
   
   
   <summary>
  -    <p>This module allows CGI scripts to run as a specified user
  -    and Group.</p>
  +    <p>This module, in combination with the <a
  +    href="../programs/suexec.html">suexec support program</a> allows
  +    CGI scripts to run as a specified user and Group.</p>
   </summary>
   
  +<seealso><a href="../suexec.html">SuEXEC support</a></seealso>
   
   <directivesynopsis>
   
   <name>SuexecUserGroup</name>
  +<description>User and group permissions for CGI programs</description>
   <syntax>SuexecUserGroup <em>User Group</em></syntax>
  -<default>None</default>
   <contextlist><context>server config</context>
   <context>virtual host</context></contextlist>
   <compatibility>SuexecUserGroup is only available in 2.0 and
   later.</compatibility>
   
   <usage>
  -    <p>The <directive>SuexecUserGroup</directive> directive allows you to
  -    specify a user and group for CGI programs to run as. Non-CGI
  -    requests are still processes with the user specified in the
  -    User directive. This directive replaces using the User and
  -    Group directives inside of VirtualHosts.</p>
  +    <p>The <directive>SuexecUserGroup</directive> directive allows you
  +    to specify a user and group for CGI programs to run as. Non-CGI
  +    requests are still processes with the user specified in the User
  +    directive. This directive replaces the Apache 1.3 configuration of
  +    using the User and Group directives inside of VirtualHosts.</p>
   </usage>
   
   </directivesynopsis>
  
  
  
  1.4       +4 -15     httpd-2.0/docs/manual/mod/mod_vhost_alias.xml
  
  Index: mod_vhost_alias.xml
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_vhost_alias.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -d -b -u -r1.3 -r1.4
  --- mod_vhost_alias.xml	23 May 2002 14:50:11 -0000	1.3
  +++ mod_vhost_alias.xml	26 May 2002 22:08:58 -0000	1.4
  @@ -4,9 +4,8 @@
   <modulesynopsis>
   
   <name>mod_vhost_alias</name>
  -<description>Provides for <a
  -href="../vhosts/mass.html">dynamically configured mass virtual
  -hosting</a></description>
  +<description>Provides for dynamically configured mass virtual
  +hosting</description>
   <status>Extension</status>
   <sourcefile>mod_vhost_alias.c</sourcefile>
   <identifier>vhost_alias_module</identifier>
  @@ -23,6 +22,8 @@
   </summary>
       <seealso><directive
       module="core">UseCanonicalName</directive>.</seealso>
  +    <seealso><a href="../vhosts/mass.html">Dynamically configured mass 
  +virtual hosting</a></seealso>
   
   <section>
       <title>Directory Name Interpolation</title>
  @@ -187,9 +188,6 @@
   <context>server config</context>
   <context>virtual host</context>
   </contextlist>
  -<override></override>
  -<compatibility>VirtualDocumentRoot is only available in 1.3.7 and
  -later.</compatibility>
   
   <usage>
   
  @@ -217,9 +215,6 @@
   <context>server config</context>
   <context>virtual host</context>
   </contextlist>
  -<override></override>
  -<compatibility>VirtualDocumentRootIP is only available in 1.3.7 
  -and later.</compatibility>
   
   <usage>
   
  @@ -240,9 +235,6 @@
   <context>server config</context>
   <context>virtual host</context>
   </contextlist>
  -<override></override>
  -<compatibility>VirtualScriptAlias is only available in 1.3.7
  -and later.</compatibility>
   
   <usage>
   
  @@ -267,9 +259,6 @@
   <context>server config</context>
   <context>virtual host</context>
   </contextlist>
  -<override></override>
  -<compatibility>VirtualScriptAliasIP is only available in 1.3.7 
  -and later.</compatibility>
   
   <usage>
   
  
  
  
  1.4       +17 -15    httpd-2.0/docs/manual/mod/mod_usertrack.xml
  
  Index: mod_usertrack.xml
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_usertrack.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -d -b -u -r1.3 -r1.4
  --- mod_usertrack.xml	23 May 2002 14:50:11 -0000	1.3
  +++ mod_usertrack.xml	26 May 2002 22:08:58 -0000	1.4
  @@ -5,13 +5,11 @@
   <modulesynopsis>
   <name>mod_usertrack</name> 
   <description>
  -    This module uses cookies to provide for a
  -    <em>clickstream</em> log of user activity on a site.
  +<em>Clickstream</em> logging of user activity on a site
   </description>
   <status>Extension</status>
   <sourcefile>mod_usertrack.c</sourcefile>
   <identifier>usertrack_module</identifier>
  -<compatibility>Known as mod_cookies prior to Apache 1.3.</compatibility>
   
   <summary>
       <p>Previous releases of Apache have included a module which
  @@ -39,8 +37,10 @@
   </example>
   
       <p>For backward compatibility the configurable log module
  -    implements the old <directive>CookieLog</directive> directive, but this
  -    should be upgraded to the above <directive>CustomLog</directive> directive. </p>
  +    implements the old <directive
  +    module="mod_log_config">CookieLog</directive> directive, but this
  +    should be upgraded to the above <directive
  +    module="mod_log_config">CustomLog</directive> directive. </p>
   </section>
   
   <section>
  @@ -86,15 +86,15 @@
   
   <directivesynopsis>
   <name>CookieDomain</name>
  -<description>controls the setting of the domain to which the tracking cookie applies.</description>
  +<description>The domain to which the tracking cookie applies</description>
   <syntax>CookieDomain <em>domain</em></syntax>
  -<default>None</default>
   <contextlist>
   <context>server config</context>
   <context>virtual host</context>
   <context>directory</context>
   <context>.htaccess</context>
   </contextlist>
  +<override>FileInfo</override>
   
   <usage>
   
  @@ -111,17 +111,15 @@
   
   <directivesynopsis>
   <name>CookieExpires</name>
  +<description>Expiry time for the tracking cookie</description>
   <syntax>CookieExpires <em>expiry-period</em></syntax>
  -<default></default>
   <contextlist>
   <context>server config</context>
   <context>virtual host</context>
   <context>directory</context>
   <context>.htaccess</context>
   </contextlist>
  -<override></override>
  -<compatibility>In 1.3.20 and earlier, not usable in directory and
  -.htaccess</compatibility>
  +<override>FileInfo</override>
   
   <usage>
       <p>When used, this directive sets an expiry time on the cookie
  @@ -139,14 +137,16 @@
   
   <directivesynopsis>
   <name>CookieName</name>
  +<description>Name of the tracking cookie</description>
   <syntax>CookieName <em>token</em></syntax>
  -<default>Apache</default>
  +<default>CookieName Apache</default>
   <contextlist>
   <context>server config</context>
   <context>virtual host</context>
   <context>directory</context>
   <context>.htaccess</context>
   </contextlist>
  +<override>FileInfo</override>
   
   <usage>
       <p>This directive allows you to change the name of the cookie
  @@ -161,16 +161,17 @@
   
   <directivesynopsis>
   <name>CookieStyle</name>
  -<description>Controls the format of the cookie header field</description>
  +<description>Format of the cookie header field</description>
   <syntax>CookieStyle
       <em>Netscape|Cookie|Cookie2|RFC2109|RFC2965</em></syntax>
  -<default></default>
  +<default>CookieStyle Netscape</default>
   <contextlist>
   <context>server config</context>
   <context>virtual host</context>
   <context>directory</context>
   <context>.htaccess</context>
   </contextlist>
  +<override>FileInfo</override>
   
   <usage>
       <p>This directive controls the format of the cookie header
  @@ -198,8 +199,9 @@
   
   <directivesynopsis>
   <name>CookieTracking</name>
  +<description>Enables tracking cookie</description>
   <syntax>CookieTracking on|off</syntax>
  -<default></default>
  +<default>CookieTracking off</default>
   <contextlist>
   <context>server config</context>
   <context>virtual host</context>
  
  
  
  1.7       +13 -19    httpd-2.0/docs/manual/mod/mod_userdir.xml
  
  Index: mod_userdir.xml
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_userdir.xml,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -d -b -u -r1.6 -r1.7
  --- mod_userdir.xml	23 May 2002 14:50:11 -0000	1.6
  +++ mod_userdir.xml	26 May 2002 22:08:58 -0000	1.7
  @@ -4,32 +4,27 @@
   <modulesynopsis>
   
   <name>mod_userdir</name>
  -<description>Provides for user-specific
  -directories</description>
  +<description>User-specific directories</description>
   <status>Base</status>
   <sourcefile>mod_userdir.c</sourcefile>
   <identifier>userdir_module</identifier>
   
   <summary>
  +This module allows user-specific directories to be accessed using the
  +<code>http://example.com/~user/</code> syntax.
   </summary>
   
  +<seealso><a href="../urlmapping.html">Mapping URLs to the
  +Filesystem</a></seealso>
   
   <directivesynopsis>
   
   <name>UserDir</name>
  -<description>Sets the directory from which to serve files when requests
  -for a particular user are received, denoted by requests containing
  -<em>~username</em>, such as 
  -<em>http://server.example.com/~bob/</em></description>
  +<description>Location of the user-specific directories</description>
   <syntax>UserDir <em>directory-filename</em></syntax>
   <default>UserDir public_html</default>
   <contextlist><context>server config</context> <context>virtual
   host</context></contextlist>
  -<compatibility>All forms except the <code>UserDir public_html</code>
  -form are only available in Apache 1.1 or above. Use of the 
  -<code>enabled</code> keyword, or <code>disabled</code> with a
  -list of usernames, is only available in Apache 1.3 and
  -above.</compatibility>
   
   <usage>
   
  @@ -90,14 +85,13 @@
   
   <note>
         <strong>Be careful when using this directive; for instance,
  -      <code>"UserDir ./"</code> would map
  -      <code>"/~root"</code> to <code>"/"</code> - which is probably
  -      undesirable. If you are running Apache 1.3 or above, it is
  -      strongly recommended that your configuration include a
  -      "<code>UserDir disabled root</code>" declaration.
  -      See also the <directive module="core">Directory</directive>
  -      directive and the <a href="../misc/security_tips.html">Security
  -      Tips</a> page for more information.</strong>
  +      <code>"UserDir ./"</code> would map <code>"/~root"</code> to
  +      <code>"/"</code> - which is probably undesirable. It is strongly
  +      recommended that your configuration include a "<code>UserDir
  +      disabled root</code>" declaration.  See also the <directive
  +      module="core">Directory</directive> directive and the <a
  +      href="../misc/security_tips.html">Security Tips</a> page for
  +      more information.</strong>
   </note>
   
   <p>Additional examples:</p>