dams            Thu Jul 12 08:17:02 2001 EDT

  Modified files:              
    /phpdoc/fr/functions        session.xml 
  Log:
  Correcting docBook/Jade errors
  
Index: phpdoc/fr/functions/session.xml
diff -u phpdoc/fr/functions/session.xml:1.12 phpdoc/fr/functions/session.xml:1.13
--- phpdoc/fr/functions/session.xml:1.12        Sat Jul  7 18:22:24 2001
+++ phpdoc/fr/functions/session.xml     Thu Jul 12 08:17:02 2001
@@ -3,41 +3,41 @@
   <titleabbrev>Sessions</titleabbrev>
   <partintro>
    <para>
-       La gestion des sessions avec PHP est un moyen de sauver des informations
-       entre deux acc&egrave;s. Cela permet notamment de construire des
-       applications personnalis&eacute;es, et d'accro&icirc;tre l'attrait de votre 
site.
+    La gestion des sessions avec PHP est un moyen de sauver des informations
+    entre deux acc&egrave;s. Cela permet notamment de construire des
+    applications personnalis&eacute;es, et d'accro&icirc;tre l'attrait de votre site.
    </para>
    <para>
-       Si vous connaissez d&eacute;j&agrave; la gestion des sessions avec
-       phplib, vous remarquerez que certains concepts sont similaires.
+    Si vous connaissez d&eacute;j&agrave; la gestion des sessions avec
+    phplib, vous remarquerez que certains concepts sont similaires.
    </para>
    <para>
-       Chaque visiteur qui acc&egrave;de &agrave; votre site se voit assigner
-       un num&eacute;ro d'identifiant, appel&eacute; plus loin "identifiant de
-       session". Celui ci est enregistr&eacute; soit dans un cookie, chez
-       le client, soit dans l'URL.
+    Chaque visiteur qui acc&egrave;de &agrave; votre site se voit assigner
+    un num&eacute;ro d'identifiant, appel&eacute; plus loin "identifiant de
+    session". Celui-ci est enregistr&eacute; soit dans un cookie, chez
+    le client, soit dans l'URL.
    </para>
    <para>
-       Les sessions vous permettront d'enregistrer des variables, pour
-       les pr&eacute;server et les r&eacute;utiliser tout au long des
-       requ&ecirc;tes. Lorsqu'un visiteur acc&egrave;de &agrave; votre site,
-       PHP v&eacute;rifiera automatiquement (si session.auto_start est &agrave;
-       1) ou manuellement (explicitement avec <function>session_start</function>
-       ou implicitement avec <function>session_register</function>) si une
-       session a d&eacute;j&agrave; &eacute;t&eacute; ouverte. Si
-       une telle session existe d&eacute;j&agrave;, l'environnement
-       pr&eacute;c&eacute;dent sera recr&eacute;&eacute;.
+    Les sessions vous permettront d'enregistrer des variables pour
+    les pr&eacute;server et les r&eacute;utiliser tout au long de la
+    visites de votre site. Lorsqu'un visiteur acc&egrave;dere &agrave; votre site,
+    PHP v&eacute;rifiera automatiquement (si session.auto_start est &agrave;
+    1) ou manuellement (explicitement avec <function>session_start</function>
+    ou implicitement avec <function>session_register</function>) si une
+    session a d&eacute;j&agrave; &eacute;t&eacute; ouverte. Si
+    une telle session existe d&eacute;j&agrave;, l'environnement
+    pr&eacute;c&eacute;dent sera recr&eacute;&eacute;.
    </para>
    <para>
-       Toutes les variables &agrave; enregistrer seront enregistr&eacute;es
-       sur le disque &agrave; la fin de chaque requ&ecirc;te. Les variables
-       enregistr&eacute;es mais non d&eacute;finies seront marqu&eacute;es
-       comme tel. Lors des acc&egrave;s ult&eacute;rieurs, elles ne seront
-       d&eacute;finies que si l'utilisateur le fait.
+    Toutes les variables &agrave; enregistrer seront enregistr&eacute;es
+    sur le disque &agrave; la fin de chaque requ&ecirc;te. Les variables
+    enregistr&eacute;es mais non d&eacute;finies seront marqu&eacute;es
+    comme telles. Lors des acc&egrave;s ult&eacute;rieurs, elles ne seront
+    d&eacute;finies que si l'utilisateur le fait.
    </para>
    <para>
     Les options <literal>track_vars</literal> et <literal>gpc_globals</literal>
-    modifient la fa&ccedil;on avec laquelle les variables sont recharg&eacute;ees.
+    modifient la fa&ccedil;on dont les variables sont recharg&eacute;es.
    </para>
    <note>
     <para>
@@ -49,9 +49,9 @@
    <para>
     Si <literal>track_vars</literal> est activ&eacute;e, et <link
     linkend="ini.register-globals"><literal>register_globals</literal></link>
-    est d&eacute;sactiv&eacute;e, alors les variables de session seront accessibles
+    d&eacute;sactiv&eacute;e, alors les variables de session seront accessibles
     uniquement dans le tableau associatif global $HTTP_STATE_VARS.
-    Les variables de sessions lues seront disponibles dans
+    Les variables de session lues seront disponibles dans
     $HTTP_STATE_VARS.
     <example>
      <title>
@@ -61,15 +61,15 @@
      </title>
      <programlisting role="php">
 &lt;?php
-session_register("compte");
-$HTTP_SESSION_VARS["compte"]++;
+  session_register("compte");
+  $HTTP_SESSION_VARS["compte"]++;
 ?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Si <link linkend="ini.register-globals"><literal>register_globals</literal></link>
-    est activ&eacute;, alors les variables de session seront plac&eacute;s
+    est activ&eacute;e, alors les variables de session seront plac&eacute;es
     dans les variables globales associ&eacute;es.
     <example>
      <title>
@@ -79,8 +79,8 @@
      </title>
      <programlisting role="php">
 &lt;?php
-session_register("compte");
-$compte++;
+  session_register("compte");
+  $compte++;
 ?&gt;
      </programlisting>
     </example>
@@ -96,28 +96,29 @@
     Il y a deux modes de propagation de l'identifiant de session :
     <itemizedlist>
      <listitem>
-       <simpara>
-        Cookies
-       </simpara>
+    <simpara>
+     Cookies
+    </simpara>
      </listitem>
      <listitem>
-       <simpara>
-        Param&egrave;tre URL
-       </simpara>
+    <simpara>
+     Param&egrave;tre URL
+    </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     Le module de session supporte les deux techniques. La
     m&eacute;thode par cookies est optimale, mais &eacute;tant
-    donn&eacute; le peu de fiabilit&eacute; (les clients peuvent les refuser,
-    ou les effacer), on ne peut pas se contenter de cette technique.
+    donn&eacute; son peu de fiabilit&eacute; (les clients peuvent refuser
+    ou effacer les cookies), on ne peut pas se contenter de cette technique.
     La deuxi&egrave;me m&eacute;thode place l'identifiant de session
     directement dans l'URL.
    </para>
    <para>
     PHP est capable de g&eacute;rer ceci de mani&egrave;re transparente,
-    lorsque vous le compilez avec l'option <literal>--enable-trans-sid</literal>.
+    lorsque vous le compilez avec l'option <link 
+linkend="install.configure.enable-trans-sid">
+    <literal>--enable-trans-sid</literal></link>.
     Dans ce cas, les URL relatives seront modifi&eacute;es pour
     contenir l'identifiant de session automatiquement. Sinon,
     vous pouvez toujours utiliser la constante <literal>SID</literal>,
@@ -130,9 +131,9 @@
     <note>
      <para>
       La fonction qui g&eacute;rera l'&eacute;criture des donn&eacute;es ne sera 
appel&eacute;e
-      qu'une fois le script aura envoy&eacute; toutes ses donn&eacute;es. Ainsi,
+      qu'une fois que le script aura envoy&eacute; toutes ses donn&eacute;es. Ainsi,
       les affichages tent&eacute;s par cette fonction ne pourront jamais
-      &ecirc;tre recus par le navigateur. Si un tel affichage est n&eacute;cessaire,
+      &ecirc;tre re&ccedil;us par le navigateur. Si un tel affichage est 
+n&eacute;cessaire,
       il est conseill&eacute; d'&eacute;crire les debugs dans un fichier.
      </para>
     </note>
@@ -141,16 +142,16 @@
     L'exemple suivant montre comment enregistrer une variable, et comment relier
     correctement des pages avec SID.
     <example>
-     <title>Compter le nombre de hit d'un utilisateur.</title>
+     <title>Compter le nombre de hits d'un utilisateur.</title>
      <programlisting role="php">
 &lt;?php
-session_register("compteur");
-$compteur++;
+  session_register("compteur");
+  $compteur++;
 ?&gt;
 Salut visiteur, vous avez vu cette page &lt;?php echo $compteur; ?&gt; times.&lt;P&gt;
 &lt;php?
 # le &lt;?=SID&gt; est n&eacute;cessaire pour transmettre l'identifiant de session
-# au cas o&uacute; les utilisateurs auraient inactiv&eacute; les cookies
+# au cas o&ugrave; les utilisateurs auraient inactiv&eacute; les cookies
 ?&gt;
      </programlisting>
      <simpara>
@@ -160,7 +161,8 @@
    </para>
    <para>
     Le <literal>&lt;?=SID-&gt;</literal> n'est pas n&eacute;cessaire, si l'option
-    <literal>--enable-trans-sid</literal> a &eacute;t&eacute; utilis&eacute;
+    <link linkend="install.configure.enable-trans-sid">
+    <literal>--enable-trans-sid</literal></link> a &eacute;t&eacute; utilis&eacute;e
     pour compiler PHP.
    </para>
    <para>
@@ -176,7 +178,7 @@
     Pour enregistrer ces informations dans une base de donn&eacute;es,
     il vous faut utiliser la fonction <function>session_set_save_handler</function>.
     Il faudra alors impl&eacute;menter la fonction suivante pour
-    l'adapter &agrave; MySQL ou toute autre base de donn&eacute;es :
+    l'adapter &agrave; MySQL ou &agrave; toute autre base de donn&eacute;es :
    </para>
    <para>
     Le syst&egrave;me de gestion des sessions dispose d'un grand nombre d'options,
@@ -184,112 +186,113 @@
     un survol rapide :
     <itemizedlist>
      <listitem>
-         <simpara>
-         <literal>session.save_handler</literal> d&eacute;fini les noms
-         des fonctions qui seront utilis&eacute;es pour enregistrer et
-         retrouver les donn&eacute;es associ&eacute;es &agrave; une session.
-         Par d&eacute;faut, les sessions sont enregistr&eacute;es dans des
-         <literal>fichiers</literal>.
-         </simpara>
-     </listitem>
-     <listitem>
-         <simpara>
-          <literal>session.save_path</literal> d&eacute;fini l'argument qui
-          est pass&eacute; &agrave; la fonction de sauvegarde. Si vous utilisez
-          la sauvegarde par fichier, cet argument est le chemin jusqu'au dossier
-          o&uacute; les fichiers sont cr&eacute;&eacute;s. Par d&eacute;faut, le
-          dossier est <literal>/tmp</literal>.
-         </simpara>
+      <simpara>
+      <literal>session.save_handler</literal> d&eacute;finit les noms
+      des fonctions qui seront utilis&eacute;es pour enregistrer et
+      retrouver les donn&eacute;es associ&eacute;es &agrave; une session.
+      Par d&eacute;faut, les sessions sont enregistr&eacute;es dans des
+      <literal>fichiers</literal>.
+        </simpara>
+     </listitem>
+     <listitem>
+      <simpara>
+       <literal>session.save_path</literal> d&eacute;finit l'argument qui
+         est pass&eacute; &agrave; la fonction de sauvegarde. Si vous utilisez
+       la sauvegarde par fichier, cet argument est le chemin jusqu'au dossier
+       o&ugrave; les fichiers sont cr&eacute;&eacute;s. Par d&eacute;faut, le
+       dossier est <literal>/tmp</literal>.
+      </simpara>
       <warning>
        <para>
         Si le dossier que vous utilisez a les droits de lecture universels,
         comme <filename>/tmp</filename> (valeur par d&eacute;faut), les autres 
utilisateurs
-        du serveur peuvent aussi lire ces fichiers, et s'imiscer dans vos sessions.
+        du serveur peuvent aussi lire ces fichiers, et s'immiscer dans vos sessions.
        </para>
       </warning>
      </listitem>
      <listitem>
-         <simpara>
-          <literal>session.name</literal> sp&eacute;cifie le nom de la session,
-          qui sera utilis&eacute; comme nom de cookie. Par d&eacute;faut :
-          <literal>PHPSESSID</literal>.
-         </simpara>
-     </listitem>
-     <listitem>
-       <simpara>
-        <literal>session.auto_start</literal> indique qu'une session doit
-        commencer automatiquement lors de la premier requ&ecirc;te. Par
-        d&eacute;faut &agrave; <literal>0</literal> (inactiv&eacute;).
-       </simpara>
-     </listitem>
-     <listitem>
-       <simpara>
-        <literal>session.lifetime</literal> fixe la dur&eacute;e de vie,
-        en secondes, du cookie envoy&eacute; au client. La valeur 0 signifie
-        "jusqu'&agrave; ce que le client soit ferm&eacute;". Par d&eacute;faut
-        &agrave; <literal>0</literal> (inactiv&eacute;).
-       </simpara>
-     </listitem>
-     <listitem>
-       <simpara>
-        <literal>session.serialize_handler</literal> d&eacute;fini le
-        nom de la fonction qui sera utilis&eacute;e pour enregistrer et
-        relire les donn&eacute;s. Actuellement, c'est un format interne
-        de PHP (nom : <literal>php</literal>) et WDDX (nom :
-        <literal>wddx</literal>). WDDX n'est utilisable que si
-        PHP a &eacute;t&eacute; compil&eacute; avec le
-        <link linkend="ref.wddx">support WDDX</link>. Par d&eacute;faut,
-        c'est le mode <literal>php</literal> qui est selectionn&eacute;.
-        </simpara>
-     </listitem>
-     <listitem>
-       <simpara>
-        <literal>session.gc_probability</literal> pr&eacute;cise la
-        probabilit&eacute; que la routine gc (garbage collection) soit
-        lanc&eacute;e, en pourcentage. Par d&eacute;faut, <literal>1</literal>.
-       </simpara>
-     </listitem>
-     <listitem>
-       <simpara>
-        <literal>session.gc_maxlifetime</literal> fixe la dur&eacute;e,
-        en secondes, au-dela de laquelle les donn&eacute;es
-        consid&eacute;r&eacute;es comme inutiles seront supprim&eacute;es.
-       </simpara>
-     </listitem>
-     <listitem>
-       <simpara>
-        <literal>session.referer_check</literal> d&eacute;termine si
-        l'identifiant de session ids utilis&eacute; par des sites externe
-        seront &eacute;limin&eacute;. Si les identifiants de sessions sont
-        propag&eacute;s avec la m&eacute;thode des URL, des utilisateurs qui
-        n'en conna&icirc;trait pas l'utilit&eacute; risque de divulguer ces
-        valeurs, et cela m&eacute;nera &agrave; des probl&egrave;mes de
-        s&eacute;curit&eacute;. Cette option y rem&eacute;die. Par
-        d&eacute;faut :  <literal>0</literal>.
-       </simpara>
-     </listitem>
-     <listitem>
-       <simpara>
-        <literal>session.entropy_file</literal> est le chemin jusqu'&agrave;
-        une source externe (fichier) d'entropie, qui sera utilis&eacute;e
-        lors de la cr&eacute;ation de l'identifiant de session. Par exemple,
-        <literal>/dev/random</literal> ou <literal>/dev/urandom</literal> qui
-        sont disponibles sur de nombreux syst&egrave;mes UNIX.
-       </simpara>
-     </listitem>
-     <listitem>
-       <simpara>
-        <literal>session.entropy_length</literal> pr&eacute;cise le
-        nombre d'octets qui seront lus dans le fichier ci-dessus.
-        Par d&eacute;faut, <literal>0</literal> (inactiv&eacute;).
-       </simpara>
-     </listitem>
-     <listitem>
-       <simpara>
-        <literal>session.use_cookies</literal> cookies indique si le module doit
-        utiliser des cookies pour enregistrer l'identifiant de session chez le client.
-        Par d&eacute;faut, <literal>1</literal> (activ&eacute;).
-       </simpara>
+      <simpara>
+       <literal>session.name</literal> sp&eacute;cifie le nom de la session,
+       qui sera utilis&eacute; comme nom de cookie. Par d&eacute;faut :
+       <literal>PHPSESSID</literal>.
+      </simpara>
+     </listitem>
+     <listitem>
+    <simpara>
+     <literal>session.auto_start</literal> indique qu'une session doit
+     commencer automatiquement lors de la premier requ&ecirc;te. Par
+     d&eacute;faut, la valeur est &agrave; <literal>0</literal> (inactiv&eacute;).
+    </simpara>
+     </listitem>
+     <listitem>
+    <simpara>
+     <literal>session.lifetime</literal> fixe la dur&eacute;e de vie,
+     en secondes, du cookie envoy&eacute; au client. La valeur 0 signifie
+     "jusqu'&agrave; ce que le client soit ferm&eacute;". Par d&eacute;faut
+     &agrave; <literal>0</literal> (inactiv&eacute;).
+    </simpara>
+     </listitem>
+     <listitem>
+    <simpara>
+     <literal>session.serialize_handler</literal> d&eacute;finit le
+     nom de la fonction qui sera utilis&eacute;e pour enregistrer et
+     relire les donn&eacute;s. Actuellement, c'est un format interne
+     de PHP (nom : <literal>php</literal>) et WDDX (nom :
+     <literal>wddx</literal>). WDDX n'est utilisable que si
+     PHP a &eacute;t&eacute; compil&eacute; avec le
+     <link linkend="ref.wddx">support WDDX</link>. Par d&eacute;faut,
+     c'est le mode <literal>php</literal> qui est s&eacute;lectionn&eacute;.
+     </simpara>
+     </listitem>
+     <listitem>
+    <simpara>
+     <literal>session.gc_probability</literal> pr&eacute;cise la
+     probabilit&eacute; que la routine gc (garbage collection) soit
+     lanc&eacute;e, en pourcentage. Par d&eacute;faut, la valeur est &agrave;
+     <literal>1</literal>.
+    </simpara>
+     </listitem>
+     <listitem>
+    <simpara>
+     <literal>session.gc_maxlifetime</literal> fixe la dur&eacute;e,
+     en secondes, au-del&agrave; de laquelle les donn&eacute;es
+     consid&eacute;r&eacute;es comme inutiles seront supprim&eacute;es.
+    </simpara>
+     </listitem>
+     <listitem>
+    <simpara>
+     <literal>session.referer_check</literal> d&eacute;termine si
+     l'identifiant de session (session id) utilis&eacute; par des sites externes
+     seront &eacute;limin&eacute;s. Si les identifiants de session sont
+     propag&eacute;s avec la m&eacute;thode des URL, des utilisateurs qui
+     n'en conna&icirc;traient pas l'utilit&eacute; risquent de divulguer ces
+     valeurs, et cela m&egrave;nera &agrave; des probl&egrave;mes de
+     s&eacute;curit&eacute;. Cette option y rem&eacute;die. Par
+     d&eacute;faut : <literal>0</literal>.
+    </simpara>
+     </listitem>
+     <listitem>
+    <simpara>
+     <literal>session.entropy_file</literal> est le chemin jusqu'&agrave;
+     une source externe (fichier) d'entropie, qui sera utilis&eacute;e
+     lors de la cr&eacute;ation de l'identifiant de session. Par exemple,
+     <literal>/dev/random</literal> ou <literal>/dev/urandom</literal> qui
+     sont disponibles sur de nombreux syst&egrave;mes UNIX.
+    </simpara>
+     </listitem>
+     <listitem>
+    <simpara>
+     <literal>session.entropy_length</literal> pr&eacute;cise le
+     nombre d'octets qui seront lus dans le fichier ci-dessus.
+     Par d&eacute;faut, <literal>0</literal> (inactiv&eacute;).
+    </simpara>
+     </listitem>
+     <listitem>
+    <simpara>
+     <literal>session.use_cookies</literal> cookies indique si le module doit
+     utiliser des cookies pour enregistrer l'identifiant de session chez le client.
+     Par d&eacute;faut, <literal>1</literal> (activ&eacute;).
+    </simpara>
      </listitem>
     <listitem>
       <simpara>
@@ -305,22 +308,38 @@
      </listitem>
      <listitem>
       <simpara>
-       <literal>session.cache_limiter</literal> sp&eacute;cifie le controle du
-       cache, &agrave; utiliser avec les pages de sessions (nocache/private/public).
-          Par d&eacute;faut, <literal>nocache</literal>.
+       <literal>session.cache_limiter</literal> sp&eacute;cifie le contr&ocirc;le du
+       cache, &agrave; utiliser avec les pages de session (nocache/private/public).
+       Par d&eacute;faut, <literal>nocache</literal>.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        <literal>session.cache_expire</literal> sp&eacute;cifie la dur&eacute;e de vie
-       des pages de sessions cach&eacute;es, en minutes, mais sans que cela
-       n'ait d'efft sur le limiteur "nocache". Par d&eacute;faut, 
<literal>180</literal>.
+       des pages de session cach&eacute;es, en minutes, mais sans que cela
+       ait d'effets sur le limiteur "nocache". Par d&eacute;faut, 
+<literal>180</literal>.
       </simpara>
      </listitem>
-    </itemizedlist>
+     <listitem>
+      <simpara>
+       <literal>session.use_trans_sid</literal> indique si le support du
+       SID est activ&eacute; ou pas, lors de la compilation avec l'option
+       <link linkend="install.configure.enable-trans-sid">
+       <literal>--enable-trans-sid</literal></link>.
+       Par d&eacute;faut, elle vaut <literal>1</literal> (activ&eacute;e).
+      </simpara>
+     </listitem>
+     <listitem>
+      <simpara>
+       <literal>url_rewriter.tags</literal> spefifies which html tags are
+       rewritten to include session id if transient sid support is enabled.
+       Defaults to 
+<literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal>
+      </simpara>
+     </listitem>
+     </itemizedlist>
     <note>
      <para>
-          La gestion des sessions a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0.
+      La gestion des sessions a &eacute;t&eacute; ajout&eacute;e en PHP 4.0.
      </para>
     </note>
    </para>
@@ -334,7 +353,7 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>session_start</function></funcdef>
+      <funcdef>boolean <function>session_start</function></funcdef>
       <paramdef>void</paramdef>
      </funcprototype>
     </funcsynopsis>
@@ -344,11 +363,11 @@
      session pass&eacute; par une variable GET ou par un cookie)
     </simpara>
     <simpara>
-     <function>session_start</function> retourne toujours &true;.
+     <function>session_start</function> retourne toujours <literal>TRUE</literal>.
     </simpara>
     <note>
      <para>
-          <function>session_start</function> a &eacute;t&eacute; ajout&eacute;e en 
PHP 4.0.
+       <function>session_start</function> a &eacute;t&eacute; ajout&eacute;e en PHP 
+4.0.
      </para>
     </note>
    </refsect1>
@@ -364,7 +383,7 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>session_destroy</function></funcdef>
+      <funcdef>boolean <function>session_destroy</function></funcdef>
       <paramdef>void</paramdef>
      </funcprototype>
     </funcsynopsis>
@@ -373,8 +392,8 @@
      donn&eacute;es associ&eacute;es &agrave; la session courante.
     </simpara>
     <simpara>
-     <function>session_destroy</function> retourne &true; en
-     cas de succ&egrave;s, et &false; sinon.
+     <function>session_destroy</function> retourne <literal>TRUE</literal> en
+     cas de succ&egrave;s, et <literal>FALSE</literal> sinon.
     </simpara>
    </refsect1>
   </refentry>
@@ -386,10 +405,12 @@
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
+     <funcprototype>
      <funcdef>string <function>session_name</function></funcdef>
      <paramdef>string
-       <parameter><optional>name</optional></parameter>
+    <parameter><optional>name</optional></parameter>
      </paramdef>
+     </funcprototype>
     </funcsynopsis>
     <para>
      <function>session_name</function>retourne le nom de la session courante.
@@ -402,7 +423,7 @@
      caract&egrave;res alpha-num&eacute;riques; il doit &ecirc;tre court et
      descriptif.  (i.e. surtout pour les utilisateurs d'alertes de cookie).
      Le nom de session est remis &agrave; une valeur par d&eacute;faut,
-     enregistr&eacute;es dans <literal>session.name</literal> au moment
+     enregistr&eacute;e dans <literal>session.name</literal> au moment
      du d&eacute;marrage. Ainsi, vous devez appeler
      <function>session_name</function> &agrave; chaque requ&ecirc;te
      (et avant <function>session_start</function> ou
@@ -420,8 +441,8 @@
     </example>
     <note>
      <para>
-          <function>session_name</function> a &eacute;t&eacute; ajout&eacute;e
-          en PHP 4.0.
+       <function>session_name</function> a &eacute;t&eacute; ajout&eacute;e
+       en PHP 4.0.
      </para>
     </note>
    </refsect1>
@@ -446,10 +467,10 @@
      le module courant de session courante. Si <parameter>module</parameter>
      est fourni, ce module sera utilis&eacute; &agrave; la place du courant.
      <note>
-         <para>
-          <function>session_module_name</function> a &eacute;t&eacute; ajout&eacute;e
-          en PHP 4.0.
-         </para>
+      <para>
+       <function>session_module_name</function> a &eacute;t&eacute; ajout&eacute;e
+       en PHP 4.0.
+      </para>
      </note>
     </para>
    </refsect1>
@@ -475,19 +496,19 @@
      sessions. Si <parameter>path</parameter> est fourni, le chemin
      prendra alors la valeur fournie.
      <note>
-         <para>
-          Sur certains syst&egrave;mes d'exploitation, il vous faudra peut
-          &ecirc;tre fournir un chemin vers un syst&egrave;me de sauvegarde
-          qui peut g&eacute;rer de grandes quantit&eacute;s de petits
-          fichiers efficacement : par exemple, sous Linux, reiserfs peut
-          &ecirc;tre plus efficace que ext2fs.
-       </para>
+      <para>
+       Sur certains syst&egrave;mes d'exploitation, il vous faudra peut
+       &ecirc;tre fournir un chemin vers un syst&egrave;me de sauvegarde
+       qui peut g&eacute;rer efficacement de grandes quantit&eacute;s de petits
+       fichiers : par exemple, sous Linux, reiserfs peut &ecirc;tre plus efficace
+       que ext2fs.
+    </para>
      </note>
      <note>
-         <para>
-          <function>session_save_path</function> a &eacute;t&eacute; ajout&eacute;e
-          en PHP 4.0.
-         </para>
+      <para>
+          <function>session_save_path</function> a &eacute;t&eacute; ajout&eacute;e
+          en PHP 4.0.
+      </para>
      </note>
     </para>
    </refsect1>
@@ -515,10 +536,10 @@
      utilis&eacute;e pour retrouver le nom de la session courante et
      son identifiant, comme cha&icirc;ne &agrave; ajouter dans les URL.
      <note>
-         <para>
-          <function>session_id</function> a &eacute;t&eacute; ajout&eacute;e
-          en PHP 4.0.
-         </para>
+      <para>
+       <function>session_id</function> a &eacute;t&eacute; ajout&eacute;e
+       en PHP 4.0.
+      </para>
      </note>
     </para>
    </refsect1>
@@ -534,7 +555,7 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>session_register</function></funcdef>
+      <funcdef>boolean <function>session_register</function></funcdef>
       <paramdef>mixed <parameter>name</parameter></paramdef>
       <paramdef>mixed
        <parameter><optional>...</optional></parameter></paramdef>
@@ -542,19 +563,32 @@
     </funcsynopsis>
     <para>
      <function>session_register</function> enregistre une variable avec
-     le nom name dans la session courante. <function>session_register</function>
-     accepte un nombre d'arguments variable, qui peuvent &ecirc;tre des cha&icirc;nes
-     repr&eacute;sentant le nom de la variable, ou bien un tableau, 
repr&eacute;sentant
-     des cha&icirc;nes ou d'autre tableau (r&eacute;cursif).
+     le nom <parameter>name</parameter> dans la session courante.
+     <function>session_register</function> accepte un nombre d'arguments
+     variable. Ces arguments peuvent &ecirc;tre soit des cha&icirc;nes 
+repr&eacute;sentants
+     le nom de la variable, soit un tableau, contenant des cha&icirc;nes ou
+     d'autres tableaux (cas d'un tableau r&eacute;cursif).
     </para>
     <para>
-       <function>session_register</function> retourne &true; lorsque
-       la variable est correctement enregistr&eacute;e.
+    <function>session_register</function> retourne <literal>TRUE</literal> lorsque
+    les variables sont correctement enregistr&eacute;es.
+    <note>
+     <para>
+      Actuellement, il n'est pas possible d'enregistrer des variables de
+      ressources dans une session. Par exemple, vous ne pouvez pas cr&eacute;er une
+      connexion &agrave; une base de donn&eacute;es dans un script, la stocker dans 
+une session,
+      et retrouver cette connexion lors de la prochaine utilisation de la
+      session. Les fonctions qui retournent des ressources PHP sont identif&eacute;es
+      par leur valeur de retour <literal>resource</literal>, dans leur fonction
+      de d&eacute;finition. Vous pouvez aussi les retrouver dans les
+      <link linkend="resources">annexes</link>.
+     </para>
+    </note>
      <note>
-         <para>
-          <function>session_register</function> a &eacute;t&eacute; ajout&eacute;e
-          en PHP 4.0.
-         </para>
+      <para>
+         <function>session_register</function> a &eacute;t&eacute; ajout&eacute;e
+         en PHP 4.0.
+      </para>
      </note>
     </para>
    </refsect1>
@@ -570,7 +604,7 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>session_unregister</function></funcdef>
+      <funcdef>boolean <function>session_unregister</function></funcdef>
       <paramdef>string <parameter>name</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
@@ -579,14 +613,14 @@
      nomm&eacute;e <parameter>name</parameter> dans la session courante.
     </para>
     <para>
-     <function>session_unregister</function> retourne &true;
+     <function>session_unregister</function> retourne <literal>TRUE</literal>
      lorsque la variable a &eacute;t&eacute; correctement supprim&eacute;e
      de la session.
      <note>
-         <para>
-          <function>session_unregister</function> a &eacute;t&eacute; ajout&eacute;e
-          en PHP 4.0.
-         </para>
+      <para>
+       <function>session_unregister</function> a &eacute;t&eacute; ajout&eacute;e
+       en PHP 4.0.
+      </para>
      </note>
     </para>
    </refsect1>
@@ -623,19 +657,19 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>session_is_registered</function></funcdef>
+      <funcdef>boolean <function>session_is_registered</function></funcdef>
       <paramdef>string <parameter>name</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
-     <function>session_is_registered</function> retourne &true;
+     <function>session_is_registered</function> retourne <literal>TRUE</literal>
      s'il y a une variable du nom de <parameter>name</parameter>
      enregistr&eacute;e dans la session courante.
      <note>
-         <para>
-          <function>session_is_registered</function> a &eacute;t&eacute; 
ajout&eacute;e
-          en PHP 4.0.
-         </para>
+      <para>
+       <function>session_is_registered</function> a &eacute;t&eacute; ajout&eacute;e
+       en PHP 4.0.
+      </para>
      </note>
     </para>
    </refsect1>
@@ -693,21 +727,21 @@
     <funcsynopsis>
      <funcprototype>
       <funcdef>void <function>session_set_cookie_params</function></funcdef>
-      <paramdef>
-       int <parameter>lifetime</parameter>
+      <paramdef>int
+       <parameter>lifetime</parameter>
       </paramdef>
-      <paramdef>
-       string <parameter><optional>path</optional></parameter>
+      <paramdef>string
+       <parameter><optional>path</optional></parameter>
       </paramdef>
-      <paramdef>
-       string <parameter><optional>domain</optional></parameter>
+      <paramdef>string
+       <parameter><optional>domain</optional></parameter>
       </paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      <function>session_set_cookie_params</function> modifie les
-     param&egrave;tres du cookie de session, tel qu'ils ont &eacute;t&eacute; 
d&eacute;finis dans
-     le fichier <filename>php.ini</filename>.  L'effet de cette
+     param&egrave;tres du cookie de session, tels qu'ils ont &eacute;t&eacute;
+     d&eacute;finis dans le fichier <filename>php.ini</filename>.  L'effet de cette
      fonction ne dure que le temps du script.
     </para>
    </refsect1>
@@ -723,7 +757,7 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>session_decode</function></funcdef>
+      <funcdef>boolean <function>session_decode</function></funcdef>
       <paramdef>string <parameter>data</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
@@ -732,10 +766,10 @@
      de session &agrave; partir de la cha&icirc;ne <parameter>data</parameter>,
      et affecte les valeurs des variables de session.
      <note>
-         <para>
-          <function>session_decode</function> a &eacute;t&eacute; ajout&eacute;e
-          en PHP 4.0.
-         </para>
+      <para>
+       <function>session_decode</function> a &eacute;t&eacute; ajout&eacute;e
+       en PHP 4.0.
+      </para>
      </note>
     </para>
    </refsect1>
@@ -750,17 +784,19 @@
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
-     <funcdef>bool <function>session_encode</function></funcdef>
+     <funcprototype>
+     <funcdef>boolean <function>session_encode</function></funcdef>
      <paramdef>void</paramdef>
+     </funcprototype>
     </funcsynopsis>
     <para>
      <function>session_encode</function> retourne les donn&eacute;es de
      session dans une cha&icirc;ne.
      <note>
-         <para>
-          <function>session_encode</function> a &eacute;t&eacute; ajout&eacute;e
-          en PHP 4.0.
-         </para>
+      <para>
+       <function>session_encode</function> a &eacute;t&eacute; ajout&eacute;e
+       en PHP 4.0.
+      </para>
      </note>
     </para>
    </refsect1>
@@ -806,7 +842,7 @@
     </note>
     <para>
      L'exemple suivant fournit un exemple de stockage de session
-     dans un fichier, similaire aux fonctions standard de PHP. Cet
+     dans un fichier, similaire aux fonctions standards de PHP. Cet
      exemple peut &ecirc;tre facilement &eacute;tendu pour utiliser un
      stockage en base de donn&eacute;es, en utilisant votre base 
pr&eacute;f&eacute;r&eacute;e.
     </para>
@@ -887,12 +923,13 @@
      le nom du limiteur de cache est remplac&eacute; par cette nouvelle valeur.
     </para>
     <para>
-     Le limiteur de cache contr&ocirc;le l'envoi des ent&ecirc;te HTTP envoy&eacute;s 
au client.
-     Ces ent&ecirc;tes d&eacute;terminent les r&egrave;gles de mise en cache des 
pages. En utilisant
-     la valeur de <literal>nocache</literal>, par exemple, vous d&eacute;sactiverez
-     la mise en cache cot&eacute; client. La valeur de <literal>public</literal>,
-     cependant, le permettra. <literal>private</literal> aussi,
-     tout en &eacute;tant l&eacute;g&egrave;rement plus restrictive que 
<literal>public</literal>.
+     Le limiteur de cache contr&ocirc;le l'envoi des en-t&ecirc;tes HTTP 
+envoy&eacute;s
+     au client. Ces en-t&ecirc;tes d&eacute;terminent les r&egrave;gles de mise en
+     cache des pages. En utilisant la valeur de <literal>nocache</literal>, par
+     exemple, vous d&eacute;sactiverez la mise en cache c&ocirc;t&eacute; client. La
+     valeur de <literal>public</literal>, cependant, le permettra.
+     <literal>private</literal> aussi, tout en &eacute;tant l&eacute;g&egrave;rement
+     plus restrictive que <literal>public</literal>.
     </para>
     <para>
      Le limiteur de cache est remis &agrave; sa valeur par d&eacute;faut, 
stock&eacute;e dans

Reply via email to