XML updates.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1811665 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/expr.xml.fr b/docs/manual/expr.xml.fr
index 9cdb9b3ba6f367b06c59067b919ad4a4fb85c59c..00b120dcb289b42556f3dec8c28b188344a54538 100644 (file)
--- a/docs/manual/expr.xml.fr
+++ b/docs/manual/expr.xml.fr
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
-<!-- English Revision: 1788508:1811111 (outdated) -->
+<!-- English Revision: 1811111 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -85,30 +85,43 @@
       (souvent abrégée en BNF, de l'anglais Backus-Naur Form) est une notation permettant de décrire
       les règles syntaxiques des langages de programmation. En
       général, les expressions représentent des valeurs booléennes. Dans
-      ce cas, le point de départ de la BNF est <code>expr</code>.
-      Cependant, certaines directives comme <directive
-      module="mod_log_debug">LogMessage</directive> utilisent comme
+      ce cas, le point de départ de la BNF est <code>cond</code>.
+      Les directives comme
+      <directive module="core">ErrorDocument</directive>,
+      <directive module="mod_authz_core">Require</directive>,
+      <directive module="mod_authn_core">AuthName</directive>,
+      <directive module="mod_alias">Redirect</directive>,
+      <directive module="mod_headers">Header</directive>,
+      <directive module="mod_crypto">CryptoKey</directive> ou
+      <directive module="mod_log_debug">LogMessage</directive> utilisent comme
       paramètres des expressions qui représentent des chaînes de
       caractères. Dans ce cas, le point de départ de la BNF est
       <code>string</code>.
       </p>
 <blockquote>
 <pre>
-expr        ::= "<strong>true</strong>" | "<strong>false</strong>"
-              | "<strong>!</strong>" expr
-              | expr "<strong>&amp;&amp;</strong>" expr
-              | expr "<strong>||</strong>" expr
-              | "<strong>(</strong>" expr "<strong>)</strong>"
+expr        ::= cond
+              | string
+
+string      ::= substring
+              | string substring
+
+cond        ::= "<strong>true</strong>" 
+              | "<strong>false</strong>"
+              | "<strong>!</strong>" cond
+              | cond "<strong>&amp;&amp;</strong>" cond
+              | cond "<strong>||</strong>" cond
               | comp
+             | "<strong>(</strong>" cond "<strong>)</strong>"
 
 comp        ::= stringcomp
               | integercomp
               | unaryop word
               | word binaryop word
-              | word "<strong>in</strong>" "<strong>{</strong>" wordlist "<strong>}</strong>"
-              | word "<strong>in</strong>" listfunction
+              | word "<strong>in</strong>" listfunc
               | word "<strong>=~</strong>" regex
               | word "<strong>!~</strong>" regex
+             | word "<strong>in</strong>" "<strong>{</strong>" list "<strong>}</strong>"
 
 
 stringcomp  ::= word "<strong>==</strong>" word
@@ -125,35 +138,65 @@ integercomp ::= word "<strong>-eq</strong>" word | word "<strong>eq</strong>" wo
               | word "<strong>-gt</strong>" word | word "<strong>gt</strong>" word
               | word "<strong>-ge</strong>" word | word "<strong>ge</strong>" word
 
-wordlist    ::= word
-              | wordlist "<strong>,</strong>" word
-
-word        ::= word "<strong>.</strong>" word
-              | digit
+word        ::= digits
               | "<strong>'</strong>" string "<strong>'</strong>"
-              | "<strong>"</strong>" string "<strong>"</strong>"
+              | '<strong>"</strong>' string '<strong>"</strong>'
+              | word "<strong>.</strong>" word
               | variable
-             | rebackref
+             | sub
+              | join
               | function
+             | "<strong>(</strong>" word "<strong>)</strong>"
 
-string      ::= stringpart
-              | string stringpart
+list        ::= split
+              | listfunc
+              | "<strong>{</strong>" words "<strong>}</strong>"
+              | "<strong>(</strong>" list "<strong>)</strong>"
 
-stringpart  ::= cstring
+substring   ::= cstring
               | variable
-             | rebackref
 
-cstring     ::= ...
-digit       ::= [0-9]+
 
 variable    ::= "<strong>%{</strong>" varname "<strong>}</strong>"
               | "<strong>%{</strong>" funcname "<strong>:</strong>" funcargs "<strong>}</strong>"
+             | "<strong>%{:</strong>" word "<strong>:}</strong>"
+              | "<strong>%{:</strong>" cond "<strong>:}</strong>"
+              | rebackref
+
+sub         ::= "<strong>sub</strong>" ["<strong>(</strong>"] regsub "<strong>,</strong>" word ["<strong>)</strong>"]
+
+join        ::= "<strong>join</strong>" ["<strong>(</strong>"] list ["<strong>)</strong>"]
+              | "<strong>join</strong>" ["<strong>(</strong>"] list "<strong>,</strong>" word ["<strong>)</strong>"]
+
+split       ::= "<strong>split</strong>" ["<strong>(</strong>"] regany "<strong>,</strong>" list ["<strong>)</strong>"]
+              | "<strong>split</strong>" ["<strong>(</strong>"] regany "<strong>,</strong>" word ["<strong>)</strong>"]
+
+function    ::= funcname "<strong>(</strong>" words "<strong>)</strong>"
+
+listfunc    ::= listfuncname "<strong>(</strong>" words "<strong>)</strong>"
+
+words       ::= word
+              | word "<strong>,</strong>" list
 
-rebackref   ::= "<strong>$</strong>" [0-9]
+regex       ::= "<strong>/</strong>" regpattern "<strong>/</strong>" [regflags]
+              | "<strong>m</strong>" regsep regpattern regsep [regflags]
 
-function     ::= funcname "<strong>(</strong>" wordlist "<strong>)</strong>"
+regsub      ::= "<strong>s</strong>" regsep regpattern regsep string regsep [regflags]
 
-listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>"
+regany      ::= regex | regsub
+
+regsep      ::= "/" | "#" | "$" | "%" | "^" | "|" | "?" | "!" | "'" | '"' | "," | ";" | ":" | "." | "_" | "-"
+
+regflags    ::= 1*("i" | "s" | "m" | "g")
+regpattern  ::= cstring ; except enclosing <em>regsep</em>
+
+rebackref   ::= "<strong>$</strong>" DIGIT
+
+digits      ::= 1*(DIGIT)
+cstring     ::= 0*(TEXT)
+
+TEXT        ::= &lt;any OCTET except CTLs&gt;
+DIGIT       ::= &lt;any US-ASCII digit "0".."9"&gt;
 </pre>
 </blockquote>
 </section>
@@ -348,6 +391,22 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>"
     <p>Certains modules, comme <module>mod_ssl</module>, définissent des
     variables supplémentaires.</p>
 
+    <p>Toute variable peut être insérée dans une <em>chaîne</em>, et ceci non
+    seulement dans les chaînes entre quotes des expressions booléennes, mais
+    aussi dans les expressions littérales issues de la concaténation de chaînes
+    constantes et dynamiques.</p>
+
+    <p>On peut utiliser ici les variables (temporaires) du style
+    <code>%{:<em>word</em>:}</code> qui permettent d'insérer dans les deux types
+    d'expressions des variables (et des constructions) avec la syntaxe puissante
+    <em>word</em> sans entrer en conflit avec les parties constantes de telles
+    chaînes. Même si la syntaxe <em>word</em> est directement utilisable au sein
+    des expressions booléennes, ces variables sont cependant surtout utiles dans
+    les expressions littérales. Ces variables permettent d'évaluer des
+    expressions rationnelles, des substitutions, de concaténer ou dissocier des
+    chaînes et des listes au sein des expressions littérales, et donc de
+    construire des chaînes complexes dynamiquement.</p>
+
 </section>
 
 <section id="binop">
@@ -614,8 +673,8 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>"
 
     <p>En plus des fonctions dont la valeur est une chaîne, il existe
     aussi des fonctions dont la valeur est une liste, qui acceptent une
-    chaîne comme argument, et renvoient une liste de mots, autrement dit
-    une liste de chaînes. La liste de mot peut être utilisée avec
+    chaîne comme argument, et renvoient une liste , par exemple
+    une liste de chaînes. La liste peut être utilisée avec
     l'opérateur spécial <code>-in</code>. Les noms de fonctions sont
     insensibles à la casse. Les modules peuvent fournir des fonctions
     supplémentaires.</p>
@@ -687,7 +746,7 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>"
 &lt;/If&gt;
 
 
-# Function example in string context
+# Exemple de fonction dans un contexte littéral
 Header set foo-checksum "expr=%{md5:foo}"
 
 # L'exemple suivant retarde l'évaluation de la clause de condition par rapport à
@@ -695,6 +754,15 @@ Header set foo-checksum "expr=%{md5:foo}"
 Header always set CustomHeader my-value "expr=%{REQUEST_URI} =~
 m#^/special_path\.php$#"
 
+# Ajoute un en-tête permettant d'acheminer le SAN du certificat d'un client vers
+# un quelconque serveur d'arrière-plan
+RequestHeader set X-Client-SAN "expr=%{:join PeerExtList('subjectAltName'):}"
+
+# Impose la présence de l'adresse IP distante dans le SAN du certificat d'un client
+Require expr %{REMOTE_ADDR} -in split s/.*?IP Address:([^,]+)/$1/, PeerExtList('subjectAltName')
+# autre solution :
+Require expr "IP Address:%{REMOTE_ADDR}" -in split/, /, join PeerExtList('subjectAltName')
+
        </highlight>
 </section>
 
@@ -707,7 +775,7 @@ m#^/special_path\.php$#"
     <tr><th>Nom</th><th>Alternative</th> <th>Description</th></tr>
     <tr><td><code>-in</code></td>
         <td><code>in</code></td>
-        <td>chaîne contenue dans une liste de mots</td></tr>
+        <td>chaîne contenue dans une liste</td></tr>
     <tr><td><code>/regexp/</code></td>
         <td><code>m#regexp#</code></td>
         <td>Expression rationnelle (la seconde forme permet de spécifier

diff --git a/docs/manual/mod/mod_proxy.xml.fr b/docs/manual/mod/mod_proxy.xml.fr
index 264b7b664135a4a8ba8fed4017a737a8b9ea848c..dc41e959f6fb5d50db9b69eddff6093dd09890f2 100644 (file)
--- a/docs/manual/mod/mod_proxy.xml.fr
+++ b/docs/manual/mod/mod_proxy.xml.fr
@@ -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.fr.xsl"?>
-<!-- English Revision: 1805323:1810316 (outdated) -->
+<!-- English Revision: 1810316 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -317,6 +317,15 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10
 
       </note> <!-- /worker_sharing -->
 
+      <note type="warning"><title>Nom d'hôte dans l'URL</title>
+        <p>Le nom d'hôte doit commencer par une lettre [a-z]. Par exemple :</p>
+        <highlight language="config">
+ProxyPass "/apps"     "http://127"
+        </highlight>
+        <p>n'est pas valide et provoquera une erreur si une requête correspond
+       au chemin.</p>
+      </note>
+
       <p>Les workers définis explicitement sont de deux sortes :
       <dfn>workers directs</dfn> et <dfn>workers de répartition (de
       charge)</dfn>. Ils supportent de nombreux attributs de