Skip to content
Snippets Groups Projects
Commit 6694cf44 authored by Lucien Gentis's avatar Lucien Gentis
Browse files

Updates.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1460161 13f79535-47bb-0310-9956-ffa450edef68
parent c53fe52e
No related branches found
No related tags found
No related merge requests found
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: -->
<!-- French translation: Fabien Coelho -->
<!-- Updated by Lucien Gentis -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
......@@ -42,7 +44,7 @@ de configuration Apache.</description>
D&eacute;finition d'une macro :
<ul>
<li> dans une section &lt;Macro&gt; au style homog&egrave;ne &agrave; la
<li> dans une section &lt;Macro&gt; au style conforme &agrave; la
syntaxe des fichiers de configuration Apache.</li>
<li> l'utilisateur choisit le nom de la macro et de ses param&egrave;tres.</li>
<li> les noms de macro sont insensibles &agrave; la casse, comme les directives Apache.</li>
......@@ -50,25 +52,25 @@ de configuration Apache.</description>
<li> les param&egrave;tres d'une macro doivent avoir des noms distincts.</li>
<li> il y a une erreur si un param&egrave;tre a un nom vide.</li>
<li> la red&eacute;finition d'une macro g&eacute;n&egrave;re un avertissement.</li>
<li> des d&eacute;finitions de macros peuvent &ecirc;tre nich&eacute;es les unes dans les autres...</li>
<li> des d&eacute;finitions de macros peuvent &ecirc;tre imbriqu&eacute;es les unes dans les autres... (mais dans quel but ?)</li>
<li> les param&egrave;tres inutilis&eacute;s g&eacute;n&egrave;rent un avertissement.</li>
<li> les noms de param&egrave;tre en pr&eacute;fixe les uns des autres g&eacute;n&egrave;rent un avertissement.</li>
<li> les noms de param&egrave;tre non pr&eacute;fix&eacute;s par '<code>$%@</code>' g&eacute;n&egrave;rent un
<li> les noms de param&egrave;tre non pr&eacute;fix&eacute;s par un des caract&egrave;res '<code>$%@</code>' g&eacute;n&egrave;rent un
avertissement pour encourager cette bonne pratique.</li>
<li> les diff&eacute;rents pr&eacute;fixes propos&eacute;s permettent de g&eacute;rer les interactions
avec d'autres directives comme <directive module="core">Define</directive>.</li>
<li> un conseil : il peut &ecirc;tre utile d'ajouter des accolades autour du nom d'un
param&egrave;tre, par exemple <code>${foo}</code>, de mani&egrave;re &agrave; ce que le
param&egrave;tre puisse &ecirc;tre utilis&eacute;e avec des caract&egrave;res coll&eacute;s autour,
param&egrave;tre puisse &ecirc;tre utilis&eacute; entour&eacute; de caract&egrave;res,
par exemple <code>bla${foo}bla</code>.</li>
<li> g&eacute;n&egrave;re un avertissement si le contenu de la macro est vide.</li>
<li> g&eacute;n&egrave;re un avertissement si le syst&egrave;me d&eacute;tecte que les sections &agrave; l'int&eacute;rieur
d'une macro ne sont pas correctement nich&eacute;es.</li>
d'une macro ne sont pas correctement imbriqu&eacute;es.</li>
<li> la port&eacute;e lexicale des param&egrave;tres d'une macro est restreinte au texte
de la macro elle-m&ecirc;me... en particulier elle n'est pas propag&eacute;e aux inclusions.</li>
<li> il n'y a pas de contrainte sur le contenu d'une macro.
<p>Cela signifie que vous pouvez mettre une section perl ou n'importe
quoi d'autre dans une macro. Il n'y a pas d'autre hypoth&egrave;se sur la
quoi d'autre dans une macro. Il n'y a pas d'autre contrainte sur la
structure lexicale et syntaxique de la macro (guillemets, espaces...)
que d'attendre une s&eacute;quence de ligne avec &eacute;ventuellement des
continuations.</p></li>
......@@ -76,19 +78,19 @@ de configuration Apache.</description>
Utilisation d'une macro:
<ul>
<li> le nombre d'argument doit &ecirc;tre coh&eacute;rent avec la d&eacute;finition.</li>
<li> toutes les occurences des param&egrave;tres sont substitu&eacute;s par leur valeur.</li>
<li> en cas de conflit, le nom le plus long est choisit.</li>
<li> une r&eacute;cursion dans l'expansion d'une macro est d&eacute;tect&eacute;e et arr&ecirc;t&eacute;e avec une erreur.</li>
<li> les arguments vides g&eacute;n&egrave;rent un avertissement si ils sont utilis&eacute;s.</li>
<li> le syst&egrave;me g&eacute;n&egrave;re une description tr&egrave;s pr&eacute;cise de la localisation des erreurs.</li>
<li> les valeurs des param&egrave;tres pr&eacute;fix&eacute;s par <code>$</code> et <code>%</code> ne sont pas prot&eacute;g&eacute;s.</li>
<li> les valeurs des param&egrave;tres pr&eacute;fix&eacute;s par <code>@</code> sont prot&eacute;g&eacute;s par des guillemets.</li>
<li> le nombre d'arguments doit &ecirc;tre coh&eacute;rent avec la d&eacute;finition.</li>
<li> toutes les occurences des param&egrave;tres sont substitu&eacute;es par leur valeur.</li>
<li> en cas de conflit, le nom le plus long est choisi.</li>
<li> une r&eacute;cursion dans l'expansion d'une macro est d&eacute;tect&eacute;e et interrompue avec envoi d'un message d'erreur.</li>
<li> si un argument vide est d&eacute;tect&eacute;, un avertissement est g&eacute;n&eacute;r&eacute;.</li>
<li> le syst&egrave;me s'efforce de g&eacute;n&eacute;rer une description pr&eacute;cise de la localisation des erreurs.</li>
<li> les valeurs des param&egrave;tres pr&eacute;fix&eacute;es par <code>$</code> et <code>%</code> ne sont pas &eacute;chapp&eacute;es.</li>
<li> les valeurs des param&egrave;tres pr&eacute;fix&eacute;es par <code>@</code> sont &eacute;chapp&eacute;es par des guillemets.</li>
</ul>
Effacement de la d&eacute;finition d'une macro :
Suppression de la d&eacute;finition d'une macro :
<ul>
<li> la macro effac&eacute;e doit avoir &eacute;t&eacute; d&eacute;finie auparavant.</li>
<li> la macro supprim&eacute;e doit avoir &eacute;t&eacute; d&eacute;finie auparavant.</li>
</ul>
<highlight language="config">
......@@ -102,7 +104,9 @@ Use DirGroup /www/apache/private private
Use DirGroup /www/apache/server admin
UndefMacro DirGroup
</highlight>
</highlight>
</section>
<!-- Macro -->
......@@ -119,11 +123,12 @@ UndefMacro DirGroup
</contextlist>
<usage>
<p>La diretive <directive>Macro</directive> permet de d&eacute;finir une macro
<p>La directive <directive>Macro</directive> permet de d&eacute;finir une macro
dans un fichier de configuration Apache. Le premier argument est le nom
de la macro, et les arguments suivants sont les noms des param&egrave;tres. Il
de la macro, et les arguments suivants sont les param&egrave;tres. Il
est de bon aloi de pr&eacute;fixer les noms des param&egrave;tres d'une macro
avec un caract&egrave;re parmi '<code>$%@</code>'.
avec un caract&egrave;re parmi '<code>$%@</code>', et d'&eacute;viter d'en faire
de m&ecirc;me avec les noms de macros.
</p>
<highlight language="config">
......@@ -145,7 +150,7 @@ UndefMacro DirGroup
<!-- Use -->
<directivesynopsis>
<name>Use</name>
<description>Utilise une macro</description>
<description>Utilisation d'une macro</description>
<syntax>Use <var>nom</var> [<var>valeur1</var> ... <var>valeurN</var>]
</syntax>
<contextlist>
......@@ -155,10 +160,11 @@ UndefMacro DirGroup
</contextlist>
<usage>
<p> La directive <directive>Use</directive> permet d'utiliser une macro.
La macro est expans&eacute;e. Elle doit avoir le m&ecirc;me nombre d'argument que le
<p>La directive <directive>Use</directive> permet d'utiliser une macro.
La macro consid&eacute;r&eacute;e est expans&eacute;e. Son nombre d'arguments doit &ecirc;tre &eacute;gal au
nombre de param&egrave;tres pr&eacute;cis&eacute;s dans sa d&eacute;finition. Les valeurs pass&eacute;es en
argument sont substitu&eacute;es avant l'interpr&eacute;tation du texte de la macro.</p>
argument sont attribu&eacute;es aux param&egrave;tres correspondants et
substitu&eacute;es avant l'interpr&eacute;tation du texte de la macro.</p>
<highlight language="config">
Use LocalAccessPolicy
......@@ -166,7 +172,7 @@ Use LocalAccessPolicy
Use RestrictedAccessPolicy "192.54.172.0/24 192.54.148.0/24"
</highlight>
est &eacute;quivalent, avec les macros d&eacute;finies au dessus, &agrave; :
est &eacute;quivalent, avec les macros d&eacute;finies ci-dessus &agrave; :
<highlight language="config">
order deny,allow
......@@ -182,8 +188,8 @@ allow from 192.54.172.0/24 192.54.148.0/24
<!-- UndefMacro -->
<directivesynopsis>
<name>undefMacro</name>
<description>Efface une macro</description>
<name>UndefMacro</name>
<description>Supprime une macro</description>
<syntax>UndefMacro <var>nom</var></syntax>
<contextlist>
......@@ -193,8 +199,8 @@ allow from 192.54.172.0/24 192.54.148.0/24
</contextlist>
<usage>
<p>La directive <directive>UndefMacro</directive> efface la d&eacute;finition
d'une macro, qui doit avoir &eacute;t&eacute; d&eacute;finie auparavant.</p>
<p>La directive <directive>UndefMacro</directive> annule la d&eacute;finition
d'une macro qui doit avoir &eacute;t&eacute; d&eacute;finie auparavant.</p>
<highlight language="config">
UndefMacro LocalAccessPolicy
......
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1384410:1458798 (outdated) -->
<!-- English Revision : 1458798 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
......
......@@ -476,7 +476,7 @@ l'arborescence de d&eacute;veloppement</title>
</section>
<note>Notez que seuls les fichiers <code>.dsp</code> sont
maintenus d'une distribution <code>release</code> &agrave; l'autre. Les
fichiers <code>.mak</code> ne sont PAS r&eacute;g&eacute;n&eacute;r&eacute;s, suite &agrave;
......@@ -487,4 +487,5 @@ l'arborescence de d&eacute;veloppement</title>
fichiers <code>.mak</code> du projet. Ceci n'est pas n&eacute;cessaire
si vous effectuez la compilation depuis l'environnement
Microsoft Developer Studio.</note>
</section>
</manualpage>
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1446008:1458089 (outdated) -->
<!-- English Revision: 1458089 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment