From af9e382b8333b8b450a538b4289ffb07508b4033 Mon Sep 17 00:00:00 2001
From: Daniel Earl Poirier <poirier@apache.org>
Date: Mon, 14 Dec 2009 19:03:49 +0000
Subject: [PATCH] Update transforms.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@890441 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/glossary.html.en      |  4 +-
 docs/manual/mod/core.html.tr.utf8 |  1 +
 docs/manual/mod/core.xml.de       |  2 +-
 docs/manual/mod/core.xml.ja       |  2 +-
 docs/manual/mod/core.xml.meta     |  2 +-
 docs/manual/mod/core.xml.tr       |  2 +-
 docs/manual/mod/mod_alias.html.en | 73 ++++++++++++++++++++++++++++++-
 7 files changed, 80 insertions(+), 6 deletions(-)

diff --git a/docs/manual/glossary.html.en b/docs/manual/glossary.html.en
index 282f8fd7d00..f07ca08810d 100644
--- a/docs/manual/glossary.html.en
+++ b/docs/manual/glossary.html.en
@@ -363,7 +363,9 @@
       attributes against collections of files or resources in very flexible ways
       - for example, all .gif and .jpg files under any "images" directory could
       be written as "<code>/images/.*(jpg|gif)$</code>".  Apache uses Perl
-      Compatible Regular Expressions provided by the <a href="http://www.pcre.org/">PCRE</a> library.
+      Compatible Regular Expressions provided by the <a href="http://www.pcre.org/">PCRE</a> library.  You can find more documentation
+      about PCRE's regular expression syntax at that site, or at
+      <a href="http://en.wikipedia.org/wiki/PCRE">Wikipedia</a>.
     </dd>
 
     <dt><a name="reverseproxy" id="reverseproxy">Reverse Proxy</a></dt>
diff --git a/docs/manual/mod/core.html.tr.utf8 b/docs/manual/mod/core.html.tr.utf8
index 1b8e930c9b1..9b8faa6b7de 100644
--- a/docs/manual/mod/core.html.tr.utf8
+++ b/docs/manual/mod/core.html.tr.utf8
@@ -26,6 +26,7 @@
 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../tr/mod/core.html" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 </div>
+<div class="outofdate">Bu çeviri güncel olmayabilir. Son değişiklikler için İngilizce sürüm geçerlidir.</div>
 <table class="module"><tr><th><a href="module-dict.html#Description">Açıklama:</a></th><td>Apache HTTP Sunucusunda daima mevcut olan çekirdek
  özellikler</td></tr>
 <tr><th><a href="module-dict.html#Status">Durum:</a></th><td>Çekirdek</td></tr></table>
diff --git a/docs/manual/mod/core.xml.de b/docs/manual/mod/core.xml.de
index 8f147826235..f4e9f796e58 100644
--- a/docs/manual/mod/core.xml.de
+++ b/docs/manual/mod/core.xml.de
@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
-<!-- English Revision: 167959:814629 (outdated) -->
+<!-- English Revision: 167959:890372 (outdated) -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/manual/mod/core.xml.ja b/docs/manual/mod/core.xml.ja
index e4c43e05e45..aa5d91e246b 100644
--- a/docs/manual/mod/core.xml.ja
+++ b/docs/manual/mod/core.xml.ja
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
-<!-- English Revision: 608059:814629 (outdated) -->
+<!-- English Revision: 608059:890372 (outdated) -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/manual/mod/core.xml.meta b/docs/manual/mod/core.xml.meta
index d12de536ef2..7944255fe81 100644
--- a/docs/manual/mod/core.xml.meta
+++ b/docs/manual/mod/core.xml.meta
@@ -10,6 +10,6 @@
     <variant outdated="yes">de</variant>
     <variant>en</variant>
     <variant outdated="yes">ja</variant>
-    <variant>tr</variant>
+    <variant outdated="yes">tr</variant>
   </variants>
 </metafile>
diff --git a/docs/manual/mod/core.xml.tr b/docs/manual/mod/core.xml.tr
index 73d9e5b2968..3629411b769 100644
--- a/docs/manual/mod/core.xml.tr
+++ b/docs/manual/mod/core.xml.tr
@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.tr.xsl"?>
-<!-- English Revision: 814629 -->
+<!-- English Revision: 814629:890372 (outdated) -->
 <!-- =====================================================
  Translated by: Nilgün Belma Bugüner <nilgun belgeler.org>
    Reviewed by: Orhan Berent <berent belgeler.org>
diff --git a/docs/manual/mod/mod_alias.html.en b/docs/manual/mod/mod_alias.html.en
index 5d0d1fe4afc..032431c3220 100644
--- a/docs/manual/mod/mod_alias.html.en
+++ b/docs/manual/mod/mod_alias.html.en
@@ -189,13 +189,65 @@ expressions</td></tr>
       AliasMatch ^/icons(.*) /usr/local/apache/icons$1
     </code></p></div>
 
-    <p>It is also possible to construct an alias with case-insensitive
+    <p>The full range of <a class="glossarylink" href="../glossary.html#regex" title="see glossary">regular expression</a>
+    power is available.  For example,
+    it is possible to construct an alias with case-insensitive
     matching of the url-path:</p>
 
     <div class="example"><p><code>
       AliasMatch (?i)^/image(.*) /ftp/pub/image$1
     </code></p></div>
 
+    <p>One subtle difference
+    between <code class="directive"><a href="#alias">Alias</a></code>
+    and <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> is
+    that <code class="directive"><a href="#alias">Alias</a></code> will
+    automatically copy any additional part of the URI, past the part
+    that matched, onto the end of the file path on the right side,
+    while <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> will
+    not.  This means that in almost all cases, you will want the
+    regular expression to match the entire request URI from beginning
+    to end, and to use substitution on the right side.</p>
+
+    <p>In other words, just changing 
+    <code class="directive"><a href="#alias">Alias</a></code> to
+    <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> will not
+    have the same effect.  At a minimum, you need to
+    add <code>^</code> to the beginning of the regular expression
+    and add <code>(.*)$</code> to the end, and add <code>$1</code> to
+    the end of the replacement.</p>
+
+    <p>For example, suppose you want to replace this with AliasMatch:</p>
+
+    <div class="example"><p><code>
+      Alias /image/ /ftp/pub/image/
+    </code></p></div>
+
+    <p>This is NOT equivalent - don't do this!  This will send all
+    requests that have /image/ anywhere in them to /ftp/pub/image/:</p>
+
+    <div class="example"><p><code>
+      AliasMatch /image/ /ftp/pub/image/
+    </code></p></div>
+
+    <p>This is what you need to get the same effect:</p>
+
+    <div class="example"><p><code>
+      AliasMatch ^/image/(.*)$ /ftp/pub/image/$1
+    </code></p></div>
+
+    <p>Of course, there's no point in
+    using <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>
+    where <code class="directive"><a href="#alias">Alias</a></code> would
+    work.  <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> lets
+    you do more complicated things.  For example, you could
+    serve different kinds of files from different directories:</p>
+
+    <div class="example"><p><code>
+      AliasMatch ^/image/(.*)\.jpg$ /files/jpg.images/$1.jpg<br />
+      AliasMatch ^/image/(.*)\.gif$ /files/gif.images/$1.gif
+    </code></p></div>
+
 
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -432,6 +484,25 @@ and designates the target as a CGI script</td></tr>
       ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1
     </code></p></div>
 
+    <p>As for AliasMatch, the full range of <a class="glossarylink" href="../glossary.html#rexex" title="see glossary">regular
+    expression</a> power is available.
+    For example, it is possible to construct an alias with case-insensitive
+    matching of the url-path:</p>
+
+    <div class="example"><p><code>
+      ScriptAliasMatch (?i)^/cgi-bin(.*) /usr/local/apache/cgi-bin$1
+    </code></p></div>
+
+    <p>The considerations related to the difference between
+    <code class="directive"><a href="#alias">Alias</a></code> and
+    <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>
+    also apply to the difference between
+    <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> and
+    <code class="directive"><a href="#scriptaliasmatch">ScriptAliasMatch</a></code>.
+    See <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> for
+    details.</p>
+
+
 </div>
 </div>
 <div class="bottomlang">
-- 
2.47.3