slive 00/09/28 15:43:32
Modified: htdocs/manual/mod mod_negotiation.html mod_rewrite.html mod_vhost_alias.html mod_digest.html mod_cgi.html mod_usertrack.html mod_example.html Log: Last of the module style changes (I hope). Revision Changes Path 1.17 +1 -1 httpd-docs-2.0/htdocs/manual/mod/mod_negotiation.html Index: mod_negotiation.html =================================================================== RCS file: /home/cvs/httpd-docs-2.0/htdocs/manual/mod/mod_negotiation.html,v retrieving revision 1.16 retrieving revision 1.17 diff -u -r1.16 -r1.17 --- mod_negotiation.html 2000/09/27 18:36:46 1.16 +++ mod_negotiation.html 2000/09/28 22:43:30 1.17 @@ -58,7 +58,7 @@ <A HREF="./mod_mime.html#addencoding">AddEncoding</A>, <A HREF="./mod_mime.html#addlanguage">AddLanguage</A>, <A HREF="./mod_mime.html#addtype">AddType</A>, and -<A HREF="core.html#options">Option</A>. +<A HREF="core.html#options">Options</A>. <H2>Type maps</H2> A type map has the same format as RFC822 mail headers. It contains document 1.51 +24 -8 httpd-docs-2.0/htdocs/manual/mod/mod_rewrite.html Index: mod_rewrite.html =================================================================== RCS file: /home/cvs/httpd-docs-2.0/htdocs/manual/mod/mod_rewrite.html,v retrieving revision 1.50 retrieving revision 1.51 diff -u -r1.50 -r1.51 --- mod_rewrite.html 2000/09/09 18:40:49 1.50 +++ mod_rewrite.html 2000/09/28 22:43:30 1.51 @@ -21,14 +21,30 @@ <BR> <H1 ALIGN="CENTER">Module mod_rewrite<BR>URL Rewriting Engine</H1> -This module is contained in the <CODE>mod_rewrite.c</CODE> file, with Apache -1.2 and later. It provides a rule-based rewriting engine to rewrite requested -URLs on the fly. It is not compiled into the server by default. To use -<CODE>mod_rewrite</CODE> you have to enable the following line in the server -build <CODE>Configuration</CODE> file: -<PRE> - AddModule modules/standard/mod_rewrite.o -</PRE> +<p>This module provides a rule-based rewriting engine to rewrite requested +URLs on the fly.</p> + +<P><A +HREF="module-dict.html#Status" +REL="Help" +><STRONG>Status:</STRONG></A> Extension +<BR> +<A +HREF="module-dict.html#SourceFile" +REL="Help" +><STRONG>Source File:</STRONG></A> mod_rewrite.c +<BR> +<A +HREF="module-dict.html#ModuleIdentifier" +REL="Help" +><STRONG>Module Identifier:</STRONG></A> rewrite_module +<BR> +<A +HREF="module-dict.html#Compatibility" +REL="Help" +><STRONG>Compatibility:</STRONG></A> Available in Apache 1.2 and later. +</P> + <P> <HR NOSHADE SIZE=1> 1.8 +1 -7 httpd-docs-2.0/htdocs/manual/mod/mod_vhost_alias.html Index: mod_vhost_alias.html =================================================================== RCS file: /home/cvs/httpd-docs-2.0/htdocs/manual/mod/mod_vhost_alias.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- mod_vhost_alias.html 2000/09/28 16:55:53 1.7 +++ mod_vhost_alias.html 2000/09/28 22:43:31 1.8 @@ -12,13 +12,7 @@ VLINK="#000080" ALINK="#FF0000" > -<DIV ALIGN="CENTER"> - <IMG SRC="../images/sub.gif" ALT="[APACHE DOCUMENTATION]"> - <H3> - Apache HTTP Server Version 1.3 - </H3> -</DIV> - +<!--#include virtual="header.html" --> <H1 ALIGN="CENTER">Module mod_vhost_alias</H1> <P> 1.11 +0 -14 httpd-docs-2.0/htdocs/manual/mod/mod_digest.html Index: mod_digest.html =================================================================== RCS file: /home/cvs/httpd-docs-2.0/htdocs/manual/mod/mod_digest.html,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- mod_digest.html 1998/05/20 14:12:55 1.10 +++ mod_digest.html 2000/09/28 22:43:31 1.11 @@ -58,21 +58,7 @@ created using the "htdigest" utility found in the support/ subdirectory of the Apache distribution.</P> -<HR> -<H3>Using Digest Authentication</H3> - -<P>Using MD5 Digest authentication is very simple. Simply set up -authentication normally. However, use "AuthType Digest" and -"AuthDigestFile" instead of the normal "AuthType Basic" and -"AuthUserFile". Everything else should remain the same.</P> - -<P>MD5 authentication provides a more secure password system, but only -works with supporting browsers. As of this writing (July 1996), the -majority of browsers do not support digest authentication. Therefore, we -do not recommend using this feature on a large Internet site. However, for -personal and intra-net use, where browser users can be controlled, it is -ideal.</P> <!--#include virtual="footer.html" --> </BODY> 1.20 +3 -2 httpd-docs-2.0/htdocs/manual/mod/mod_cgi.html Index: mod_cgi.html =================================================================== RCS file: /home/cvs/httpd-docs-2.0/htdocs/manual/mod/mod_cgi.html,v retrieving revision 1.19 retrieving revision 1.20 diff -u -r1.19 -r1.20 --- mod_cgi.html 2000/09/26 19:21:08 1.19 +++ mod_cgi.html 2000/09/28 22:43:31 1.20 @@ -61,8 +61,9 @@ </ul> <p>See also: <a href="core.html#options">Options</a>, <a -href="mod_alias.html#scriptalias">ScriptAlias</a> and <a -href="mod_mime.html#addtype">AddType</a>. +href="mod_alias.html#scriptalias">ScriptAlias</a>, <a +href="mod_mime.html#addtype">AddType</a> and <a +href="mod_mime.html#addhandler">AddHandler</a>. <H2>CGI Environment variables</H2> The server will set the CGI environment variables as described in the 1.19 +81 -55 httpd-docs-2.0/htdocs/manual/mod/mod_usertrack.html Index: mod_usertrack.html =================================================================== RCS file: /home/cvs/httpd-docs-2.0/htdocs/manual/mod/mod_usertrack.html,v retrieving revision 1.18 retrieving revision 1.19 diff -u -r1.18 -r1.19 --- mod_usertrack.html 1999/04/29 15:44:32 1.18 +++ mod_usertrack.html 2000/09/28 22:43:31 1.19 @@ -15,25 +15,57 @@ <!--#include virtual="header.html" --> <H1 ALIGN="CENTER">Module mod_usertrack</H1> -Previous releases of Apache have included a module which generates a +<p>This module uses cookies to provide for a <em>clickstream</em> log of user +activity on a site.</p> + +<P><A +HREF="module-dict.html#Status" +REL="Help" +><STRONG>Status:</STRONG></A> Extension +<BR> +<A +HREF="module-dict.html#SourceFile" +REL="Help" +><STRONG>Source File:</STRONG></A> mod_usertrack.c +<BR> +<A +HREF="module-dict.html#ModuleIdentifier" +REL="Help" +><STRONG>Module Identifier:</STRONG></A> usertrack_module +<BR> +<A +HREF="module-dict.html#Compatibility" +REL="Help" +><STRONG>Compatibility:</STRONG></A> Known as mod_cookies prior to +Apache 1.3. +</P> + +<h2>Summary</h2> + +<p>Previous releases of Apache have included a module which generates a 'clickstream' log of user activity on a site using cookies. This was called the "cookies" module, mod_cookies. In Apache 1.2 and later this module has been renamed the "user tracking" module, mod_usertrack. This module has been simplified and new directives -added. +added.</p> -<HR> +<H2>Directives</H2> +<UL> +<LI><A HREF="#cookieexpires">CookieExpires</A> +<LI><A HREF="#cookiename">CookieName</A> +<LI><A HREF="#cookietracking">CookieTracking</A> +</UL> + <H2>Logging</H2> -Previously, the cookies module (now the user tracking module) did its +<p>Previously, the cookies module (now the user tracking module) did its own logging, using the <TT>CookieLog</TT> directive. In this release, this module does no logging at all. Instead, a configurable log format file should be used to log user click-streams. This is possible because the logging module now allows <A HREF="../multilogs.html">multiple log files</A>. The cookie itself is logged by using the text <TT>%{cookie}n </TT> - in the log file format. For example: <PRE> CustomLog logs/clickstream "%{cookie}n %r %t" @@ -43,17 +75,50 @@ old <TT>CookieLog</TT> directive, but this should be upgraded to the above <TT>CustomLog</TT> directive. -<H2>Directives</H2> +<H2>2-digit or 4-digit dates for cookies?</H2> -<UL> -<LI><A HREF="#cookieexpires">CookieExpires</A> -<LI><A HREF="#cookiename">CookieName</A> -<LI><A HREF="#cookietracking">CookieTracking</A> -</UL> +(the following is from message +<[EMAIL PROTECTED]> in +the new-httpd archives) + +<P> + +<PRE> +From: "Christian Allen" <[EMAIL PROTECTED]> +Subject: Re: Apache Y2K bug in mod_usertrack.c +Date: Tue, 30 Jun 1998 11:41:56 -0400 + +Did some work with cookies and dug up some info that might be useful. + +True, Netscape claims that the correct format NOW is four digit dates, and +four digit dates do in fact work... for Netscape 4.x (Communicator), that +is. However, 3.x and below do NOT accept them. It seems that Netscape +originally had a 2-digit standard, and then with all of the Y2K hype and +probably a few complaints, changed to a four digit date for Communicator. +Fortunately, 4.x also understands the 2-digit format, and so the best way to +ensure that your expiration date is legible to the client's browser is to +use 2-digit dates. + +However, this does not limit expiration dates to the year 2000; if you use +an expiration year of "13", for example, it is interpreted as 2013, NOT +1913! In fact, you can use an expiration year of up to "37", and it will be +understood as "2037" by both MSIE and Netscape versions 3.x and up (not sure +about versions previous to those). Not sure why Netscape used that +particular year as its cut-off point, but my guess is that it was in respect +to UNIX's 2038 problem. Netscape/MSIE 4.x seem to be able to understand +2-digit years beyond that, at least until "50" for sure (I think they +understand up until about "70", but not for sure). + +Summary: Mozilla 3.x and up understands two digit dates up until "37" +(2037). Mozilla 4.x understands up until at least "50" (2050) in 2-digit +form, but also understands 4-digit years, which can probably reach up until +9999. Your best bet for sending a long-life cookie is to send it for some +time late in the year "37". +</PRE> <HR> -<H2><A NAME="cookieexpires">CookieExpires</A></H2> +<H2><A NAME="cookieexpires">CookieExpires</A> directive</H2> <A HREF="directive-dict.html#Syntax" REL="Help" @@ -82,7 +147,8 @@ <P>If this directive is not used, cookies last only for the current browser session.</P> -<H2><A NAME="cookiename">CookieName</A></H2> +<HR> +<H2><A NAME="cookiename">CookieName</A> directive</H2> <A HREF="directive-dict.html#Syntax" REL="Help" @@ -122,7 +188,8 @@ include A-Z, a-z, 0-9, "_", and "-". </P> -<H2><A NAME="cookietracking">CookieTracking</A></H2> +<hr> +<H2><A NAME="cookietracking">CookieTracking</A> directive</H2> <A HREF="directive-dict.html#Syntax" REL="Help" @@ -151,48 +218,7 @@ on a per-server or per-directory basis. By default, compiling mod_usertrack will not activate cookies. -<HR> -<H2>2-digit or 4-digit dates for cookies?</H2> - -(the following is from message -<[EMAIL PROTECTED]> in -the new-httpd archives) - -<P> - -<PRE> -From: "Christian Allen" <[EMAIL PROTECTED]> -Subject: Re: Apache Y2K bug in mod_usertrack.c -Date: Tue, 30 Jun 1998 11:41:56 -0400 - -Did some work with cookies and dug up some info that might be useful. - -True, Netscape claims that the correct format NOW is four digit dates, and -four digit dates do in fact work... for Netscape 4.x (Communicator), that -is. However, 3.x and below do NOT accept them. It seems that Netscape -originally had a 2-digit standard, and then with all of the Y2K hype and -probably a few complaints, changed to a four digit date for Communicator. -Fortunately, 4.x also understands the 2-digit format, and so the best way to -ensure that your expiration date is legible to the client's browser is to -use 2-digit dates. - -However, this does not limit expiration dates to the year 2000; if you use -an expiration year of "13", for example, it is interpreted as 2013, NOT -1913! In fact, you can use an expiration year of up to "37", and it will be -understood as "2037" by both MSIE and Netscape versions 3.x and up (not sure -about versions previous to those). Not sure why Netscape used that -particular year as its cut-off point, but my guess is that it was in respect -to UNIX's 2038 problem. Netscape/MSIE 4.x seem to be able to understand -2-digit years beyond that, at least until "50" for sure (I think they -understand up until about "70", but not for sure). - -Summary: Mozilla 3.x and up understands two digit dates up until "37" -(2037). Mozilla 4.x understands up until at least "50" (2050) in 2-digit -form, but also understands 4-digit years, which can probably reach up until -9999. Your best bet for sending a long-life cookie is to send it for some -time late in the year "37". -</PRE> <!--#include virtual="footer.html" --> </BODY> 1.9 +32 -12 httpd-docs-2.0/htdocs/manual/mod/mod_example.html Index: mod_example.html =================================================================== RCS file: /home/cvs/httpd-docs-2.0/htdocs/manual/mod/mod_example.html,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- mod_example.html 1999/06/29 12:06:36 1.8 +++ mod_example.html 2000/09/28 22:43:31 1.9 @@ -14,8 +14,7 @@ <!--#include virtual="header.html" --> <H1 ALIGN="CENTER">Module mod_example</H1> <P> - This module is contained in the <CODE>modules/mod_example.c</CODE> file, and - <STRONG>is not</STRONG> compiled in by default. It illustrates many of + This module illustrates many of the aspects of the <A HREF="../misc/API.html" @@ -24,6 +23,24 @@ and, when used, demonstrates the manner in which module callbacks are triggered by the server. </P> + +<P><A +HREF="module-dict.html#Status" +REL="Help" +><STRONG>Status:</STRONG></A> Extension +<BR> +<A +HREF="module-dict.html#SourceFile" +REL="Help" +><STRONG>Source File:</STRONG></A> mod_example.c +<BR> +<A +HREF="module-dict.html#ModuleIdentifier" +REL="Help" +><STRONG>Module Identifier:</STRONG></A> example_module +</P> + + <H2>Summary</H2> <P> The files in the <CODE>src/modules/example directory</CODE> under the @@ -43,6 +60,15 @@ some of the tracing the example module did as the various callbacks were made. </P> + <H2>Directives</H2> + <P> + <UL> + <LI><A HREF="#example">Example</A> + </LI> + </UL> + </P> + + <h2>Compiling the example module</h2> <P> To include the example module in your server, follow the steps below: </P> @@ -78,9 +104,9 @@ <LI>Follow steps [1] through [3] above, with appropriate changes. </LI> </OL> - <H3> + <H2> Using the <SAMP>mod_example</SAMP> Module - </H3> + </H2> <P> To activate the example module, include a block similar to the following in your <SAMP>srm.conf</SAMP> file: @@ -104,17 +130,11 @@ <P> After reloading/restarting your server, you should be able to browse to this location and see the brief display mentioned earlier. - </P> - <H2>Directives</H2> - <P> - <UL> - <LI><A HREF="#example">Example</A> - </LI> - </UL> </P> + <HR> <H2><A NAME="example"> - Example + Example directive </A></H2> <P> <A