Hi Rich, mod_macro.xml.fr misses the "English Revision" tag. Can you add one?
nd On Monday 21 January 2013 15:34:46 rbo...@apache.org wrote: > Author: rbowen > Date: Mon Jan 21 14:34:45 2013 > New Revision: 1436372 > > URL: http://svn.apache.org/viewvc?rev=1436372&view=rev > Log: > Adds mod_macro french and resolves svn (minor) svn conflicts. > > Added: > httpd/httpd/trunk/docs/manual/mod/mod_macro.html.fr > Modified: > httpd/httpd/trunk/docs/manual/mod/mod_macro.html.en > httpd/httpd/trunk/docs/manual/mod/mod_macro.xml > > Modified: httpd/httpd/trunk/docs/manual/mod/mod_macro.html.en > URL: > http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_macro.ht >ml.en?rev=1436372&r1=1436371&r2=1436372&view=diff > =========================================================================== >=== --- httpd/httpd/trunk/docs/manual/mod/mod_macro.html.en (original) +++ > httpd/httpd/trunk/docs/manual/mod/mod_macro.html.en Mon Jan 21 14:34:45 > 2013 @@ -53,8 +53,8 @@ > <div class="section"> > <h2><a name="features" id="features">Features</a></h2> > > -<p> > - Definition of a macro: > +<p>Definition of a macro:</p> > + > </p> > <ul> > <li> macro definition within a <Macro> section, following > @@ -87,8 +87,8 @@ > backslash-continued independent lines.</p></li> > </ul> > > -<p> > - Use of a macro: > +<p>Use of a macro:</p> > + > </p> > <ul> > <li> number of arguments must match the definition.</li> > @@ -102,14 +102,14 @@ > <li> <code>@</code>-prefixed parameters are escaped in quotes.</li> > </ul> > > -<p> > - Removal of a macro definition: > +<p>Removal of a macro definition:</p> > + > </p> > <ul> > <li> the macro must be already defined.</li> > </ul> > > - <pre class="prettyprint lang-config"> > +<pre class="prettyprint lang-config"> > <Macro DirGroup $dir $group> > <Directory $dir> > require group $group > @@ -120,7 +120,7 @@ Use DirGroup /www/apache/private private > Use DirGroup /www/apache/server admin > > UndefMacro DirGroup > - </pre> > +</pre> > > > </div> > @@ -188,7 +188,7 @@ UndefMacro RestrictedAccessPolicy > <tr><th><a > href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr> > <tr><th><a > href="directive-dict.html#Module">Module:</a></th><td>mod_macro</td></tr> > </table> > - <p> The <code class="directive">Use</code> directive controls the use > of a macro. + <p>The <code class="directive">Use</code> directive > controls the use of a macro. The specified macro is expanded. It must be > given the same number of arguments than in the macro definition. The > provided values are associated to their corresponding initial parameters > and are substituted > > Added: httpd/httpd/trunk/docs/manual/mod/mod_macro.html.fr > URL: > http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_macro.ht >ml.fr?rev=1436372&view=auto > =========================================================================== >=== --- httpd/httpd/trunk/docs/manual/mod/mod_macro.html.fr (added) > +++ httpd/httpd/trunk/docs/manual/mod/mod_macro.html.fr Mon Jan 21 14:34:45 > 2013 @@ -0,0 +1,240 @@ > +<?xml version="1.0" encoding="ISO-8859-1"?> > +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" > "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd";> +<html > xmlns="http://www.w3.org/1999/xhtml"; lang="fr" xml:lang="fr"><head><!-- + > XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + > This file is generated from xml source: DO NOT EDIT + > XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + > --> > +<title>mod_macro - Serveur Apache HTTP</title> > +<link href="../style/css/manual.css" rel="stylesheet" media="all" > type="text/css" title="Main stylesheet" /> +<link > href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" > media="all" type="text/css" title="No Sidebar - Default font size" /> > +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" > type="text/css" /><link rel="stylesheet" type="text/css" > href="../style/css/prettify.css" /> +<script > src="../style/scripts/prettify.js" type="text/javascript"> +</script> > + > +<link href="../images/favicon.ico" rel="shortcut icon" /></head> > +<body> > +<div id="page-header"> > +<p class="menu"><a href="../mod/">Modules</a> | <a > href="../mod/directives.html">Directives</a> | <a > href="http://wiki.apache.org/httpd/FAQ";>FAQ</a> | <a > href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du > site</a></p> +<p class="apache">Serveur Apache HTTP Version 2.5</p> > +<img alt="" src="../images/feather.gif" /></div> > +<div class="up"><a href="./"><img title="<-" alt="<-" > src="../images/left.gif" /></a></div> +<div id="path"> > +<a href="http://www.apache.org/";>Apache</a> > <a > href="http://httpd.apache.org/";>Serveur HTTP</a> > <a > href="http://httpd.apache.org/docs/";>Documentation</a> > <a > href="../">Version 2.5</a> > <a href="./">Modules</a></div> +<div > id="page-content"> > +<div id="preamble"><h1>Module Apache mod_macro</h1> > +<div class="toplang"> > +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_macro.html" > hreflang="en" rel="alternate" title="English"> en </a> | +<a > href="../fr/mod/mod_macro.html" title="Français"> fr </a></p> > +</div> > +<table class="module"><tr><th><a > href="module-dict.html#Description">Description:</a></th><td>Ce module > permet d'utiliser des macros dans les fichiers +de configuration > Apache.</td></tr> > +<tr><th><a > href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> > +<tr><th><a > href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th> ><td>macro_module</td></tr> +<tr><th><a > href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_macro.c< >/td></tr></table> +<h3>Sommaire</h3> > + > + > + <p>Ce module permet de définir et d'utiliser des macros dans les > fichiers + de configuration Apache. Ces macros peuvent avoir des > paramètres qui sont + expansés à l'utilisation (les paramètres sont > remplacés par la valeur + passée en argument), et le résultat de la > substitution est traité + normalement.</p> > +</div> > +<div id="quickview"><h3 class="directives">Directives</h3> > +<ul id="toc"> > +<li><img alt="" src="../images/down.gif" /> <a > href="#macro"><Macro></a></li> +<li><img alt="" > src="../images/down.gif" /> <a href="#undefmacro">undefMacro</a></li> > +<li><img alt="" src="../images/down.gif" /> <a href="#use">Use</a></li> > +</ul> > +<h3>Sujets</h3> > +<ul id="topics"> > +<li><img alt="" src="../images/down.gif" /> <a > href="#features">Caractéristiques</a></li> +</ul><ul class="seealso"><li><a > href="#comments_section">Commentaires</a></li></ul></div> +<div > class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" > /></a></div> +<div class="section"> > +<h2><a name="features" id="features">Caractéristiques</a></h2> > + > + <p>Définition d'une macro :</p> > + <ul> > + <li> dans une section <Macro> au style homogène à la > + syntaxe des fichiers de configuration Apache.</li> > + <li> l'utilisateur choisit le nom de la macro et de ses > paramètres.</li> + <li> les noms de macro sont insensibles à la casse, > comme les directives Apache.</li> + <li> les noms de paramètres sont par > contre sensibles à la casse.</li> + <li> les paramètres d'une macro > doivent avoir des noms distincts.</li> + <li> il y a une erreur si un > paramètre a un nom vide.</li> > + <li> la redéfinition d'une macro génère un avertissement.</li> > + <li> des définitions de macros peuvent être nichées les unes dans les > autres...</li> + <li> les paramètres inutilisés génèrent un > avertissement.</li> + <li> les noms de paramètre en préfixe les uns des > autres génèrent un avertissement.</li> + <li> les noms de paramètre non > préfixés par '<code>$%@</code>' génèrent un + avertissement pour > encourager cette bonne pratique.</li> + <li> les différents préfixes > proposés permettent de gérer les interactions + avec d'autres > directives comme <code class="directive"><a > href="../mod/core.html#define">Define</a></code>.</li> + <li> un conseil > : il peut être utile d'ajouter des accolades autour du nom d'un + > paramètre, par exemple <code>${foo}</code>, de manière à ce que le + > paramètre puisse être utilisée avec des caractères collés autour, + > par exemple <code>bla${foo}bla</code>.</li> > + <li> génère un avertissement si le contenu de la macro est vide.</li> > + <li> génère un avertissement si le système détecte que les sections à > l'intérieur + d'une macro ne sont pas correctement nichées.</li> > + <li> la portée lexicale des paramètres d'une macro est restreinte au > texte + de la macro elle-même... en particulier elle n'est pas > propagé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èse sur la + structure lexicale et syntaxique de la macro > (guillemets, espaces...) + que d'attendre une séquence de ligne > avec éventuellement des + continuations.</p></li> > + </ul> > + > + <p>Utilisation d'une macro:</p> > + <ul> > + <li> le nombre d'argument doit être cohérent avec la définition.</li> > + <li> toutes les occurences des paramètres sont substitués par leur > valeur.</li> + <li> en cas de conflit, le nom le plus long est > choisit.</li> + <li> une récursion dans l'expansion d'une macro est > détectée et arrêtée avec une erreur.</li> + <li> les arguments vides > génèrent un avertissement si ils sont utilisés.</li> + <li> le système > génère une description très précise de la localisation des erreurs.</li> + > <li> les valeurs des paramètres préfixés par <code>$</code> et > <code>%</code> ne sont pas protégés.</li> + <li> les valeurs des > paramètres préfixés par <code>@</code> sont protégés par des > guillemets.</li> + </ul> > + > + <p>Effacement de la définition d'une macro :</p> > + <ul> > + <li> la macro effacée doit avoir été définie auparavant.</li> > + </ul> > + > + <pre class="prettyprint lang-config"> > +<Macro DirGroup $dir $group> > + <Directory $dir> > + require group $group > + </Directory> > +</Macro> > + > +Use DirGroup /www/apache/private private > +Use DirGroup /www/apache/server admin > + > +UndefMacro DirGroup > + </pre> > + > +</div> > +<div class="top"><a href="#page-header"><img alt="top" > src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a > name="Macro" id="Macro"><Macro></a> <a name="macro" > id="macro">Directive</a></h2> +<table class="directive"> > +<tr><th><a > href="directive-dict.html#Description">Description:</a></th><td>Définition > d'une macro dans un fichier de configuration</td></tr> +<tr><th><a > href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> +<Macro > <var>nom</var> [<var>par1</var> .. <var>parN</var>]> +... > </Macro></code></td></tr> > +<tr><th><a > href="directive-dict.html#Context">Contexte:</a></th><td>configuration du > serveur, serveur virtuel, répertoire</td></tr> +<tr><th><a > href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> > +<tr><th><a > href="directive-dict.html#Module">Module:</a></th><td>mod_macro</td></tr> > +</table> > + <p>La diretive <code class="directive">Macro</code> permet de dé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ètres. Il + est de bon aloi de préfixer les noms des paramètres > d'une macro + avec un caractère parmi '<code>$%@</code>'. > + </p> > + > + <pre class="prettyprint lang-config"> > +<Macro LocalAccessPolicy> > + order deny,allow > + deny from all > + allow from 10.2.16.0/24 > +</Macro> > + > +<Macro RestrictedAccessPolicy $ipnumbers> > + order deny,allow > + deny from all > + allow from $ipnumbers > +</Macro> > + </pre> > + > + > +</div> > +<div class="top"><a href="#page-header"><img alt="top" > src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a > name="undefMacro" id="undefMacro">undefMacro</a> <a name="undefmacro" > id="undefmacro">Directive</a></h2> +<table class="directive"> > +<tr><th><a > href="directive-dict.html#Description">Description:</a></th><td>Efface une > macro</td></tr> +<tr><th><a > href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UndefMacro > <var>nom</var></code></td></tr> +<tr><th><a > href="directive-dict.html#Context">Contexte:</a></th><td>configuration du > serveur, serveur virtuel, répertoire</td></tr> +<tr><th><a > href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> > +<tr><th><a > href="directive-dict.html#Module">Module:</a></th><td>mod_macro</td></tr> > +</table> > + <p>La directive <code class="directive">UndefMacro</code> efface la > définition + d'une macro, qui doit avoir été définie auparavant.</p> > + > + <pre class="prettyprint lang-config"> > +UndefMacro LocalAccessPolicy > +UndefMacro RestrictedAccessPolicy > + </pre> > + > + > +</div> > +<div class="top"><a href="#page-header"><img alt="top" > src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a > name="Use" id="Use">Use</a> <a name="use" id="use">Directive</a></h2> > +<table class="directive"> > +<tr><th><a > href="directive-dict.html#Description">Description:</a></th><td>Utilise une > macro</td></tr> +<tr><th><a > href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Use > <var>nom</var> [<var>valeur1</var> ... <var>valeurN</var>] > +</code></td></tr> > +<tr><th><a > href="directive-dict.html#Context">Contexte:</a></th><td>configuration du > serveur, serveur virtuel, répertoire</td></tr> +<tr><th><a > href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> > +<tr><th><a > href="directive-dict.html#Module">Module:</a></th><td>mod_macro</td></tr> > +</table> > + <p> La directive <code class="directive">Use</code> permet d'utiliser > une macro. + La macro est expansée. Elle doit avoir le même nombre > d'argument que le + nombre de paramètres précisés dans sa définition. > Les valeurs passées en + argument sont substituées avant > l'interprétation du texte de la macro.</p> + > + <pre class="prettyprint lang-config"> > +Use LocalAccessPolicy > +... > +Use RestrictedAccessPolicy "192.54.172.0/24 192.54.148.0/24" > + </pre> > + > + > + <p>est équivalent, avec les macros définies au dessus, à :</p> > + > + <pre class="prettyprint lang-config"> > +order deny,allow > +deny from all > +allow from 10.2.16.0/24 > +... > +order deny,allow > +deny from all > +allow from 192.54.172.0/24 192.54.148.0/24 > + </pre> > + > + > +</div> > +</div> > +<div class="bottomlang"> > +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_macro.html" > hreflang="en" rel="alternate" title="English"> en </a> | +<a > href="../fr/mod/mod_macro.html" title="Français"> fr </a></p> > +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" > alt="top" /></a></div><div class="section"><h2><a id="comments_section" > name="comments_section">Commentaires</a></h2><div > class="warning"><strong>Notice:</strong><br />This is not a Q&A > section. Comments placed here should be pointed towards suggestions on > improving the documentation or server, and may be removed again by our > moderators if they are either implemented or considered invalid/off-topic. > Questions on how to manage the Apache HTTP Server should be directed at > either our IRC channel, #httpd, on Freenode, or sent to our <a > href="http://httpd.apache.org/lists.html";>mailing lists</a>.</div> +<script > type="text/javascript"><!--//--><![CDATA[//><!-- > +var comments_shortname = 'httpd'; > +var comments_identifier = > 'http://httpd.apache.org/docs/trunk/mod/mod_macro.html'; +(function(w, d) { > + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { > + d.write('<div id="comments_thread"><\/div>'); > + var s = d.createElement('script'); > + s.type = 'text/javascript'; > + s.async = true; > + s.src = 'https://comments.apache.org/show_comments.lua?site=' + > comments_shortname + '&page=' + comments_identifier; + > (d.getElementsByTagName('head')[0] || > d.getElementsByTagName('body')[0]).appendChild(s); + } > + else { > + d.write('<div id="comments_thread">Comments are disabled for this > page at the moment.<\/div>'); + } > +})(window, document); > +//--><!]]></script></div><div id="footer"> > +<p class="apache">Copyright 2013 The Apache Software Foundation.<br > />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache > License, Version 2.0</a>.</p> +<p class="menu"><a > href="../mod/">Modules</a> | <a > href="../mod/directives.html">Directives</a> | <a > href="http://wiki.apache.org/httpd/FAQ";>FAQ</a> | <a > href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du > site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- > +if (typeof(prettyPrint) !== 'undefined') { > + prettyPrint(); > +} > +//--><!]]></script> > +</body></html> > \ No newline at end of file > > Modified: httpd/httpd/trunk/docs/manual/mod/mod_macro.xml > URL: > http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_macro.xm >l?rev=1436372&r1=1436371&r2=1436372&view=diff > =========================================================================== >=== --- httpd/httpd/trunk/docs/manual/mod/mod_macro.xml (original) > +++ httpd/httpd/trunk/docs/manual/mod/mod_macro.xml Mon Jan 21 14:34:45 > 2013 @@ -37,9 +37,8 @@ > > <section id="features"><title>Features</title> > > -<p> > - Definition of a macro: > -</p> > +<p>Definition of a macro:</p> > + > <ul> > <li> macro definition within a <Macro> section, following > the apache style.</li> > @@ -71,9 +70,8 @@ > backslash-continued independent lines.</p></li> > </ul> > > -<p> > - Use of a macro: > -</p> > +<p>Use of a macro:</p> > + > <ul> > <li> number of arguments must match the definition.</li> > <li> all occurences of macro parameters are substituted by their > values.</li> @@ -86,14 +84,13 @@ > <li> <code>@</code>-prefixed parameters are escaped in quotes.</li> > </ul> > > -<p> > - Removal of a macro definition: > -</p> > +<p>Removal of a macro definition:</p> > + > <ul> > <li> the macro must be already defined.</li> > </ul> > > - <highlight language="config"> > +<highlight language="config"> > <Macro DirGroup $dir $group> > <Directory $dir> > require group $group > @@ -104,7 +101,7 @@ Use DirGroup /www/apache/private private > Use DirGroup /www/apache/server admin > > UndefMacro DirGroup > - </highlight> > +</highlight> > > </section> > > @@ -159,7 +156,7 @@ UndefMacro DirGroup > </contextlist> > > <usage> > - <p> The <directive>Use</directive> directive controls the use of a > macro. + <p>The <directive>Use</directive> directive controls the use of > a macro. The specified macro is expanded. It must be given the same number > of arguments than in the macro definition. The provided values are > associated to their corresponding initial parameters and are substituted @@ > -183,6 +180,7 @@ deny from all > allow from 192.54.172.0/24 192.54.148.0/24 > </highlight> > </usage> > + > </directivesynopsis> > > <!-- UndefMacro --> --------------------------------------------------------------------- To unsubscribe, e-mail: docs-unsubscr...@httpd.apache.org For additional commands, e-mail: docs-h...@httpd.apache.org
