[PHP-DOC] cvs: phpdoc /fr/functions network.xml

[Damien Seguy]

dams            Mon Oct 22 22:18:53 2001 EDT

  Modified files:              
    /phpdoc/fr/functions        network.xml 
  Log:
  Correcting bug report.
  
Index: phpdoc/fr/functions/network.xml
diff -u phpdoc/fr/functions/network.xml:1.12 phpdoc/fr/functions/network.xml:1.13
--- phpdoc/fr/functions/network.xml:1.12        Sat Jul  7 18:22:17 2001
+++ phpdoc/fr/functions/network.xml     Mon Oct 22 22:18:53 2001
@@ -1,3 +1,5 @@
+<?xml encoding="iso-8859-1"?>
+<!-- $Revision: 1.13 $ -->
  <reference id="ref.network">
   <title>R&eacute;seau</title>
   <titleabbrev>R&eacute;seau</titleabbrev>
@@ -33,7 +35,11 @@
       x.x.x.x avec x entre 0 et 256, soit un nom d'h&ocirc;te.
     </simpara>
     <simpara>
-     Voir aussi <function>getmxrr</function>,
+     <function>checkdnsrr</function> n'est pas disponible sous Windows.
+    </simpara>
+    <simpara>
+     Voir aussi
+     <function>getmxrr</function>,
      <function>gethostbyaddr</function>,
      <function>gethostbyname</function>,
      <function>gethostbynamel</function> et
@@ -60,7 +66,8 @@
       <function>closelog</function> est optionnelle.
     </para>
     <para>
-     Voir aussi <function>define_syslog_variables</function>,
+     Voir aussi
+     <function>define_syslog_variables</function>,
      <function>syslog</function> et
      <function>openlog</function>.
     </para>
@@ -93,8 +100,9 @@
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
-     <funcdef>int <function>debugger_on</function></funcdef>
+     <funcprototype>     <funcdef>int <function>debugger_on</function></funcdef>
      <paramdef>string <parameter>address</parameter></paramdef>
+     </funcprototype>
     </funcsynopsis>
     <para>
       <function>debugger_on</function> active le debugger interne de PHP, et
@@ -121,7 +129,8 @@
      constantes utilis&eacute;es par les fonctions de syslog.
     </para>
     <para>
-     Voir aussi <function>openlog</function>,
+     Voir aussi
+     <function>openlog</function>,
      <function>syslog</function> et
      <function>closelog</function>.
     </para>
@@ -137,8 +146,8 @@
     <funcsynopsis>
      <funcprototype>
       <funcdef>int <function>fsockopen</function></funcdef>
-      <paramdef>
-        string <parameter><optional>udp://</optional>hostname</parameter>
+      <paramdef>string
+       <parameter><optional>udp://</optional>hostname</parameter>
       </paramdef>
       <paramdef>int <parameter>port</parameter></paramdef>
       <paramdef>int
@@ -147,13 +156,13 @@
       <paramdef>string
        <parameter><optional>errstr</optional></parameter>
       </paramdef>
-      <paramdef>double
+      <paramdef>float
        <parameter><optional>timeout</optional></parameter>
       </paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
-      <function>fsockopen</function> cr&eacute;er un flot de connexion &agrave;
+      <function>fsockopen</function> cr&eacute;e un flot de connexion &agrave;
       l'Internet (AF_INET) ou &agrave; un domaine Unix (AF_UNIX). Via Internet,
       cette fonction va ouvrir une socket de connexion TCP avec l'h&ocirc;te
       <parameter>hostname</parameter> sur le port <parameter>port</parameter>.
@@ -227,11 +236,15 @@
       a &eacute;t&eacute; introduit en PHP 3.0.9 et le support UDP en PHP 4.
       </para>
      </note>
-     Voir aussi: <function>pfsockopen</function>,
+     Voir aussi
+     <function>pfsockopen</function>,
      <function>socket_set_blocking</function>,
-     <function>socket_set_timeout</function>, <function>fgets</function>,
-     <function>fgetss</function>, <function>fputs</function>,
-     <function>fclose</function>, et <function>feof</function>.
+     <function>socket_set_timeout</function>,
+     <function>fgets</function>,
+     <function>fgetss</function>,
+     <function>fputs</function>,
+     <function>fclose</function> et
+     <function>feof</function>.
     </para>
    </refsect1>
   </refentry>
@@ -256,7 +269,8 @@
       Si une erreur survient, retourne <parameter>ip_address</parameter>.
     </para>
      <para>
-      Voir aussi <function>gethostbyname</function>.
+      Voir aussi
+      <function>gethostbyname</function>.
      </para>
    </refsect1>
   </refentry>
@@ -280,7 +294,8 @@
       correspondant &agrave; l'h&ocirc;te <parameter>hostname</parameter>.
     </para>
      <para>
-       Voir aussi <function>gethostbyaddr</function>.
+       Voir aussi
+       <function>gethostbyaddr</function>.
      </para>
    </refsect1>
   </refentry>
@@ -288,7 +303,7 @@
    <refnamediv>
     <refname>gethostbynamel</refname>
     <refpurpose>
-      Retourne la liste d'IP correspondants &agrave; un h&ocirc;te.
+      Retourne la liste d'IP correspondante &agrave; un h&ocirc;te.
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -304,9 +319,11 @@
       correspondant &agrave; l'h&ocirc;te <parameter>hostname</parameter>.
     </para>
     <para>
-     Voir aussi <function>gethostbyname</function>,
+     Voir aussi
+     <function>gethostbyname</function>,
      <function>gethostbyaddr</function>,
-     <function>checkdnsrr</function>, <function>getmxrr</function>
+     <function>checkdnsrr</function>,
+     <function>getmxrr</function>
      et la page 8 du manuel.
     </para>
    </refsect1>
@@ -342,8 +359,10 @@
     </simpara>
     <simpara>
      Voir aussi
-     <function>checkdnsrr</function>, <function>gethostbyname</function>,
-     <function>gethostbynamel</function>, <function>gethostbyaddr</function>,
+     <function>checkdnsrr</function>,
+     <function>gethostbyname</function>,
+     <function>gethostbynamel</function>,
+     <function>gethostbyaddr</function>,
      et la page 8 du manuel.
     </simpara>
    </refsect1>
@@ -352,7 +371,7 @@
    <refnamediv>
     <refname>getprotobyname</refname>
     <refpurpose>
-      Retourne le num&eacute;ro de protocole associ&eacute; au nom de protocole
+      Retourne le num&eacute;ro de protocole associ&eacute; &agrave; un nom de 
+protocole
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -369,7 +388,8 @@
      <parameter>name</parameter>, comme dans <filename>/etc/protocols</filename>.
      </para>
      <para>
-     Voir aussi <function>getprotobynumber</function>.
+     Voir aussi
+     <function>getprotobynumber</function>.
     </para>
    </refsect1>
   </refentry>
@@ -377,7 +397,7 @@
    <refnamediv>
     <refname>getprotobynumber</refname>
     <refpurpose>
-      Retourne le nom de protocole associ&eacute; au num&eacute;ro de protocole
+      Retourne le nom de protocole associ&eacute; &agrave; un num&eacute;ro de 
+protocole
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -389,12 +409,13 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-     <function>getprotobynumber</function> retourne le num&eacute;ro
-     de protocole associ&eacute; avec le nom de protocole
+     <function>getprotobynumber</function> retourne le nom
+     de protocole associ&eacute; avec le num&eacute;ro de protocole
      <parameter>name</parameter>, comme dans <filename>/etc/protocols</filename>.
      </para>
      <para>
-       Voir aussi <function>getprotobyname</function>.
+       Voir aussi
+       <function>getprotobyname</function>.
      </para>
    </refsect1>
   </refentry>
@@ -403,7 +424,7 @@
     <refname>getservbyname</refname>
     <refpurpose>
       Retourne le num&eacute;ro de port associ&eacute; &agrave; un service
-      Internet, et un protocole.
+      Internet et un protocole.
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -417,13 +438,14 @@
     </funcsynopsis>
     <para>
       <function>getservbyname</function> retourne le num&eacute;ro de
-      port associ&eacute; &agrave; au service <parameter>service</parameter>
-      et protocole <parameter>protocol</parameter>, comme dans
+      port associ&eacute; au service <parameter>service</parameter>
+      et au protocole <parameter>protocol</parameter>, comme dans
       <filename>/etc/services</filename>. <parameter>protocol</parameter>
-      vaut soit <literal>tcp</literal> ou <literal>udp</literal>.
+      vaut soit <literal>tcp</literal>, soit <literal>udp</literal>.
     </para>
     <para>
-      Voir aussi <function>getservbyport</function>.
+      Voir aussi
+      <function>getservbyport</function>.
     </para>
    </refsect1>
   </refentry>
@@ -447,11 +469,12 @@
       <function>getservbyport</function> le service internet associ&eacute; au port
       <parameter>port</parameter> pour le protocole <parameter>protocol</parameter>
       comme dans <filename>/etc/services</filename>.
-      <parameter>protocol</parameter> vaut soit <literal>tcp</literal> ou
+      <parameter>protocol</parameter> vaut soit <literal>tcp</literal>, soit
       <literal>udp</literal>.
     </para>
     <para>
-      Voir aussi <function>getservbyname</function>.
+      Voir aussi
+      <function>getservbyname</function>.
     </para>
    </refsect1>
   </refentry>
@@ -460,7 +483,7 @@
     <refname>ip2long</refname>
     <refpurpose>
       Convertit une cha&icirc;ne contenant une adresse (IPv4)
-      IP num&eacute;rique en adresse lit&eacute;rale.
+      IP num&eacute;rique en adresse litt&eacute;rale.
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -472,7 +495,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-     <function>ip2long</function> g&eacute;n&eacute;re une adresse
+     <function>ip2long</function> g&eacute;n&egrave;re une adresse
      IPv4 &agrave; partir de son &eacute;quivalent num&eacute;rique.
      <example>
      <title>Exemple <function>ip2long</function></title>
@@ -486,8 +509,23 @@
      </programlisting>
      </example>
     </para>
+     <para>
+     Ce second exemple montre comment afficher une adresse convertie
+     &agrave; l'aide de la fonction <function>printf</function> :
+     <example>
+     <title>Affichage d'adresse IP</title>
+     <programlisting role="php">
+&lt;?php
+       $ip = gethostbyname("www.php.net");
+       printf ("%u\n", ip2long ($ip));
+       echo $out;
+?&gt;
+     </programlisting>
+     </example>
+    </para>
     <para>
-     Voir aussi: <function>long2ip</function>
+     Voir aussi
+     <function>long2ip</function>
     </para>
    </refsect1>
   </refentry>
@@ -507,12 +545,13 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-     <function>long2ip</function> g&eacute;n&eacute;re une adresse IP
+     <function>long2ip</function> g&eacute;n&egrave;re une adresse IP
      (format aaa.bbb.ccc.ddd) &agrave; partir de sa repr&eacute;sentation
-     lit&eacute;rale.
+     litt&eacute;rale.
     </para>
     <para>
-     Voir aussi: <function>ip2long</function>
+     Voir aussi
+     <function>ip2long</function>
     </para>
    </refsect1>
   </refentry>
@@ -534,7 +573,7 @@
     <para>
       <function>openlog</function> ouvre la connexion &agrave; l'historique
       syst&egrave;me. La cha&icirc;ne <parameter>ident</parameter> sera
-      ajout&eacute; &agrave; chaque message. Les valeurs de
+      ajout&eacute;e &agrave; chaque message. Les valeurs de
       <parameter>option</parameter> et <parameter>facility</parameter> sont
       donn&eacute;es ci-dessous. L'utilisation de  <function>openlog</function>
       est optionnelle; cette fonction sera automatiquement appel&eacute;e par
@@ -572,8 +611,8 @@
         <row>
          <entry>LOG_ODELAY</entry>
          <entry>
-          (par d&eacute;faut) retarde l'ouverture de la connexion jusqu'&agrave; ce 
que le
-          premier message soit enregistr&eacute;
+          Retarde l'ouverture de la connexion jusqu'&agrave; ce que le
+          premier message soit enregistr&eacute; (par d&eacute;faut)
          </entry>
         </row>
         <row>
@@ -582,7 +621,7 @@
         </row>
         <row>
          <entry>LOG_PID</entry>
-         <entry>Inclus le PID &agrave; chaque message</entry>
+         <entry>Inclut le PID &agrave; chaque message</entry>
         </row>
        </tbody>
       </tgroup>
@@ -609,17 +648,17 @@
         <row>
          <entry>LOG_AUTH</entry>
          <entry>
-          securit&eacute;/messages d'autorisation (utilisez LOG_AUTHPRIV, pour
+          s&eacute;curit&eacute;/messages d'autorisation (utilisez LOG_AUTHPRIV, pour
           remplacer cette constante sur les syst&egrave;mes o&ugrave; elle est 
d&eacute;finie).
          </entry>
         </row>
         <row>
          <entry>LOG_AUTHPRIV</entry>
-         <entry>securit&eacute;/messages d'autorisation (priv&eacute;)</entry>
+         <entry>s&eacute;curit&eacute;/messages d'autorisation (priv&eacute;)</entry>
         </row>
         <row>
          <entry>LOG_CRON</entry>
-         <entry>d&eacute;mon horologe (cron et at)</entry>
+         <entry>d&eacute;mon horloge (cron et at)</entry>
         </row>
         <row>
          <entry>LOG_DAEMON</entry>
@@ -631,7 +670,7 @@
         </row>
         <row>
          <entry>LOG_LOCAL0 ... LOG_LOCAL7</entry>
-         <entry>reserv&eacute; pour utilisation ult&eacute;rieure</entry>
+         <entry>r&eacute;serv&eacute; pour utilisation ult&eacute;rieure</entry>
         </row>
         <row>
          <entry>LOG_LPR</entry>
@@ -643,11 +682,11 @@
         </row>
         <row>
          <entry>LOG_NEWS</entry>
-         <entry>USENET newsgroup</entry>
+         <entry>USENET : groupes de news (newsgroup)</entry>
         </row>
         <row>
          <entry>LOG_SYSLOG</entry>
-         <entry>messages gener&eacute; en interne par syslogd</entry>
+         <entry>messages g&eacute;n&eacute;r&eacute;s en interne par syslogd</entry>
         </row>
         <row>
          <entry>LOG_USER</entry>
@@ -662,8 +701,10 @@
      </table>
     </para>
     <para>
-     Voir aussi <function>define_syslog_variables</function>,
-     <function>syslog</function> et <function>closelog</function>.
+     Voir aussi
+     <function>define_syslog_variables</function>,
+     <function>syslog</function> et
+     <function>closelog</function>.
     </para>
    </refsect1>
   </refentry>
@@ -726,19 +767,19 @@
     <itemizedlist>
      <listitem>
       <para>
-       <parameter>timed_out</parameter> (bool) - La socket a &eacute;xpir&eacute;e en
+       <parameter>timed_out</parameter> (boolean) - La socket a expir&eacute;e en
        attendant des donn&eacute;es
       </para>
      </listitem>
      <listitem>
       <para>
-       <parameter>blocked</parameter> (bool) - La socket a &eacute;t&eacute;
+       <parameter>blocked</parameter> (boolean) - La socket a &eacute;t&eacute;
        bloqu&eacute;e
       </para>
      </listitem>
      <listitem>
       <para>
-       <parameter>eof</parameter> (bool) - Indique un &eacute;v&eacute;nement
+       <parameter>eof</parameter> (boolean) - Indique un &eacute;v&eacute;nement
        fin de fichier (EOF)
       </para>
      </listitem>
@@ -750,9 +791,12 @@
      </listitem>
     </itemizedlist>
     <para>
-     Voir aussi <function>accept_connect</function>,
-     <function>bind</function>, <function>connect</function>,
-     <function>listen</function> et <function>strerror</function>.
+     Voir aussi
+     <function>accept_connect</function>,
+     <function>bind</function>,
+     <function>connect</function>,
+     <function>listen</function> et
+     <function>strerror</function>.
     </para>
    </refsect1>
   </refentry>
@@ -766,7 +810,7 @@
     <funcsynopsis>
      <funcprototype>
       <funcdef>int <function>socket_set_blocking</function></funcdef>
-      <paramdef>int <parameter>socket descriptor</parameter></paramdef>
+      <paramdef>int <parameter>socket_descriptor</parameter></paramdef>
       <paramdef>int <parameter>mode</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
@@ -790,15 +834,15 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>socket_set_timeout</function></funcdef>
-      <paramdef>int <parameter>socket descriptor</parameter></paramdef>
+      <funcdef>boolean <function>socket_set_timeout</function></funcdef>
+      <paramdef>int <parameter>socket_descriptor</parameter></paramdef>
       <paramdef>int <parameter>seconds</parameter></paramdef>
       <paramdef>int <parameter>microseconds</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      <function>socket_set_timeout</function> fixe la dur&eacute;e de vie de la
-     socket <parameter>socket descriptor</parameter>, exprim&eacute;e comme la somme
+     socket <parameter>socket_descriptor</parameter>, exprim&eacute;e comme la somme
      de <parameter>seconds</parameter> secondes et <parameter>microseconds</parameter>
      micro-secondes.
      <example>
@@ -826,7 +870,9 @@
      mais elle est d&eacute;sormais obsol&egrave;te.
     </para>
     <para>
-     Voir aussi: <function>fsockopen</function> et <function>fopen</function>.
+     Voir aussi
+     <function>fsockopen</function> et
+     <function>fopen</function>.
     </para>
    </refsect1>
   </refentry>
@@ -834,7 +880,7 @@
    <refnamediv>
     <refname>syslog</refname>
     <refpurpose>
-      G&eacute;n&eacute;re un message dans l'historique syst&egrave;me.
+      G&eacute;n&egrave;re un message dans l'historique syst&egrave;me.
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -847,11 +893,11 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-      <function>syslog</function> g&eacute;n&eacute;re un message qui
+      <function>syslog</function> g&eacute;n&egrave;re un message qui
       sera inscrit dans l'historique par le syst&egrave;me.
       <parameter>priority</parameter> est une combinaison des valeurs
       d'acc&egrave;s et de niveau, qui seront d&eacute;crites dans la
-      procha&icirc;ne section. Les derniers arguments sont le message
+      prochaine section. Le dernier argument est le message
       &agrave; envoyer. Attention : les caract&egrave;res <literal>%m</literal>
       seront remplac&eacute;s par l'erreur (sous forme de cha&icirc;ne),
       pr&eacute;sente dans <errortype>errno</errortype>.
@@ -909,10 +955,10 @@
       <programlisting role="php">
 &lt;?php
 define_syslog_variables();
-// ouverture de syslog, ajout du PID et envoie simultan&eacute; du
-// message &agrave; la sortie standard et &agrave; un mecanisme
+// ouverture de syslog, ajout du PID et envoi simultan&eacute; du
+// message &agrave; la sortie standard et &agrave; un m&eacute;canisme
 // sp&eacute;cifique
-openlog(&quot;myScripLog&quot;, LOG_PID | LOG_PERROR, LOG_LOCAL0);
+openlog(&quot;myScriptLog&quot;, LOG_PID | LOG_PERROR, LOG_LOCAL0);
 // quelques lignes de code
 if (authorized_client()) {
     // faire quelquechose
@@ -927,7 +973,7 @@
       </programlisting>
      </example>
      Pour plus d'informations sur comment mettre en place un gestionnaire
-     d'historique, reportez vous au manuel Unix, page 5
+     d'historique, reportez-vous au manuel Unix, page 5
      <citerefentry><refentrytitle>syslog.conf</refentrytitle>
      <manvolnum>5</manvolnum></citerefentry>.  D'autres informations
      sur les syst&egrave;mes d'historique et leurs options sont aussi