httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sl...@apache.org
Subject cvs commit: httpd-2.0/docs/manual/mod mod_include.html
Date Sun, 30 Dec 2001 15:34:13 GMT
slive       01/12/30 07:34:13

  Modified:    docs/manual/mod mod_include.html
  Log:
  Cleanup new directives in mod_include.
  
  Revision  Changes    Path
  1.43      +97 -87    httpd-2.0/docs/manual/mod/mod_include.html
  
  Index: mod_include.html
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_include.html,v
  retrieving revision 1.42
  retrieving revision 1.43
  diff -u -d -b -u -r1.42 -r1.43
  --- mod_include.html	30 Dec 2001 06:51:21 -0000	1.42
  +++ mod_include.html	30 Dec 2001 15:34:13 -0000	1.43
  @@ -38,11 +38,11 @@
       <h2>Directives</h2>
   
       <ul>
  -      <li><a href="#xbithack">XBitHack</a></li>
  +      <li><a href="#ssiendtag">SSIEndTag</a></li>
         <li><a href="#ssierrormsg">SSIErrorMsg</a></li>
  -      <li><a href="#ssitimeformat">SSITimeFormat</a></li>
         <li><a href="#ssistarttag">SSIStartTag</a></li>
  -      <li><a href="#ssiendtag">SSIEndTag</a></li>
  +      <li><a href="#ssitimeformat">SSITimeFormat</a></li>
  +      <li><a href="#xbithack">XBitHack</a></li>
       </ul>
   
       <p>See also: <a href="core.html#options">Options</a>, <a
  @@ -492,64 +492,31 @@
   
       <hr />
   
  -    <h2><a id="xbithack" name="xbithack">XBitHack</a>
  -    directive</h2>
  -    <!--%plaintext &lt;?INDEX {\tt XBitHack} directive&gt; -->
  -    <a href="directive-dict.html#Syntax"
  -    rel="Help"><strong>Syntax:</strong></a> XBitHack
  -    on|off|full<br />
  -     <a href="directive-dict.html#Default"
  -    rel="Help"><strong>Default:</strong></a> <code>XBitHack
  -    off</code><br />
  -     <a href="directive-dict.html#Context"
  +    <h2><a id="ssiendtag"
  +    name="ssiendtag">SSIEndTag</a> directive</h2> <a
  +    href="directive-dict.html#Syntax"
  +    rel="Help"><strong>Syntax:</strong></a> SSIEndTag <em>tag</em><br
  +    /> <a href="directive-dict.html#Default"
  +    rel="Help"><strong>Default:</strong></a> <code>SSIEndTag
  +    &quot;--&gt;&quot;</code><br /> <a
  +    href="directive-dict.html#Context"
       rel="Help"><strong>Context:</strong></a> server config, virtual
  -    host, directory, .htaccess<br />
  -     <a href="directive-dict.html#Override"
  -    rel="Help"><strong>Override:</strong></a> Options<br />
  -     <a href="directive-dict.html#Status"
  -    rel="Help"><strong>Status:</strong></a> Base<br />
  -     <a href="directive-dict.html#Module"
  +    host<br /> <a href="directive-dict.html#Status"
  +    rel="Help"><strong>Status:</strong></a> Base<br /> <a
  +    href="directive-dict.html#Module"
       rel="Help"><strong>Module:</strong></a> mod_include 
   
  -    <p>The XBitHack directives controls the parsing of ordinary
  -    html documents. This directive only affects files associated
  -    with the MIME type <code>text/html</code>. XBitHack can take on
  -    the following values:</p>
  -
  -    <dl>
  -      <dt>off</dt>
  -
  -      <dd>No special treatment of executable files.</dd>
  -
  -      <dt>on</dt>
  -
  -      <dd>Any text/html file that has the user-execute bit set will 
  -      be treated as a server-parsed html document.</dd>
  -
  -      <dt>full</dt>
  +    <p>This directive changes the string that mod_include looks for 
  +    to mark the end of a include command.</p>
   
  -      <dd>
  -        As for <code>on</code> but also test the group-execute bit.
  -        If it is set, then set the Last-modified date of the
  -        returned file to be the last modified time of the file. If
  -        it is not set, then no last-modified date is sent. Setting
  -        this bit allows clients and proxies to cache the result of
  -        the request. 
  +    <p>See also: <a href="#ssistarttag">SSIStartTag</a>.</p>
   
  -        <p><strong>Note:</strong> you would not want to use the full
  -        option, unless you assure the group-execute bit is unset for
  -        every SSI script which might <code>#include</code> a CGI 
  -        or otherwise produces different output on each hit (or could 
  -        potentially change on subsequent requests).</p>
  -      </dd>
  -    </dl>
       <hr />
       <h2><a id="ssierrormsg" name="ssierrormsg">SSIErrorMsg</a>
       directive</h2>
  -    <!--%plaintext &lt;?INDEX {\tt SSIErrorMsg} directive&gt; -->
       <a href="directive-dict.html#Syntax"
       rel="Help"><strong>Syntax:</strong></a> SSIErrorMsg
  -    &quot;text for error message&quot;<br />
  +    <em>message</em><br />
        <a href="directive-dict.html#Default"
       rel="Help"><strong>Default:</strong></a> <code>SSIErrorMsg
       &quot;[an error occurred while processing this directive]&quot;</code><br
/>
  @@ -561,73 +528,116 @@
        <a href="directive-dict.html#Module"
       rel="Help"><strong>Module:</strong></a> mod_include 
   
  -    <p>The SSIErrorMsg directive changes the error message displayed when 
  -    mod_include encounters an error. For production servers you may consider
  -    changing the default error message to <code>&quot;&lt;-- Error --&gt;&quot;</code>

  -    so that the message is not presented to the user.
  +    <p>The SSIErrorMsg directive changes the error message displayed
  +    when mod_include encounters an error. For production servers you
  +    may consider changing the default error message to
  +    <code>&quot;&lt;-- Error --&gt;&quot;</code> so that the
message
  +    is not presented to the user.
       </p>
  +    <p>This directive has the same effect as the <code>&lt;--#config
  +    errmsg=<em>message</em> --&gt;</code> element.</p>
       <hr />
  -    <h2><a id="ssitimeformat" name="ssitimeformat">SSITimeFormat</a>
  +    <h2><a id="ssistarttag" name="ssistarttag">SSIStartTag</a>
       directive</h2>
  -    <!--%plaintext &lt;?INDEX {\tt SSITimeFormat} directive&gt; -->
       <a href="directive-dict.html#Syntax"
  -        rel="Help"><strong>Syntax:</strong></a> SSITimeFormat 
  -    formatString<br />
  +        rel="Help"><strong>Syntax:</strong></a> SSIStartTag
  +    <em>tag</em><br />
        <a href="directive-dict.html#Default"
  -    rel="Help"><strong>Default:</strong></a> <code>SSITimeFormat
  -    &quot;%A, %d-%b-%Y %H:%M:%S %Z&quot;</code><br />
  +    rel="Help"><strong>Default:</strong></a> <code>SSIStartTag
  +    &quot;&lt;--!&quot;</code><br />
        <a href="directive-dict.html#Context"
       rel="Help"><strong>Context:</strong></a> server config, virtual
  -    host, directory, .htaccess<br />
  +    host<br />
        <a href="directive-dict.html#Status"
       rel="Help"><strong>Status:</strong></a> Base<br />
        <a href="directive-dict.html#Module"
       rel="Help"><strong>Module:</strong></a> mod_include 
   
  -    <p>This directive changes the format in which date strings are displayed 
  -    in note variables</p>
  +    <p>This directive changes the string that mod_include looks for 
  +    to mark an include element to process.</p>
  +
  +    <p>You may want to use this option if have 2 servers parsing the
  +    output of a file each processing different commands (possibly at
  +    different times).</p> 
  +
  +    <p>See also: <a href="#ssiendtag">SSIEndTag</a>.</p>
  +
       <hr />
  -    <h2><a id="ssistarttag" name="ssistarttag">SSIStartTag</a>
  +    <h2><a id="ssitimeformat" name="ssitimeformat">SSITimeFormat</a>
       directive</h2>
  -    <!--%plaintext &lt;?INDEX {\tt SSIStartTag} directive&gt; -->
       <a href="directive-dict.html#Syntax"
  -        rel="Help"><strong>Syntax:</strong></a> SSIStartTag
  -    tag<br />
  +        rel="Help"><strong>Syntax:</strong></a> SSITimeFormat 
  +    <em>formatstring</em><br />
        <a href="directive-dict.html#Default"
  -    rel="Help"><strong>Default:</strong></a> <code>SSIStartTag
  -    &quot;&lt;--!&quot;</code><br />
  +    rel="Help"><strong>Default:</strong></a> <code>SSITimeFormat
  +    &quot;%A, %d-%b-%Y %H:%M:%S %Z&quot;</code><br />
        <a href="directive-dict.html#Context"
       rel="Help"><strong>Context:</strong></a> server config, virtual
  -    host<br />
  +    host, directory, .htaccess<br />
        <a href="directive-dict.html#Status"
       rel="Help"><strong>Status:</strong></a> Base<br />
        <a href="directive-dict.html#Module"
       rel="Help"><strong>Module:</strong></a> mod_include 
   
  -    <p>This directive changes the string that mod_include looks for 
  -    to mark a include command to process</p>
  -    <p>you may want to use this option if have 2 servers parsing the output of a
file
  -    each processing different comnmands (possibly at different times)</p>
  +    <p>This directive changes the format in which date strings are displayed 
  +    when echoing DATE environment variables.  The <em>formatstring</em>
  +    is as in strftime(3) from the C standard library.</p>
  +
  +    <p>This directive has the same effect as the <code>&lt;--#config
  +    timefmt=<em>formatstring</em> --&gt;</code> element.</p>
  +
       <hr />
  -    <h2><a id="ssiendtag" name="ssiendtag">SSIEndTag</a>
  +    <h2><a id="xbithack" name="xbithack">XBitHack</a>
       directive</h2>
  -    <!--%plaintext &lt;?INDEX {\tt SSIEndTag} directive&gt; -->
       <a href="directive-dict.html#Syntax"
  -        rel="Help"><strong>Syntax:</strong></a> SSIEndTag
  -    tag<br />
  +    rel="Help"><strong>Syntax:</strong></a> XBitHack
  +    on|off|full<br />
        <a href="directive-dict.html#Default"
  -    rel="Help"><strong>Default:</strong></a> <code>SSIEndTag
  -    &quot;--&gt;&quot;</code><br />
  +    rel="Help"><strong>Default:</strong></a> <code>XBitHack
  +    off</code><br />
        <a href="directive-dict.html#Context"
       rel="Help"><strong>Context:</strong></a> server config, virtual
  -    host<br />
  +    host, directory, .htaccess<br />
  +     <a href="directive-dict.html#Override"
  +    rel="Help"><strong>Override:</strong></a> Options<br />
        <a href="directive-dict.html#Status"
       rel="Help"><strong>Status:</strong></a> Base<br />
        <a href="directive-dict.html#Module"
       rel="Help"><strong>Module:</strong></a> mod_include 
   
  -    <p>This directive changes the string that mod_include looks for 
  -    to mark the end of a include command</p>
  +    <p>The XBitHack directives controls the parsing of ordinary
  +    html documents. This directive only affects files associated
  +    with the MIME type <code>text/html</code>. XBitHack can take on
  +    the following values:</p>
  +
  +    <dl>
  +      <dt>off</dt>
  +
  +      <dd>No special treatment of executable files.</dd>
  +
  +      <dt>on</dt>
  +
  +      <dd>Any text/html file that has the user-execute bit set will 
  +      be treated as a server-parsed html document.</dd>
  +
  +      <dt>full</dt>
  +
  +      <dd>
  +        As for <code>on</code> but also test the group-execute bit.
  +        If it is set, then set the Last-modified date of the
  +        returned file to be the last modified time of the file. If
  +        it is not set, then no last-modified date is sent. Setting
  +        this bit allows clients and proxies to cache the result of
  +        the request. 
  +
  +        <p><strong>Note:</strong> you would not want to use the full
  +        option, unless you assure the group-execute bit is unset for
  +        every SSI script which might <code>#include</code> a CGI 
  +        or otherwise produces different output on each hit (or could 
  +        potentially change on subsequent requests).</p>
  +      </dd>
  +    </dl>
  +    <hr />
   
       <p><!--#include virtual="footer.html" -->
       </p>
  
  
  

Mime
View raw message