diff --git a/docs/fr/programmers/api-functions/api-clear-config.xml b/docs/fr/programmers/api-functions/api-clear-config.xml
index 228c2df1..f4d35314 100644
--- a/docs/fr/programmers/api-functions/api-clear-config.xml
+++ b/docs/fr/programmers/api-functions/api-clear-config.xml
@@ -1,13 +1,14 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+
 <refentry id="api.clear.config">
  <refnamediv>
-  <refname>clear_config</refname>
-  <refpurpose></refpurpose>
+  <refname>clear_config()</refname>
+  <refpurpose>Efface toutes les variables de configuration assignées</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>void</type><methodname>clear_config</methodname>
    <methodparam choice="opt"><type>string</type><parameter>var</parameter></methodparam>
@@ -18,7 +19,7 @@
    Si un nom de variable est spécifié, seule cette variable sera effacée.
   </para>
   <example>
-   <title>Exemple avec clear_config</title>
+   <title>Exemple avec clear_config()</title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -33,6 +34,7 @@ $smarty->clear_config('foobar');
   </example>
   <para>
    Voir aussi les
+   <link linkend="api.get.config.vars">get_config_vars()</link>,
    <link linkend="language.config.variables">variables de configuration</link>,
    <link linkend="config.files">config files</link>,
    <link linkend="language.function.config.load">{config_load}</link>,
diff --git a/docs/fr/programmers/api-functions/api-config-load.xml b/docs/fr/programmers/api-functions/api-config-load.xml
index 38e240a3..4c84d38c 100644
--- a/docs/fr/programmers/api-functions/api-config-load.xml
+++ b/docs/fr/programmers/api-functions/api-config-load.xml
@@ -1,13 +1,14 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+
 <refentry id="api.config.load">
  <refnamediv>
-  <refname>config_load</refname>
-  <refpurpose></refpurpose>
+  <refname>config_load()</refname>
+  <refpurpose>Charge les données d'un fichier de configuration et les assigne au template</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>void</type><methodname>config_load</methodname>
    <methodparam><type>string</type><parameter>file</parameter></methodparam>
@@ -34,7 +35,7 @@
    </para>
   </note>
   <example>
-   <title>Exemple avec config_load</title>
+   <title>Exemple avec config_load()</title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -50,11 +51,13 @@ $smarty->config_load('my.conf','foobar');
   <para>
    Voir aussi
    <link linkend="language.function.config.load">{config_load}</link>,
+   <link linkend="api.get.config.vars">get_config_vars()</link>,
    <link linkend="api.clear.config">clear_config()</link> et les
    <link linkend="language.config.variables">variables de configuration</link>.
   </para>
  </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -74,4 +77,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/programmers/api-functions/api-display.xml b/docs/fr/programmers/api-functions/api-display.xml
index 05bfecd9..a24c4de3 100644
--- a/docs/fr/programmers/api-functions/api-display.xml
+++ b/docs/fr/programmers/api-functions/api-display.xml
@@ -1,18 +1,20 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
+
 <refentry id="api.display">
  <refnamediv>
-  <refname>display</refname>
-  <refpurpose></refpurpose>
+  <refname>display()</refname>
+  <refpurpose>Affiche le template</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>void</type><methodname>display</methodname>
    <methodparam><type>string</type><parameter>template</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>cache_id</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>compile_id</parameter>
+   </methodparam>
   </methodsynopsis>
   <para>
    Utilisée pour afficher un template. Il faut fournir un type et un
@@ -24,7 +26,7 @@
   </para>
   &parameter.compileid;
   <example>
-   <title>Exemple avec display</title>
+   <title>Exemple avec display()</title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -60,7 +62,7 @@ $smarty->display("index.tpl");
    Utilisez la syntaxe des <link
    linkend="template.resources">ressources templates</link>
    pour afficher des fichiers en-dehors du répertoire
-   $template_dir.
+   <link linkend="variable.template.dir">$template_dir</link>.
   </para>
   <example>
    <title>Exemples de fonction d'affichage de ressources templates</title>
@@ -68,16 +70,16 @@ $smarty->display("index.tpl");
 <![CDATA[
 <?php
 // chemin absolu
-$smarty->display("/usr/local/include/templates/header.tpl");
+$smarty->display('/usr/local/include/templates/header.tpl');
 
 // chemin absolu (mêm chose)
-$smarty->display("file:/usr/local/include/templates/header.tpl");
+$smarty->display('file:/usr/local/include/templates/header.tpl');
 
 // chemin absolu Windows (on DOIT utiliser le préfixe "file:")
-$smarty->display("file:C:/www/pub/templates/header.tpl");
+$smarty->display('file:C:/www/pub/templates/header.tpl');
 
 // inclue à partir de la ressource template nommée "db"
-$smarty->display("db:header.tpl");
+$smarty->display('db:header.tpl');
 ?>
 ]]>
    </programlisting>
diff --git a/docs/fr/programmers/api-functions/api-fetch.xml b/docs/fr/programmers/api-functions/api-fetch.xml
index 954500f2..abe09410 100644
--- a/docs/fr/programmers/api-functions/api-fetch.xml
+++ b/docs/fr/programmers/api-functions/api-fetch.xml
@@ -1,21 +1,24 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
+
 <refentry id="api.fetch">
  <refnamediv>
-  <refname>fetch</refname>
-  <refpurpose></refpurpose>
+  <refname>fetch()</refname>
+  <refpurpose>Retourne le résultat du template</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>string</type><methodname>fetch</methodname>
    <methodparam><type>string</type><parameter>template</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>cache_id</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>$compile_id</parameter>
+   </methodparam>
   </methodsynopsis>
   <para>
-   Utilisée pour renvoyer le résultat du template plutôt que de l'afficher.
+   Utilisée pour renvoyer le résultat du template plutôt que de
+   l'<link linkend="api.display">afficher</link>.
    Il faut passer un type et un chemin de <link
    linkend="template.resources">ressource template</link>
    valides. Vous pouvez passer un identifiant de cache en deuxième
@@ -23,38 +26,39 @@
    </link> pour plus de renseignements.
   </para>
   &parameter.compileid;
+
   <para>
    <example>
-    <title>Exemple avec fetch</title>
+    <title>Exemple avec fetch()</title>
     <programlisting role="php">
 <![CDATA[
 <?php
-include("Smarty.class.php");
+include('Smarty.class.php');
 $smarty = new Smarty;
 
 $smarty->caching = true;
 
 // ne fait un appel à la base de données que si le fichier
 // de cache n'existe pas
-if(!$smarty->is_cached("index.tpl"))
+if(!$smarty->is_cached('index.tpl'))
 {
 
     // quelques données
-    $address = "245 N 50th";
+    $address = '245 N 50th';
     $db_data = array(
-                        "Ville" => "Lincoln",
-                        "Pays" => "Nebraska",
-                        "Code postal" = > "68502"
+                        'Ville' => 'Lincoln',
+                        'Pays' => 'Nebraska',
+                        'Code postal' = > '68502'
     );
 
-    $smarty->assign("Nom","Fred");
-    $smarty->assign("Adresse",$address);
+    $smarty->assign('Nom','Fred');
+    $smarty->assign('Adresse',$address);
     $smarty->assign($db_data);
 
 }
 
 // récupère le résultat
-$output = $smarty->fetch("index.tpl");
+$output = $smarty->fetch('index.tpl');
 
 // fait quelque chose avec $output ici
 
@@ -64,8 +68,66 @@ echo $output;
     </programlisting>
    </example>
   </para>
+
   <para>
-   Voir aussi 
+   <example>
+    <title>Utilisation de fetch() pour envoyer un email</title>
+    <para>
+     Le template email_body.tpl
+    </para>
+    <programlisting>
+<![CDATA[
+Cher {$contact.name},
+
+Bienvenu et merci d'être devenu membre de notre groupe d'utilisateur,
+
+Cliquez sur le lien ci-dessous pour vous identifier avec votre nom d'utilisateur '{$contact.login_id}'
+et vous pourrez utiliser nos forums.
+
+http://{$smarty.server.SERVER_NAME}/index.php?page=login
+
+Liste principale
+Quelques groupes d'utilisateurs
+
+{include file="email_disclaimer.tpl"}
+]]>
+    </programlisting>
+    <para>
+     Le template email_disclaimer.tpl qui utilise le modificateur
+     <link linkend="language.function.textformat">{textformat}</link>.
+    </para>
+    <programlisting>
+<![CDATA[
+{textformat wrap=40}
+Unless you are named "{$contact.name}", you may read only the "odd numbered
+words" (every other word beginning with the first) of the message above. If you have
+violated that, then you hereby owe the sender 10 GBP for each even
+numbered word you have read
+{/textformat}
+]]>
+    </programlisting>
+    <para>
+     et le script PHP utilisant la fonction PHP
+     <ulink url="&url.php-manual;function.mail">mail()</ulink>
+    </para>
+    <programlisting role="php">
+     <![CDATA[
+<?php
+
+// Récupération du contact depuis une base de données eg utilisation de pear ou adodb
+$query  = 'select name, email, login_id from contacts where contact_id='.$contact_id;
+$contact = $db->getRow($sql);
+$smarty->assign('contact', $contact);
+
+mail($contact['email'], 'Subject', $smarty->fetch('email_body.tpl'));
+
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+  <para>
+   Voir aussi
    <link linkend="language.function.fetch">{fetch}</link>
    <link linkend="api.display">display()</link>,
    <link linkend="language.function.eval">{eval}</link> et
diff --git a/docs/fr/programmers/api-functions/api-get-config-vars.xml b/docs/fr/programmers/api-functions/api-get-config-vars.xml
index d166332a..ccf4b3ca 100644
--- a/docs/fr/programmers/api-functions/api-get-config-vars.xml
+++ b/docs/fr/programmers/api-functions/api-get-config-vars.xml
@@ -1,27 +1,28 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
+
 <refentry id="api.get.config.vars">
  <refnamediv>
-  <refname>get_config_vars</refname>
-  <refpurpose></refpurpose>
+  <refname>get_config_vars()</refname>
+  <refpurpose>Retourne la valeur de la variable de configuration passée en paramètre</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>array</type><methodname>get_config_vars</methodname>
    <methodparam choice="opt"><type>string</type><parameter>varname</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Retourne la valeur de la variable de configuration passée en paramètre.
    Si aucun paramètre n'est donné, un tableau de toutes les variables de
    configuration chargées est retourné.
   </para>
   <example>
-   <title>Exemple avec get_config_vars</title>
+   <title>Exemple avec get_config_vars()</title>
    <programlisting role="php">
 <![CDATA[
 <?php
+
 // récupère la variable de configuration chargée 'foo'
 $foo = $smarty->get_config_vars('foo');
 
diff --git a/docs/fr/programmers/api-functions/api-get-registered-object.xml b/docs/fr/programmers/api-functions/api-get-registered-object.xml
index fe5fb037..d9f95299 100644
--- a/docs/fr/programmers/api-functions/api-get-registered-object.xml
+++ b/docs/fr/programmers/api-functions/api-get-registered-object.xml
@@ -1,28 +1,30 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
+
 <refentry id="api.get.registered.object">
  <refnamediv>
-  <refname>get_registered_object</refname>
-  <refpurpose></refpurpose>
+  <refname>get_registered_object()</refname>
+  <refpurpose>Retourne la référence d'un objet enregistré</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>array</type><methodname>get_registered_object</methodname>
    <methodparam><type>string</type><parameter>object_name</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Retourne la référence d'un objet enregistré. Utile quand vous
-   voulez accéder directement à un objet enregistré avec une
-   fonction utilisateur.
+   Utile quand vous voulez accéder directement à un
+   <link linkend="api.register.object">objet enregistré</link>
+   avec une fonction utilisateur. Lisez la documentation sur les
+   <link linkend="advanced.features.objects">objets</link> pour plus d'informations.
   </para>
   <example>
-   <title>Exemple avec get_registered_object</title>
+   <title>Exemple avec get_registered_object()</title>
    <programlisting role="php">
 <![CDATA[
 <?php
-function smarty_block_foo($params, &amp;$smarty) 
+function smarty_block_foo($params, &$smarty)
 {
   if (isset[$params['object']]) {
     // récupère la référence de l'objet enregistré
@@ -34,8 +36,15 @@ function smarty_block_foo($params, &amp;$smarty)
 ]]>
    </programlisting>
   </example>
+  <para>
+   Voir aussi
+   <link linkend="api.register.object">register_object()</link>,
+   <link linkend="api.unregister.object">unregister_object()</link> et
+   la <link linkend="advanced.features.objects">section sur les objets</link>.
+  </para>
  </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -55,4 +64,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/programmers/api-functions/api-get-template-vars.xml b/docs/fr/programmers/api-functions/api-get-template-vars.xml
index f0b38dd0..b7823b67 100644
--- a/docs/fr/programmers/api-functions/api-get-template-vars.xml
+++ b/docs/fr/programmers/api-functions/api-get-template-vars.xml
@@ -1,21 +1,21 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+
 <refentry id="api.get.template.vars">
  <refnamediv>
-  <refname>get_template_vars</refname>
-  <refpurpose></refpurpose>
+  <refname>get_template_vars()</refname>
+  <refpurpose>Retourne la valeur assignée passée en paramètre</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>array</type><methodname>get_template_vars</methodname>
    <methodparam choice="opt"><type>string</type><parameter>varname</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Retourne la valeur assignée passée en paramètre. Si aucun paramètre
-   n'est donné, un tableau de toutes les variables assignées est
-   retourné.
+   Si aucun paramètre n'est donné, un tableau de toutes les variables
+   <link linkend="api.assign">assignées</link> est retourné.
   </para>
   <example>
    <title>Exemple avec get_template_vars</title>
@@ -39,11 +39,15 @@ print_r($tpl_vars);
    Voir aussi 
    <link linkend="api.assign">assign()</link>,
    <link linkend="language.function.assign">{assign}</link>,
-   <link linkend="api.clear.assign">clear_assign()</link> et
-   <link linkend="api.get.config.vars">get_config_vars()</link>.
+   <link linkend="api.assign.by.ref">assign_by_ref()</link>,
+   <link linkend="api.append">append()</link>,
+   <link linkend="api.clear.assign">clear_assign()</link>,
+   <link linkend="api.clear.all.assign">clear_all_assign()</link> et
+  <link linkend="api.get.config.vars">get_config_vars()</link>.
   </para>
  </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -63,4 +67,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/programmers/api-functions/api-is-cached.xml b/docs/fr/programmers/api-functions/api-is-cached.xml
index 9eb93161..263f5321 100644
--- a/docs/fr/programmers/api-functions/api-is-cached.xml
+++ b/docs/fr/programmers/api-functions/api-is-cached.xml
@@ -1,13 +1,14 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.4 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
+
 <refentry id="api.is.cached">
  <refnamediv>
-  <refname>is_cached</refname>
-  <refpurpose></refpurpose>
+  <refname>is_cached()</refname>
+  <refpurpose>Retourne &true; s'il y a un fichier de cache valide pour ce template</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>bool</type><methodname>is_cached</methodname>
    <methodparam><type>string</type><parameter>template</parameter></methodparam>
@@ -15,73 +16,82 @@
    <methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Retourne &true; s'il y a un fichier de cache valide pour ce template.
-   Celà fonctionne seulement si <link
-   linkend="variable.caching">$caching</link> est défini à <literal>true</literal>.
+  Celà fonctionne seulement si <link linkend="variable.caching">$caching</link>
+  est défini à <literal>true</literal>. Voir aussi la
+  <link linkend="caching">section sur le cache</link>.
   </para>
   <example>
-   <title>Exemple avec is_cached</title>
+   <title>Exemple avec is_cached()</title>
    <programlisting role="php">
 <![CDATA[
 <?php
 $smarty->caching = true;
 
-if(!$smarty->is_cached("index.tpl")) {
+if(!$smarty->is_cached('index.tpl')) {
 //aucun appel à la base de donnée
 }
 
-$smarty->display("index.tpl");
+$smarty->display('index.tpl');
 ?>
 ]]>
    </programlisting>
   </example>
   <para>
    Vous pouvez aussi passer en second paramètre un identifiant
-   de $cache au cas où vous voudriez plusieurs fichiers de cache
-   pour ce template.
+   de $cache au cas où vous voudriez <link linkend="caching.multiple.caches">plusieurs
+    fichiers</link> de cache pour ce template.
   </para>
   <para>
-   Vous pouvez donner un <link linkend="variable.compile.id">identifiant de compilation</link> 
+   Vous pouvez donner un <link linkend="variable.compile.id">identifiant de compilation</link>
    en tant que troisième paramètre.
    Si vous ne spécifiez pas ce paramètre, le <link linkend="variable.compile.id">$compile_id</link>
    persistant sera utilisé.
   </para>
   <para>
-   Si vous voulez utiliser un identifiant de compilation sans utilisez d'identifiant de cache, 
-   mettez <literal>null</literal> pour l'identifiant de cache.
+   Si vous ne voulez pas passer un identifiant de cache mais plutôt un
+   <link linkend="variable.compile.id">$compile_id</link>, vous devez passer
+   <literal>null</literal> en tant qu'identifiant de cache.
   </para>
   <example>
-   <title>Exemple avec is_cached et plusieurs templates</title>
+   <title>Exemple avec is_cached() et plusieurs templates</title>
    <programlisting role="php">
 <![CDATA[
 <?php
 $smarty->caching = true;
 
-if(!$smarty->is_cached("index.tpl", "FrontPage")) {
+if(!$smarty->is_cached('index.tpl', 'FrontPage')) {
   //appel de la base de données, assignation des variables
 }
 
-$smarty->display("index.tpl", "FrontPage");
+$smarty->display('index.tpl', 'FrontPage');
 ?>
 ]]>
    </programlisting>
   </example>
- 
+
   <note>
    <title>Note technique</title>
    <para>
-    Si <literal>is_cached</literal> retourne vrai, il charge en fait le cache existant et 
+    Si <literal>is_cached()</literal> retourne vrai, il charge en fait le cache existant et 
     le stocke en interne. Tout appel supplémentaire à 
     <link linkend="api.display">display()</link> ou
     <link linkend="api.fetch">fetch()</link> retournera ce contenu stocké en interne
     sans tenter de recharger le fichier en cache. Celà évite des problématiques d'accès concurents, 
-    lorsqu'un second processus efface le cache entre l'appel de is_cached et l'appel à display 
+    lorsqu'un second processus efface le cache entre l'appel de is_cached() et l'appel à
+    <link linkend="api.display">display()</link>
     comme dans l'un de nos exemples ci-dessus. Celà signifie également que les appels à 
     <link linkend="api.clear.cache">clear_cache()</link>
     et les changements de paramètres du cache peuvent n'avoir aucun effet alors que 
-    is_cached a retourné vrai.
+    is_cached() a retourné vrai.
    </para>
   </note>
+
+  <para>
+   Voir aussi
+   <link linkend="api.clear.cache">clear_cache()</link>,
+   <link linkend="api.clear.all.cache">clear_all_cache()</link> et
+   la <link linkend="caching">section sur le cache</link>.
+  </para>
  </refsect1>
 </refentry>