sync with EN

docs/fr/programmers/api-functions/api-append-by-ref.xml

@@ -1,13 +1,14 @@
 <?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.append.by.ref">
  <refnamediv>
-  <refname>append_by_ref</refname>
+  <refname>append_by_ref()</refname>
-  <refpurpose></refpurpose>
+  <refpurpose>Ajoute des valeurs par r<>f<EFBFBD>rence</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>void</type><methodname>append_by_ref</methodname>
    <methodparam><type>string</type><parameter>varname</parameter></methodparam>

docs/fr/programmers/api-functions/api-append.xml

@@ -1,13 +1,14 @@
 <?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.append">
  <refnamediv>
-  <refname>append</refname>
+  <refname>append()</refname>
-  <refpurpose></refpurpose>
+  <refpurpose>Ajoute un <20>l<EFBFBD>ment <20> un tableau assign<67></refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>void</type><methodname>append</methodname>
    <methodparam><type>mixed</type><parameter>var</parameter></methodparam>
@@ -19,12 +20,11 @@
    <methodparam choice="opt"><type>bool</type><parameter>merge</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Utilis<EFBFBD>e pour ajouter un <20>l<EFBFBD>ment <20> un tableau assign<67>. Si vous utilisez
+   Si vous utilisez cette fonction avec une cha<68>ne de caract<63>res, elle est
-   cette fonction avec une cha<68>ne de caract<63>res, elle est convertie en
+   convertie en tableau auquel on ajoute ensuite l'<27>l<EFBFBD>ment. Vous pouvez
-   tableau auquel on ajoute ensuite l'<27>l<EFBFBD>ment. Vous pouvez explicitement 
+   explicitement passer des paires nom/valeur. Si vous passez le troisi<73>me
-   passer des paires nom/valeur. Si vous passez le troisi<73>me param<61>tre
+   param<EFBFBD>tre (optionel) <20> <literal>true</literal>, la valeur sera fusionn<6E>e
-   (optionel) <20> <literal>true</literal>, la valeur sera fusionn<6E>e avec le 
+   avec le tableau plut<75>t que d'<27>tre ajout<75>e.
-   tableau plut<75>t que d'<27>tre ajout<75>e.
   </para>
   &note.parameter.merge;
   <example>

docs/fr/programmers/api-functions/api-assign-by-ref.xml

@@ -1,22 +1,23 @@
 <?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.assign.by.ref">
  <refnamediv>
-  <refname>assign_by_ref</refname>
+  <refname>assign_by_ref()</refname>
-  <refpurpose></refpurpose>
+  <refpurpose>Assigne des valeurs par r<>f<EFBFBD>rence</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>void</type><methodname>assign_by_ref</methodname>
    <methodparam><type>string</type><parameter>varname</parameter></methodparam>
    <methodparam><type>mixed</type><parameter>var</parameter></methodparam>
   </methodsynopsis>
   <para>
-  Utilis<69>e pour assigner des valeurs aux templates par r<>f<EFBFBD>rence plut<75>t
+   Utilis<EFBFBD>e pour <link linkend="api.assign">assigner</link> des valeurs aux
-  que par copie. R<>f<EFBFBD>rez-vous au manuel PHP pour une explication plus pr<70>cise
+   templates par r<>f<EFBFBD>rence plut<75>t que par copie. R<>f<EFBFBD>rez-vous au manuel PHP
-  sur les r<>f<EFBFBD>rences des variables.
+   pour une explication plus pr<70>cise sur les r<>f<EFBFBD>rences des variables.
  </para>
  <note>
   <title>Note technique</title>
@@ -30,7 +31,7 @@
   </para>
  </note>
  <example>
-  <title>Exemple avec assign_by_ref</title>
+  <title>Exemple avec assign_by_ref()</title>
   <programlisting role="php">
 <![CDATA[
 <?php
@@ -50,6 +51,7 @@ $smarty->assign_by_ref("Adresse",$address);
    </para>
  </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

docs/fr/programmers/api-functions/api-assign.xml

@@ -1,13 +1,14 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
+
 <refentry id="api.assign">
  <refnamediv>
-  <refname>assign</refname>
+  <refname>assign()</refname>
-  <refpurpose></refpurpose>
+  <refpurpose>Assigne des valeurs au template</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>void</type><methodname>assign</methodname>
    <methodparam><type>mixed</type><parameter>var</parameter></methodparam>
@@ -18,12 +19,11 @@
    <methodparam><type>mixed</type><parameter>var</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Utilis<EFBFBD>e pour assigner des valeurs aux templates. Vous pouvez
+   Vous pouvez explicitement passer des paires nom/valeur, ou
-   explicitement passer des paires nom/valeur, ou des tableaux
+   des tableaux associatifs contenant des paires nom/valeur.
-   associatifs contenant des paires nom/valeur.
   </para>
   <example>
-   <title>Exemple avec assign</title>
+   <title>Exemple avec assign()</title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -33,20 +33,44 @@ $smarty->assign("Adresse",$address);
 
 // passe un tableau associatif
 $smarty->assign(array('Ville' => 'Lincoln','Pays' => 'Nebraska'));
+
+// Passe une ligne d'une base de donn<6E>es (eg adodb)
+$sql = 'select id, name, email from contacts where contact ='.$id;
+$smarty->assign('contact', $db->getRow($sql));
 ?>
+]]>
+   </programlisting>
+   <para>
+    Acc<63>der <20> cela dans un template avec
+   </para>
+   <programlisting>
+<![CDATA[
+{* notez que les variables sont sensibles <20> la casse, comme en PHP *}
+{$Name}
+{$Address}
+{$city}
+{$state}
+
+{$contact.id}, {$contact.name},{$contact.email}
 ]]>
    </programlisting>
   </example>
+  <para>
+   Pour des assignements plus complexes de tableaux, lisez
+   <link linkend="language.function.foreach">{foreach}</link> et
+   <link linkend="language.function.section">{section}</link>.
+  </para>
   <para>
    Voir aussi
    <link linkend="api.assign.by.ref">assign_by_ref()</link>,
+   <link linkend="api.get.template.vars">get_template_vars()</link>,
    <link linkend="api.clear.assign">clear_assign()</link>,
-   <link linkend="api.append">append()</link>,
+   <link linkend="api.append">append()</link> et
-   <link linkend="language.function.assign">{assign}</link> et
+   <link linkend="language.function.assign">{assign}</link>.
-   <link linkend="api.get.template.vars">get_template_vars()</link>.
+  </para>
- </para>
  </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

docs/fr/programmers/api-functions/api-clear-all-assign.xml

@@ -1,27 +1,36 @@
 <?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.all.assign">
  <refnamediv>
-  <refname>clear_all_assign</refname>
+  <refname>clear_all_assign()</refname>
-  <refpurpose></refpurpose>
+  <refpurpose>Efface les valeurs de toutes les variables assign<67>es</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>void</type><methodname>clear_all_assign</methodname>
    <void />
   </methodsynopsis>
-  <para>
-   Utilis<69>e pour effacer les valeurs de toutes les variables assign<67>es.
-  </para>
   <example>
-   <title>Exemple avec clear_all_assign</title>
+   <title>Exemple avec clear_all_assign()</title>
    <programlisting role="php">
 <![CDATA[
 <?php
+// passe des paires nom/valeur
+$smarty->assign('Name', 'Fred');
+$smarty->assign('Address', $address);
+
+// affichera
+print_r( $smarty->get_template_vars() );
+
 // efface toutes les variables assign<67>es
 $smarty->clear_all_assign();
+
+// n'affichera rien
+print_r( $smarty->get_template_vars() );
+
 ?>
 ]]>
    </programlisting>
@@ -35,6 +44,7 @@ $smarty->clear_all_assign();
   </para>
  </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

docs/fr/programmers/api-functions/api-clear-all-cache.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.clear.all.cache">
  <refnamediv>
-  <refname>clear_all_cache</refname>
+  <refname>clear_all_cache()</refname>
-  <refpurpose></refpurpose>
+  <refpurpose>Efface les fichiers de cache des templates</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>void</type><methodname>clear_all_cache</methodname>
    <methodparam choice="opt"><type>int</type><parameter>expire_time</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Utilis<EFBFBD>e pour effacer les fichiers de cache des templates. Vous pouvez passer un
+   Vous pouvez passer un param<61>tre optionnel afin d'indiquer l'<27>ge minimun
-   param<EFBFBD>tre optionnel afin d'indiquer l'<27>ge minimun que doivent avoir
+   que doivent avoir les fichiers de cache pour qu'ils soient effac<EFBFBD>s.
-   les fichiers de cache pour qu'ils soient effac<61>s.
   </para>
   <example>
    <title>Exemple avec clear_all_cache</title>
@@ -30,11 +30,13 @@ $smarty->clear_all_cache();
   </example>
   <para>
    Voir aussi
-   <link linkend="api.clear.cache">clear_cache()</link> et
+   <link linkend="api.clear.cache">clear_cache()</link>,
+  <link linkend="api.is.cached">is_cached()</link> et
    le <link linkend="caching">cache</link>.
   </para>
  </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

docs/fr/programmers/api-functions/api-clear-assign.xml

@@ -1,10 +1,11 @@
 <?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.assign">
  <refnamediv>
-  <refname>clear_assign</refname>
+  <refname>clear_assign()</refname>
-  <refpurpose></refpurpose>
+  <refpurpose>Efface la valeur d'une variable assign<67>e</refpurpose>
  </refnamediv>
  <refsect1>
   <title />
@@ -13,19 +14,18 @@
    <methodparam><type>mixed</type><parameter>var</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Efface la valeur d'une variable assign<67>e. Il peut s'agir
+   Il peut s'agir d'une simple valeur ou d'un tableau de valeur.
-   d'une simple valeur ou d'un tableau de valeur.
   </para>
   <example>
-   <title>Exemple avec clear_assign</title>
+   <title>Exemple avec clear_assign()</title>
    <programlisting role="php">
 <![CDATA[
 <?php
 // efface une variable
-$smarty->clear_assign("Name");
+$smarty->clear_assign('Name');
 
 // efface plusieurs variables
-$smarty->clear_assign(array("Name","Address","Zip"));
+$smarty->clear_assign(array('Name','Address','Zip'));
 ?>
 ]]>
    </programlisting>
@@ -34,6 +34,7 @@ $smarty->clear_assign(array("Name","Address","Zip"));
    Voir aussi
    <link linkend="api.clear.all.assign">clear_all_assign()</link>,
    <link linkend="api.clear.config">clear_config()</link>,
+   <link linkend="api.get.template.vars">get_template_vars()</link>,
    <link linkend="api.assign">assign()</link> et
    <link linkend="api.append">append()</link>.
   </para>

docs/fr/programmers/api-functions/api-clear-cache.xml

@@ -1,10 +1,11 @@
 <?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.cache">
  <refnamediv>
-  <refname>clear_cache</refname>
+  <refname>clear_cache()</refname>
-  <refpurpose></refpurpose>
+  <refpurpose>Efface le cache d'un template sp<73>cifique</refpurpose>
  </refnamediv>
  <refsect1>
   <title />
@@ -12,39 +13,39 @@
    <type>void</type><methodname>clear_cache</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>
    <methodparam choice="opt"><type>int</type><parameter>expire_time</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Utilis<EFBFBD>e pour nettoyer le(s) fichier(s) de cache d'un 
+   Si vous avez <link linkend="caching.multiple.caches">plusieurs fichiers de cache</link>
-   <parameter>template</parameter> en particulier.
+   pour ce template, vous pouvez en sp<73>cifier un en particulier en passant son identifiant
-   Si vous avez plusieurs fichiers de cache pour ce template, vous
-   pouvez en sp<73>cifier un en particulier en passant son identifiant 
    <parameter>cache_id</parameter> en deuxi<78>me param<61>tre.
    Vous pouvez aussi passer un identifiant de compilation
-   <parameter>compile_id</parameter> en  troisi<73>me param<61>tre. 
+   <link linkend="variable.compile.id"><parameter>$compile_id</parameter></link>
-   Vous pouvez grouper des templates ensemble afin qu'ils puissent 
+   en  troisi<73>me param<61>tre. Vous pouvez <link linkend="caching.groups">grouper</link>
-   <20>tre supprim<69>s en groupe. R<>f<EFBFBD>rez-vous <20> la section sur le
+   des templates ensemble afin qu'ils puissent <EFBFBD>tre supprim<69>s en groupe. R<>f<EFBFBD>rez-vous <20> la
-   <link linkend="caching">cache</link> pour plus d'informations. 
+   section sur le <link linkend="caching">cache</link> pour plus d'informations.
    Vous pouvez passer un quatri<72>me param<61>tre pour indiquer un <20>ge
    minimum en secondes que le fichier en cache doit avoir avant d'<27>tre effac<61>.
   </para>
   <example>
-   <title>Exemple avec clear_cache</title>
+   <title>Exemple avec clear_cache()</title>
    <programlisting role="php">
 <![CDATA[
 <?php
 // efface le fichier de cache de ce template
-$smarty->clear_cache("index.tpl");
+$smarty->clear_cache('index.tpl');
 
 // efface un fichier de cache gr<67>ce <20> son identifiant de cache
-$smarty->clear_cache("index.tpl","CACHEID");
+$smarty->clear_cache('index.tpl','CACHEID');
 ?>
 ]]>
    </programlisting>
   </example>
   <para>
    Voir aussi le
+   <link linkend="api.clear.all.cache">clear_all_cache()</link> et
    <link linkend="caching">cache</link>.
   </para>
  </refsect1>

docs/fr/programmers/api-functions/api-clear-compiled-tpl.xml

@@ -1,31 +1,33 @@
 <?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.clear.compiled.tpl">
  <refnamediv>
-  <refname>clear_compiled_tpl</refname>
+  <refname>clear_compiled_tpl()</refname>
-  <refpurpose></refpurpose>
+  <refpurpose>Efface la version compil<69>e d'un template sp<73>cifi<66></refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Description</title>
   <methodsynopsis>
    <type>void</type><methodname>clear_compiled_tpl</methodname>
    <methodparam choice="opt"><type>string</type><parameter>tpl_file</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>compile_id</parameter>
+   </methodparam>
    <methodparam choice="opt"><type>int</type><parameter>exp_time</parameter></methodparam>
   </methodsynopsis>
   <para>
    Utilis<69>e pour effacer la version compil<69>e du template sp<73>cifi<66> ou
    de tous les templates si aucun n'est sp<73>cifi<66>. 
-   Si vous passez uniquement un compile_id, le template compil<69>
+   Si vous passez uniquement un <link linkend="variable.compile.id">$compile_id</link>,
-   correspondant <20> ce compile_id sera effac<61>. Si vous passez un
+   le template compil<69> correspondant <20> ce <link linkend="variable.compile.id">$compile_id</link>
-   exp_time, les templates compil<69>s plus vieux que exp_time secondes
+   sera effac<61>. Si vous passez un exp_time, les templates compil<69>s plus vieux que exp_time secondes
    seront effac<61>s, par d<>faut, tous les templates compil<69>s seront
    effac<61>s au v<> de leurs <20>ges. Cette fonction est destin<69>e <20> un usage 
    avanc<6E> et n'est habituellement pas utilis<69>e.
   </para>
   <example>
-   <title>Exemple avec clear_compiled_tpl</title>
+   <title>Exemple avec clear_compiled_tpl()</title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -40,6 +42,7 @@ $smarty->clear_compiled_tpl();
   </example>
  </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml