From: Lucien Gentis <lgentis@apache.org>
Date: Sat, 11 Feb 2017 16:36:33 +0000 (+0000)
Subject: XML updates.
X-Git-Tag: 2.5.0-alpha~671
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=240dd20a51268ac93057142ea4f2f7fd9874014c;p=apache

XML updates.


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

diff --git a/docs/manual/mod/core.xml.fr b/docs/manual/mod/core.xml.fr
index 2f157b2148..6234a467b0 100644
--- a/docs/manual/mod/core.xml.fr
+++ b/docs/manual/mod/core.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: 1780918:1782140 (outdated) -->
+<!-- English Revision: 1782140 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -1369,7 +1369,7 @@ host</context>
 
 <directivesynopsis>
 <name>HttpProtocolOptions</name>
-<description>Modifie les contraintes sur les messages des requêtes HTTP</description>
+<description>Modifie les contraintes sur le format des requêtes HTTP</description>
 <syntax>HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods]
  [Allow0.9|Require1.0]</syntax>
 <default>HttpProtocolOptions Strict LenientMethods Allow0.9</default>
@@ -1434,6 +1434,16 @@ Apache</compatibility>
         # Missing CRLF<br />
         GET / HTTP/1.0\n\n
       </example>
+      <note type="warning"><title>Utilitaires en ligne de commande et CRLF</title>
+        <p>Il peut s'avérer nécessaire de forcer certains utilitaires à utiliser
+	CRLF ; si ce n'est pas le cas, httpd reverra une réponse HTTP 400 comme
+	dans le cas précédent. Par exemple, le <strong>client OpenSSL s_client
+	doit utiliser le paramètre -crlf pour fonctionner correctement</strong>.</p>
+        <p>Pour détecter des problèmes tels que l'absence de CRLF, vous pouvez
+	utiliser la directive <directive
+	module="mod_dumpio">DumpIOInput</directive> qui permet de décortiquer
+	les requêtes HTTP.</p>
+      </note>
     </dd>
     <dt>RegisteredMethods|LenientMethods</dt>
     <dd>
diff --git a/docs/manual/mod/mod_proxy.xml.fr b/docs/manual/mod/mod_proxy.xml.fr
index dbb590e11b..cbec4a3f0d 100644
--- a/docs/manual/mod/mod_proxy.xml.fr
+++ b/docs/manual/mod/mod_proxy.xml.fr
@@ -454,7 +454,7 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10
         </highlight>
 
       <p>La définition de la variable d'environnement "no-proxy" permet de
-      désactiver le traitement par <module>mod_proxy</module> de la requête
+      désactiver <module>mod_proxy</module> dans le traitement de la requête
       courante. Cette variable doit être définie via la directive <directive
       module="mod_setenvif">SetEnvIf</directive> car la directive <directive
       module="mod_env">SetEnv</directive> n'est pas évaluée assez tôt.</p>
diff --git a/docs/manual/mod/mod_proxy_fcgi.xml.fr b/docs/manual/mod/mod_proxy_fcgi.xml.fr
index 627deb31a5..df04797ff9 100644
--- a/docs/manual/mod/mod_proxy_fcgi.xml.fr
+++ b/docs/manual/mod/mod_proxy_fcgi.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: 1781329:1782194 (outdated) -->
+<!-- English Revision: 1782538 -->
 <!-- French translation : Lucien GENTIS -->
 
 <!--
@@ -246,8 +246,8 @@ certains scénarios.</p>
 <description>Permet d'adapter la valeur des variables envoyées aux serveurs
 FastCGI</description>
 <syntax>ProxyFCGISetEnvIf <var>conditional-expression</var>
-    <var>environment-variable-name</var>
-    <var>value-expression</var></syntax>
+    [!]<var>environment-variable-name</var>
+    [<var>value-expression</var>]</syntax>
 <contextlist><context>server config</context>
 <context>virtual host</context><context>directory</context>
 <context>.htaccess</context></contextlist>
@@ -283,26 +283,52 @@ détaillée dans le document <a href="../expr.html">ap_expr</a>.
    </dd>
 <dt>environment-variable-name</dt> 
 <dd>Spécifie le nom de la variable d'environnement à modifier, par exemple
-PATH_INFO.</dd>
+PATH_INFO. Si elle est précédée d'un point d'exclamation, la définition de la
+variable sera annulée.</dd>
 <dt>value-expression</dt>
 <dd>Spécifie la nouvelle valeur de la variable "environment-variable-name". On
 peut inclure des
 références arrières, comme "$1", issues de captures en provenance de
-l'expression rationnelle <var>conditional-expression</var></dd>
+l'expression rationnelle <var>conditional-expression</var>. Si cette valeur est
+omise, la variable est définie (ou sa valeur est écrasée) par une chaîne vide
+&mdash; voir cependant la note ci-après.</dd>
 </dl>
   
 <example>
-# Une modification basique, inconditionnelle<br/>
-ProxyFCGISetEnvIf "true" PATH_INFO "/example"<br/>
-<br/>
-# Utilisation d'une variable d'environnement pour spécidier la nouvelle valeur<br/>
-ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}"<br/>
+   <highlight language="config">
+# Une modification basique, inconditionnelle
+ProxyFCGISetEnvIf "true" PATH_INFO "/example"
+
+# Utilisation d'une variable d'environnement pour spécifier la nouvelle valeur
+ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}"
 <br/>
 # Utilisation de captures dans la condition et de références arrières dans la
-# nouvelle valeur<br/>
-ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m#(/.*prefix)(\d+)(.*)#" PATH_TRANSLATED "$1$3"<br/>
+# nouvelle valeur
+ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m#(/.*prefix)(\d+)(.*)#" PATH_TRANSLATED "$1$3"
+   </highlight>
 </example>
 
+<note><title>Note : Annulation définition ou valeur vide</title>
+  La ligne suivante annule la définition de la variable <code>VARIABLE</code>,
+  ce qui l'empêche d'être envoyée au serveur FastCGI :
+
+    <highlight language="config">ProxyFCGISetEnvIf true !VARIABLE</highlight>
+
+  La ligne suivante, quant à elle, efface la <em>valeur</em> de la variable
+  <code>VARIABLE</code> en lui affectant la chaîne vide ; cette variable
+  <code>VARIABLE</code> sera alors tout de même envoyée au serveur FastCGI :
+
+    <highlight language="config">ProxyFCGISetEnvIf true VARIABLE</highlight>
+
+  La spécification CGI/1.1 <a
+  href="https://tools.ietf.org/html/rfc3875#section-4.1">ne fait pas de
+  distinction</a> entre une variable contenant une chaîne vide et une variable qui
+  n'existe pas. De nombreuses implémentations CGI et FastCGI font cependant
+  cette distinction (ou permettent aux scripts de la faire). Le choix de celle
+  que vous allez utiliser dépend de votre implémentation et de la raison qui
+  vous pousse à modifier cette variable.
+</note>
+
 </usage>
 </directivesynopsis>
 
diff --git a/docs/manual/mod/mod_remoteip.xml.fr b/docs/manual/mod/mod_remoteip.xml.fr
index f476b355e8..c27d8f4d95 100644
--- a/docs/manual/mod/mod_remoteip.xml.fr
+++ b/docs/manual/mod/mod_remoteip.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: 1776624:1781701 (outdated) -->
+<!-- English Revision: 1781701 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -258,6 +258,7 @@ RemoteIPProxiesHeader X-Forwarded-By
 <syntax>RemoteIPProxyProtocol On|Optional|Off</syntax>
 <contextlist><context>server config</context><context>virtual host</context>
 </contextlist>
+<compatibility>Disponible à partir de la version 2.4.26 du serveur HTTP Apache</compatibility>
 
 <usage>
     <p>La directive <directive>RemoteIPProxyProtocol</directive> permet
diff --git a/docs/manual/mod/mod_setenvif.xml.fr b/docs/manual/mod/mod_setenvif.xml.fr
index 7f4db67403..027feaf67f 100644
--- a/docs/manual/mod/mod_setenvif.xml.fr
+++ b/docs/manual/mod/mod_setenvif.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: 1727647:1782252 (outdated) -->
+<!-- English Revision: 1782252 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -151,7 +151,7 @@ attributs de la requête</description>
     <p>La directive <directive>SetEnvIf</directive> permet de définir
     des variables d'environnement en fonction des attributs de la
     requête. L'<em>attribut</em> spécifié comme premier argument peut
-    se présenter sous l'une des trois formes suivantes :</p>
+    se présenter sous l'une des formes suivantes :</p>
 
 <ol>
 <li>Un champ d'en-tête de requête HTTP (voir la <a
diff --git a/docs/manual/vhosts/examples.xml.fr b/docs/manual/vhosts/examples.xml.fr
index 7d6551cd15..f33560e058 100644
--- a/docs/manual/vhosts/examples.xml.fr
+++ b/docs/manual/vhosts/examples.xml.fr
@@ -1,7 +1,7 @@
 <?xml version='1.0' ?>
 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1746754:1781930 (outdated) -->
+<!-- English Revision: 1781930 -->
 <!-- French translation by Vincent Deffontaines, Alain B.  -->
 <!-- reviewed by Lucien Gentis -->
 
@@ -29,12 +29,26 @@
 <summary>
 
     <p>Le but de ce document est d'essayer de répondre aux questions 
-    les plus répandues sur la configuration des <a href="index.html">serveurs virtuels</a>. 
+    les plus fréquentes sur la configuration des <a href="index.html">serveurs virtuels</a>. 
     Les scénarios présentés ici se rencontrent quand plusieurs 
-    serveurs Webs doivent tourner sur une seule et même machine au 
+    serveurs web doivent tourner sur une seule et même machine au 
     moyen de serveurs virtuels <a href="name-based.html">par nom</a> 
     ou <a href="ip-based.html">par IP</a>.</p>
 
+    <note><title>Note à propos du contexte de configuration</title><p>Les serveurs virtuels
+    doivent être spécifiés au niveau de la configuration globale du serveur.
+    Certaines distributions tierces du serveur peuvent cependant utiliser un fichier de
+    configuration initial alternatif ou des fichiers de configuration multiples
+    qui acceptent tous des directives à portée globale. Elles peuvent aussi
+    proposer une convention de spécification des serveurs virtuels au sein de
+    ces fichiers multiples qui seront eux-mêmes inclus dans le fichier de
+    configuration global via la directive <directive
+    module="core">Include</directive>. Vous pourrez trouver plus de détails dans
+    le README de la distribution tierce, tel que
+    /usr/share/doc/apache2/README.Debian.gz pour les distributions basées sur
+    Debian et Ubuntu.</p>
+    </note>
+
 </summary>
 
   <section id="purename"><title>Fonctionnement de plusieurs serveurs