akosut 96/12/01 00:31:25
Modified: htdocs/manual/mod directives.html mod_browser.html
Log:
Enhance mod_browser documentation.
Revision Changes Path
1.5 +2 -0 apache/htdocs/manual/mod/directives.html
Index: directives.html
===================================================================
RCS file: /export/home/cvs/apache/htdocs/manual/mod/directives.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -C3 -r1.4 -r1.5
*** directives.html 1996/12/01 06:57:35 1.4
--- directives.html 1996/12/01 08:31:23 1.5
***************
*** 39,44 ****
--- 39,46 ----
<li><A HREF="core.html#authname">AuthName</A>
<li><A HREF="core.html#authtype">AuthType</A>
<li><A HREF="core.html#bindaddress">BindAdress</A>
+ <li><A HREF="mod_browser.html#browsermatch">BrowserMatch</A>
+ <li><A HREF="mod_browser.html#browsermatchnocase">BrowserMatchNoCase</A>
<li><A HREF="mod_proxy.html#cachedefaultexpire">CacheDefaultExpire</A>
<li><A HREF="mod_proxy.html#cachegcinterval">CacheGcInterval</A>
<li><A HREF="mod_proxy.html#cachelastmodfied">CacheLastModified</A>
1.3 +52 -28 apache/htdocs/manual/mod/mod_browser.html
Index: mod_browser.html
===================================================================
RCS file: /export/home/cvs/apache/htdocs/manual/mod/mod_browser.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -C3 -r1.2 -r1.3
*** mod_browser.html 1996/11/26 06:03:47 1.2
--- mod_browser.html 1996/12/01 08:31:23 1.3
***************
*** 9,54 ****
<H1>Apache module mod_browser</h1>
This module is contained in the <code>mod_browser.c</code> file, and
! is compiled in by default. It provides for setting various variables
! based on the User-Agent header passed to the server.<P>
<h2>Summary</h2>
!
<h2>Directives</h2>
<ul>
! <li><A HREF="#bm">BrowserMatch</A>
! <li><A HREF="#bmnocase">BrowserMatchNoCase</A>
</ul>
<hr>
! <A NAME="bm"><H2>BrowserMatch</H2></A>
!
! <STRONG>Syntax:</STRONG> BrowserMatch <EM>User-Agent Regex</EM>
<EM>Variable</EM><BR>
! <STRONG>Context:</STRONG> server config, virtual host<BR>
! <STRONG>Status:</STRONG> Base<BR>
! <STRONG>Module:</STRONG> mod_browser<BR>
! <STRONG>Compatibility:</STRONG> BrowserMatch is only available in
! Apache 1.2 and later.<P>
!
! If the user-agent passed by the browser matches the regex passed to
! browsermatch, th variable is set.<P>
!
! <A NAME="bmnocase"><H2>BrowserMatchNoCase</H2></A>
!
! <STRONG>Syntax:</STRONG> BrowserMatchNoCase <EM>User-Agent Regex</EM>
<EM>Variable</EM><BR>
! <STRONG>Context:</STRONG> server config, virtual host<BR>
! <STRONG>Status:</STRONG> Base<BR>
! <STRONG>Module:</STRONG> mod_browser<BR>
! <STRONG>Compatibility:</STRONG> BrowserMatchNoCase is only available in
! Apache 1.2 and later.<P>
- Same as BrowserMatch, but the matching is not case-sensitive.
-
- <P>
<!--#include virtual="footer.html" -->
</BODY>
</HTML>
--- 9,78 ----
<H1>Apache module mod_browser</h1>
This module is contained in the <code>mod_browser.c</code> file, and
! is compiled in by default. It provides for
! setting environment variables based on the browser.
<h2>Summary</h2>
! <p>This module allows you to set environment variables based on the name of
! the browser accessing your document, based on the <code>User-Agent</code>
! header field. This is especially useful when combined with a conditional
! HTML language such as <a href="mod_include.html">XSSI</a> or PHP, and
! can provide for simple browser-based negotiation of HTML features.</p>
!
<h2>Directives</h2>
<ul>
! <li><A HREF="#browsermatch">BrowserMatch</A>
! <li><A HREF="#browsermatchnocase">BrowserMatchNoCase</A>
</ul>
<hr>
! <A name="browsermatch"><h2>BrowserMatch</h2></A>
! <strong>Sytnax:</strong> BrowserMatch <em>regex attr1 attr2...</em><br>
! <strong>Context:</strong> server config<br>
! <strong>Status:</strong> base<br>
! <strong>Module:</strong> mod_browser<p>
!
! The BrowserMatch directive defines environment variables based on the
! User-Agent
! header. The first argument should be a POSIX.2 extended regular
! expression (similar to an egrep-style regex). The rest of the arguments
! give names of variables to set. These take the form of either
! "<code>varname</code>", "<code>!varname</code> or
! "<code>varname=value</code>". In the first form, the value will be set
! to "1". The second will remove the given variable if already defined,
! and the third will set the variable to the value given by
<code>value</code>. If a User-Agent
! string matches more than one entry, they will
! be merged. Entries are processed in the order they appear, and later
! entries can override earlier ones.
!
! <p>For example:</p>
! <pre>
! BrowserMatch ^Mozilla forms jpeg=yes browser=netscape
! BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript
! BrowserMatch MSIE !javascript
! </pre>
!
! <p><A name="browsermatchnocase"><h2>BrowserMatchNoCase</h2></A>
! <strong>Sytnax:</strong> BrowserMatchNoCase <em>regex attr1
attr2...</em><br>
! <strong>Context:</strong> server config<br>
! <strong>Status:</strong> base<br>
! <strong>Module:</strong> mod_browser
!
! <p>The <code>BrowserMatchNoCase</code> directive is semantically identical
to
! the <a href="#browsermatch"><code>BrowserMatch</code></a>
! directive. However, it provides for case-insensitive matching. For
! example:</p>
! <pre>
! BrowserMatchNoCase mac platform=macintosh
! BrowserMatchNoCase win platform=windows
! </pre>
+ <p>
<!--#include virtual="footer.html" -->
+
</BODY>
</HTML>
