diff --git a/docs/fr/designers/language-basic-syntax/language-escaping.xml b/docs/fr/designers/language-basic-syntax/language-escaping.xml
index cff4519e..96ab67b1 100644
--- a/docs/fr/designers/language-basic-syntax/language-escaping.xml
+++ b/docs/fr/designers/language-basic-syntax/language-escaping.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.4 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
 <sect1 id="language.escaping">
  <title>Désactiver l'analyse de Smarty</title>
  <para>
@@ -8,7 +8,7 @@
   certaines sections que seraient analysées sinon. Un exemple classique est 
   l'incorporation de code Javascript ou CSS dans les templates. Le problème 
   est que ces langages utilisent les caractères { et }, qui sont aussi les 
-  délimiteurs Smarty par défaut.
+  <link linkend="language.function.ldelim">délimiteurs</link> Smarty par défaut.
  </para>
 
  <para>
@@ -22,8 +22,8 @@
   linkend="language.function.literal">{literal} .. {/literal}</link>.
   Similairement à l'utilisation d'entités HTML, vous pouvez utiliser <link
   linkend="language.function.ldelim">{ldelim}</link> et <link
-  linkend="language.function.ldelim">{rdelim}</link>, ou <link 
-  linkend="language.variables.smarty.ldelim">{$smarty.ldelim}</link> pour 
+  linkend="language.function.ldelim">{rdelim}</link>, ou <link
+  linkend="language.variables.smarty.ldelim">{$smarty.ldelim}</link> pour
   afficher les délimiteurs.
  </para>
 
@@ -63,10 +63,11 @@ dosomething();
   </programlisting>
  </example>
  <para>
-  Voir aussi 
+  Voir aussi
   <link linkend="language.modifier.escape">les modifieurs d'échappement</link>.
  </para>
 </sect1>
+
  <!-- Keep this comment at the end of the file
  Local variables:
  mode: sgml
@@ -86,4 +87,4 @@ dosomething();
  vim600: syn=xml fen fdm=syntax fdl=2 si
  vim: et tw=78 syn=sgml
  vi: ts=1 sw=1
- -->
+ -->
\ No newline at end of file
diff --git a/docs/fr/designers/language-basic-syntax/language-math.xml b/docs/fr/designers/language-basic-syntax/language-math.xml
index 275416cd..5c51f6e3 100644
--- a/docs/fr/designers/language-basic-syntax/language-math.xml
+++ b/docs/fr/designers/language-basic-syntax/language-math.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.2 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: gerald Status: ready -->
 <sect1 id="language.math">
  <title>Opérations mathématiques</title>
  <para>
@@ -27,7 +27,12 @@
 ]]>
   </programlisting>
  </example>
+
+ <para>
+  Voir aussi la fonction <link linkend="language.function.math">{math}</link>.
+ </para>
 </sect1>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -47,4 +52,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
+-->
\ No newline at end of file
diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-attributes.xml b/docs/fr/designers/language-basic-syntax/language-syntax-attributes.xml
index e5bdf578..a277a156 100644
--- a/docs/fr/designers/language-basic-syntax/language-syntax-attributes.xml
+++ b/docs/fr/designers/language-basic-syntax/language-syntax-attributes.xml
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.2 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: gerald Status: ready -->
 <sect1 id="language.syntax.attributes">
  <title>Paramètres</title>
  <para>
-  La plupart des fonctions attendent des paramètres qui régissent leur
+  La plupart des <link linkend="language.syntax.functions">fonctions</link>
+  attendent des paramètres qui régissent leur
   comportement. Les paramètres des fonctions Smarty sont très proches des
   attributs des balises HTML. Les valeurs numériques n'ont pas besoin d'être
   entourées par des guillemets, par contre, ces guillemets sont recommandées lors
@@ -20,22 +21,25 @@
  <example>
   <title>Paramètres de fonction, syntaxe</title>
 <programlisting>
-<![CDATA[
+ <![CDATA[
 {include file="header.tpl"}
 
+{include file="header.tpl" attrib_name="attrib value"}
+
 {include file=$includeFile}
 
-{include file=#includeFile#}
+{include file=#includeFile# title="Smarty est cool"}
 
 {html_select_date display_days=yes}
 
 <select name="company">
-{html_options values=$vals selected=$selected output=$output}
+ {html_options options=$choices selected=$selected}
 </select>
 ]]>
 </programlisting>
  </example>
 </sect1>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -55,4 +59,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
+-->
\ No newline at end of file
diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml b/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml
index 98e321e0..9d0734e4 100644
--- a/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml
+++ b/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml
@@ -1,37 +1,46 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.2 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: gerald Status: ready -->
 <sect1 id="language.syntax.comments">
  <title>Commentaires</title>
  <para>
-  Les commentaires dans Smarty sont entourés d'asterisques, de cette
-  façon : {* voici un commentaire *}
-  Les commentaires Smarty ne sont pas affichés dans la sortie finale du
-  template.
+  Les commentaires dans Smarty sont entourés d'asterisques,
+  et entourés par le <link linkend="variable.left.delimiter">délimiteurs</link>
+  de cette façon : {* voici un commentaire *}
+  Les commentaires Smarty ne sont PAS affichés dans la sortie finale du
+  template, différemment des &lt;!-- commentaires HTML --&gt;.
   Ils sont utilisés pour des notes internes, dans le template, pour aider
   les développeurs à en comprendre le fonctionnement.
  </para>
  <example>
   <title>Commentaires</title>
-<programlisting>
+  <programlisting>
 <![CDATA[
-{* Smarty *}
+<body>
+ {* ces multi-lignes sont des commentaires
+     qui ne sont pas envoyées au navigateur
+*}
 
 {* Inclusion de l'en tête *}
 {include file="header.tpl"}
 
+
+{* Note aux développeurs :  $includeFile est assigné au script foo.php  *}
+<!-- ce commentaire html est envoyé au navigateur -->
 {include file=$includeFile}
 
 {include file=#includeFile#}
 
 {* affiche des listes déroulantes *}
-<SELECT name=company>
-{html_options values=$vals selected=$selected output=$output}
-</SELECT>
+<select name="company">
+ {html_options options=$vals selected=$selected_id}
+</select>
+</body>
 ]]>
 </programlisting>
  </example>
 </sect1>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -51,4 +60,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
+-->
\ No newline at end of file
diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml b/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml
index acca40a5..dc57afe3 100644
--- a/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml
+++ b/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml
@@ -1,12 +1,13 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.5 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
 <sect1 id="language.syntax.functions">
  <title>Fonctions</title>
  <para>
   Les balises Smarty affichent une <link linkend="language.variables">variable</link>
   ou invoquent une fonction. Les fonctions sont appelées
-  lorsqu'elles sont entourées, ainsi que leurs paramètres, des délimiteurs Smarty.
+  lorsqu'elles sont entourées, ainsi que leurs
+  <link linkend="language.syntax.attributes">paramètres</link>, des délimiteurs Smarty.
   Par exemple : {nomfonction par1="val" par2="val"}.
  </para>
  <example>
@@ -29,17 +30,23 @@
  <para>
   Les <link linkend="language.builtin.functions">fonctions natives</link> et les 
   <link linkend="language.custom.functions">fonctions utilisateurs</link> ont toutes deux la même
-  syntaxe, dans les templates. Les fonctions natives sont relatives
-  au traitement interne de Smarty, comme par exemple <link
-  linkend="language.function.if">{if}</link>,
-  <link linkend="language.function.section">{section}</link> et 
-  <link linkend="language.function.strip">{strip}</link>. 
-  Elles ne peuvent être modifiées. Les fonctions utilisateurs sont des fonctions additionnelles,
-  implémentées par l'intermédiaire de <link linkend="plugins">plugins</link>. 
+  syntaxe, dans les templates.
+ </para>
+ <para>
+  Les fonctions natives sont relatives
+  au traitement <emphasis role="bold">interne</emphasis> de Smarty, 
+  comme <link linkend="language.function.if">{if}</link>,
+  <link linkend="language.function.section">{section}</link> et
+  <link linkend="language.function.strip">{strip}</link>.
+  Elles ne peuvent être modifiées.
+ </para>
+ <para>
+  Les fonctions utilisateurs sont des fonctions <emphasis role="bold">additionnelles</emphasis>,
+  implémentées par l'intermédiaire de <link linkend="plugins">plugins</link>.
   Elles peuvent être modifiées pour correspondre
   à vos besoins, et vous pouvez en créer de nouvelles.
   <link linkend="language.function.html.options">{html_options}</link> et
-  <link linkend="language.function.html.select.date">{html_select_date}</link> 
+  <link linkend="language.function.html.popup">{popup}</link> 
   sont deux exemples de fonctions utilisateurs.
  </para>
 </sect1>
diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml b/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml
index 2bcbf4da..2812289e 100644
--- a/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml
+++ b/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml
@@ -1,18 +1,18 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
 <sect1 id="language.syntax.variables">
  <title>Variables</title>
  <para>
   Les variables de template commence par un signe dollar (<literal>$</literal>).
   Elles peuvent contenir des nombres, des lettres et des underscores, tout
-  comme une <ulink url="&url.php-manual;language.variables">variable PHP</ulink>. Vous pouvez référencer des tableaux indexés
+  comme une <ulink url="&url.php-manual;language.variables">variable PHP</ulink>. 
+  Vous pouvez référencer des tableaux indexés
   numériquement ou non. Vous pouvez aussi référencer des propriétés d'objet 
-  ainsi que des méthodes. Les <link linkend="language.config.variables">variables des fichiers de 
-  configuration</link> sont
-  une exception à la synthaxe utilisant un signe dollar. Elles peuvent être 
-  référencées en les entourant du signe dièse (<literal>#</literal>) ou
-  avec la variable spéciale <link linkend="language.variables.smarty.config">$smarty.config</link>.
+  ainsi que des méthodes. Les <link linkend="language.config.variables">variables des fichiers de
+  configuration</link> sont une exception à la synthaxe utilisant un signe dollar. Elles peuvent être
+  référencées en les entourant du signe dièse (<literal>#</literal>) ou avec la variable spéciale
+  <link linkend="language.variables.smarty.config">$smarty.config</link>.
  </para>
  <example>
   <title>Variables</title>