httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rbo...@apache.org
Subject svn commit: r831985 - in /httpd/httpd/trunk/docs/manual/rewrite: index.html.en index.xml
Date Mon, 02 Nov 2009 17:57:34 GMT
Author: rbowen
Date: Mon Nov  2 17:57:33 2009
New Revision: 831985

URL: http://svn.apache.org/viewvc?rev=831985&view=rev
Log:
Rewrite of the overview/introduction for this section of the docs.

Modified:
    httpd/httpd/trunk/docs/manual/rewrite/index.html.en
    httpd/httpd/trunk/docs/manual/rewrite/index.xml

Modified: httpd/httpd/trunk/docs/manual/rewrite/index.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/rewrite/index.html.en?rev=831985&r1=831984&r2=831985&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/rewrite/index.html.en (original)
+++ httpd/httpd/trunk/docs/manual/rewrite/index.html.en Mon Nov  2 17:57:33 2009
@@ -23,56 +23,37 @@
 <a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 </div>
 
-      <blockquote>
-            <p>``The great thing about mod_rewrite is it gives you
-            all the configurability and flexibility of Sendmail.
-            The downside to mod_rewrite is that it gives you all
-            the configurability and flexibility of Sendmail.''</p>
 
-            <p class="cite">-- <cite>Brian Behlendorf</cite><br />
-            Apache Group</p>
-
-      </blockquote>
-
-      <blockquote>
-            <p>``Despite the tons of examples and docs,
-            mod_rewrite is voodoo. Damned cool voodoo, but still
-            voodoo.''</p>
-
-            <p class="cite">-- <cite>Brian Moore</cite><br />
-            bem@news.cmc.net</p>
-
-      </blockquote>
-
-      <p>Welcome to mod_rewrite, the Swiss Army Knife of URL
-      manipulation!</p>
-
-      <p>This module uses a rule-based rewriting engine (based on a
+      <p>mod_rewrite uses a rule-based rewriting engine (based on a
       regular-expression parser) to rewrite requested URLs on the
       fly. It supports an unlimited number of rules and an
       unlimited number of attached rule conditions for each rule to
       provide a really flexible and powerful URL manipulation
-      mechanism. The URL manipulations can depend on various tests,
-      for instance server variables, environment variables, HTTP
-      headers, time stamps and even external database lookups in
-      various formats can be used to achieve granular URL
+      mechanism. The URL manipulations can depend on various tests:
+      server variables, environment variables, HTTP
+      headers, time stamps external database lookups, and various other
+      external processes or handlers, can be used to achieve granular URL
       matching.</p>
 
-      <p>This module operates on the full URLs (including the
-      path-info part) both in per-server context
-      (<code>httpd.conf</code>) and per-directory context
-      (<code>.htaccess</code> files and <code>&lt;Directory&gt;</code>
-      blocks) and can even generate query-string
-      parts on result. The rewritten result can lead to internal
-      sub-processing, external request redirection or even to an
-      internal proxy throughput.</p>
-
-      <p>But all this functionality and flexibility has its
-      drawback: complexity. So don't expect to understand this
-      entire module in just one day.</p>
+      <p>Rewrite rules can operate on the full URLs, including the path-info
+      and query string portions, and may be used in per-server context
+      (<code>httpd.conf</code>), per-virtualhost context (<code class="directive"><a
href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
blocks), or
+      per-directory context (<code>.htaccess</code> files and <code class="directive"><a
href="../mod/core.html#directory">&lt;Directory&gt;</a></code> blocks).
The
+      rewritten result can lead to further rules, internal
+      sub-processing, external request redirection, or proxy
+      passthrough.</p>
+
+      <p>Since mod_rewrite is so powerful, it can indeed be rather
+      complex. This document supplements the <a href="../mod/mod_rewrite.html">reference
documentation</a>, and
+      attempts to allay some of that complexity, and provide highly
+      annoted examples of common scenarios that you may handle with
+      mod_rewrite. But we also attempt to show you when you should not
+      use mod_rewrite, and use other standard Apache features instead,
+      thus avoiding this unnecessary complexity.</p>
 
 </div>
-<div id="quickview"><h3>See also</h3><ul class="seealso"><li><a
href="../urlmapping.html">Mapping URLs to the Filesystem</a></li><li><a
href="http://wiki.apache.org/httpd/Rewrite">mod_rewrite
+<div id="quickview"><h3>See also</h3><ul class="seealso"><li><a
href="../mod/mod_rewrite.html">mod_rewrite reference
+documentation</a></li><li><a href="../urlmapping.html">Mapping URLs
to the Filesystem</a></li><li><a href="http://wiki.apache.org/httpd/Rewrite">mod_rewrite
 wiki</a></li><li><a href="../glossary.html">Glossary</a></li></ul></div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"
/></a></div>
 <div class="section">

Modified: httpd/httpd/trunk/docs/manual/rewrite/index.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/rewrite/index.xml?rev=831985&r1=831984&r2=831985&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/rewrite/index.xml (original)
+++ httpd/httpd/trunk/docs/manual/rewrite/index.xml Mon Nov  2 17:57:33 2009
@@ -26,56 +26,41 @@
   <title>Apache mod_rewrite</title>
 
 <summary>
-      <blockquote>
-            <p>``The great thing about mod_rewrite is it gives you
-            all the configurability and flexibility of Sendmail.
-            The downside to mod_rewrite is that it gives you all
-            the configurability and flexibility of Sendmail.''</p>
 
-            <p class="cite">-- <cite>Brian Behlendorf</cite><br />
-            Apache Group</p>
-
-      </blockquote>
-
-      <blockquote>
-            <p>``Despite the tons of examples and docs,
-            mod_rewrite is voodoo. Damned cool voodoo, but still
-            voodoo.''</p>
-
-            <p class="cite">-- <cite>Brian Moore</cite><br />
-            bem@news.cmc.net</p>
-
-      </blockquote>
-
-      <p>Welcome to mod_rewrite, the Swiss Army Knife of URL
-      manipulation!</p>
-
-      <p>This module uses a rule-based rewriting engine (based on a
+      <p>mod_rewrite uses a rule-based rewriting engine (based on a
       regular-expression parser) to rewrite requested URLs on the
       fly. It supports an unlimited number of rules and an
       unlimited number of attached rule conditions for each rule to
       provide a really flexible and powerful URL manipulation
-      mechanism. The URL manipulations can depend on various tests,
-      for instance server variables, environment variables, HTTP
-      headers, time stamps and even external database lookups in
-      various formats can be used to achieve granular URL
+      mechanism. The URL manipulations can depend on various tests:
+      server variables, environment variables, HTTP
+      headers, time stamps external database lookups, and various other
+      external processes or handlers, can be used to achieve granular URL
       matching.</p>
 
-      <p>This module operates on the full URLs (including the
-      path-info part) both in per-server context
-      (<code>httpd.conf</code>) and per-directory context
-      (<code>.htaccess</code> files and <code>&lt;Directory&gt;</code>
-      blocks) and can even generate query-string
-      parts on result. The rewritten result can lead to internal
-      sub-processing, external request redirection or even to an
-      internal proxy throughput.</p>
-
-      <p>But all this functionality and flexibility has its
-      drawback: complexity. So don't expect to understand this
-      entire module in just one day.</p>
+      <p>Rewrite rules can operate on the full URLs, including the path-info
+      and query string portions, and may be used in per-server context
+      (<code>httpd.conf</code>), per-virtualhost context (<directive
+      type="section" module="core">VirtualHost</directive> blocks), or
+      per-directory context (<code>.htaccess</code> files and <directive
+      type="section" module="core">Directory</directive> blocks). The
+      rewritten result can lead to further rules, internal
+      sub-processing, external request redirection, or proxy
+      passthrough.</p>
+
+      <p>Since mod_rewrite is so powerful, it can indeed be rather
+      complex. This document supplements the <a
+      href="../mod/mod_rewrite.html">reference documentation</a>, and
+      attempts to allay some of that complexity, and provide highly
+      annoted examples of common scenarios that you may handle with
+      mod_rewrite. But we also attempt to show you when you should not
+      use mod_rewrite, and use other standard Apache features instead,
+      thus avoiding this unnecessary complexity.</p>
 
 </summary>
 
+<seealso><a href="../mod/mod_rewrite.html">mod_rewrite reference
+documentation</a></seealso>
 <seealso><a href="../urlmapping.html">Mapping URLs to the Filesystem</a></seealso>
 <seealso><a href="http://wiki.apache.org/httpd/Rewrite">mod_rewrite
 wiki</a></seealso>



Mime
View raw message