You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by co...@apache.org on 2001/08/16 04:25:28 UTC

cvs commit: httpd-docs-1.3/htdocs/manual/mod mod_usertrack.html

coar        01/08/15 19:25:28

  Modified:    htdocs/manual/mod mod_usertrack.html
  Log:
  Document the recent directive enhancements for cookie syntaces.
  
  Revision  Changes    Path
  1.21      +75 -1     httpd-docs-1.3/htdocs/manual/mod/mod_usertrack.html
  
  Index: mod_usertrack.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/mod_usertrack.html,v
  retrieving revision 1.20
  retrieving revision 1.21
  diff -u -u -r1.20 -r1.21
  --- mod_usertrack.html	2000/12/08 20:53:40	1.20
  +++ mod_usertrack.html	2001/08/16 02:25:28	1.21
  @@ -52,8 +52,10 @@
   <H2>Directives</H2>
   
   <UL>
  +<li><a href="#cookiedomain">CookieDomain</a></li>
   <LI><A HREF="#cookieexpires">CookieExpires</A>
   <LI><A HREF="#cookiename">CookieName</A>
  +<li><a href="#cookiestyle">CookieStyle</a></li>
   <LI><A HREF="#cookietracking">CookieTracking</A>
   </UL>
   
  @@ -116,6 +118,37 @@
   time late in the year "37".
   </PRE>
   
  +<hr>
  +
  +<h2><a name="cookiedomain">CookieDomain</a> directive</h2>
  +<a
  + href="directive-dict.html#Syntax"
  + rel="Help"
  +><b>Syntax:</b></a> CookieDomain <i>domain</i><br>
  +<a
  + href="directive-dict.html#Context"
  + rel="Help"
  +><b>Context:</b></a> server config, virtual host, directory, .htaccess<br>
  +<a
  + href="directive-dict.html#Status"
  + rel="Help"
  +><b>Status:</b></a> optional<br>
  +<a
  + href="directive-dict.html#Module"
  + rel="Help"
  +><b>Module:</b></a> mod_usertrack
  +
  +<p>
  +This directive controls the setting of the domain to which the
  +tracking cookie applies.  If not present, no domain is included
  +in the cookie header field.
  +</p>
  +<p>
  +The domain string <b>must</b> begin with a dot, and <b>must</b>
  +include at least one embedded dot.  That is, ".foo.com" is legal,
  +but "foo.bar.com" and ".com" are not.
  +</p>
  +
   <HR>
   
   <H2><A NAME="cookieexpires">CookieExpires</A> directive</H2>
  @@ -126,7 +159,9 @@
   <A
    HREF="directive-dict.html#Context"
    REL="Help"
  -><STRONG>Context:</STRONG></A> server config, virtual host<BR>
  +><STRONG>Context:</STRONG></A>
  +<b>1.3.20 and earlier:</b> server config, virtual host; 
  +<b>1.3.21 and later:</b> server config, virtual host, directory, .htaccess<br>
   <A
    HREF="directive-dict.html#Status"
    REL="Help"
  @@ -187,6 +222,45 @@
   you use a name containing unusual characters.  Valid characters
   include A-Z, a-z, 0-9, "_", and "-".
   </P>
  +
  +<hr>
  +
  +<h2><a name="cookiestyle">CookieStyle</a> directive</h2>
  +<a
  + href="directive-dict.html#Syntax"
  + rel="Help"
  +><b>Syntax:</b></a> CookieStyle <i>Netscape|Cookie|Cookie2|RFC2109|RFC2965</i><br>
  +<a
  + href="directive-dict.html#Context"
  + rel="Help"
  +><b>Context:</b></a> server config, virtual host, directory, .htaccess<br>
  +<a
  + href="directive-dict.html#Status"
  + rel="Help"
  +><b>Status:</b></a> optional<br>
  +<a
  + href="directive-dict.html#Module"
  + rel="Help"
  +><b>Module:</b></a> mod_usertrack
  +
  +<p>
  +This directive controls the format of the cookie header field.
  +The three formats allowed are:
  +</p>
  +<ul>
  + <li><b>Netscape</b>, which is the original but now deprecated
  +  syntax.  This is the default, and the syntax Apache has
  +  historically used.</li>
  + <li><b>Cookie</b> or <b>RFC2109</b>, which is the syntax that
  +  superseded the Netscape syntax.</li>
  + <li><b>Cookie2</b> or <b>RFC2965</b>, which is the most current
  +  cookie syntax.</li>
  +</ul>
  +
  +<p>
  +Not all clients can understand all of these formats. but you should use
  +the newest one that is generally acceptable to your users' browsers.
  +</p>
   
   <hr>
   <H2><A NAME="cookietracking">CookieTracking</A> directive</H2>