dams Thu Feb 1 05:42:42 2001 EDT Modified files: /phpdoc/fr/functions strings.xml mcal.xml imap.xml Log: Notice some acronyms
Index: phpdoc/fr/functions/strings.xml diff -u phpdoc/fr/functions/strings.xml:1.21 phpdoc/fr/functions/strings.xml:1.22 --- phpdoc/fr/functions/strings.xml:1.21 Tue Jan 30 00:45:20 2001 +++ phpdoc/fr/functions/strings.xml Thu Feb 1 05:42:42 2001 @@ -1491,7 +1491,7 @@ 8-bit résultant du décodage de la chaîne <parameter>str</parameter>. <function>quoted_printable_decode</function> est similaire à <function>imap_qprint</function>, hormis le fait - qu'elle ne requiert pas le module IMAP. + qu'elle ne requiert pas le module <acronym>IMAP</acronym>. </simpara> </refsect1> </refentry> Index: phpdoc/fr/functions/mcal.xml diff -u phpdoc/fr/functions/mcal.xml:1.5 phpdoc/fr/functions/mcal.xml:1.6 --- phpdoc/fr/functions/mcal.xml:1.5 Tue Jan 30 00:45:20 2001 +++ phpdoc/fr/functions/mcal.xml Thu Feb 1 05:42:42 2001 @@ -8,7 +8,8 @@ <para> Libmcal est une librairie C de calendriers. Elle est écrite pour être très modulaire, et dispose de nombreux modules. - MCAL est l'équivalent de IMAP pour les calendriers. + MCAL est l'équivalent de <acronym>IMAP</acronym> pour les + calendriers. </para> <para> Avec mcal, un calendrier peut être ouvert comme une boîte Index: phpdoc/fr/functions/imap.xml diff -u phpdoc/fr/functions/imap.xml:1.6 phpdoc/fr/functions/imap.xml:1.7 --- phpdoc/fr/functions/imap.xml:1.6 Tue Jan 30 00:45:19 2001 +++ phpdoc/fr/functions/imap.xml Thu Feb 1 05:42:42 2001 @@ -23,14 +23,15 @@ <function>imap_open</function> pour plus d'informations. </simpara> <para> - Ce document ne peut entrer dans les détails de toutes les sujets abordés. - Plus d'informations sont disponibles avec la documentation de la librairie - C (<filename>docs/internal.txt</filename>). ainsi que les RFC suivantes : + Ce document ne peut entrer dans les détails de toutes les sujets + abordés. Plus d'informations sont disponibles avec la documentation + de la librairie C (<filename>docs/internal.txt</filename>). ainsi que + les RFC suivantes : <itemizedlist> <listitem> <simpara> <ulink url="&url.rfc;rfc821.html">RFC821</ulink>: Simple Mail - Transfer Protocol (SMTP). + Transfer Protocol (<acronym>SMTP</acronym>). </simpara> </listitem> <listitem> @@ -42,19 +43,19 @@ <listitem> <simpara> <ulink url="&url.rfc;rfc2060.html">RFC2060</ulink>: Internet - Message Access Protocol (IMAP) Version 4rev1. + Message Access Protocol (<acronym>IMAP</acronym>) Version +4rev1. </simpara> </listitem> <listitem> <simpara> <ulink url="&url.rfc;rfc1939.html">RFC1939</ulink>: Post - Office Protocol Version 3 (POP3). + Office Protocol Version 3 (<acronym>POP3</acronym>). </simpara> </listitem> <listitem> <simpara> <ulink url="&url.rfc;rfc977.html">RFC977</ulink>: Network News - Transfer Protocol (NNTP). + Transfer Protocol (<acronym>NNTP</acronym>). </simpara> </listitem> <listitem> @@ -85,7 +86,7 @@ <refnamediv> <refname>imap_append</refname> <refpurpose> - Ajoute une chaîne dans une boîte au lettre. + Ajoute une chaîne dans une boîte aux lettres. </refpurpose> </refnamediv> <refsect1> @@ -242,8 +243,9 @@ </listitem> <listitem> <simpara> - Driver - protocole utilisé pour accéder à la boîte aux lettres: - POP3, IMAP, NNTP + Driver - protocole utilisé pour accéder à la + boîte aux lettres: <acronym>POP3</acronym>, +<acronym>IMAP</acronym>, + <acronym>NNTP</acronym>. </simpara> </listitem> <listitem> @@ -280,9 +282,10 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_close</function> termine un flot IMAP. Prend un argument - optionnel <parameter>flag</parameter>, CL_EXPUNGE, qui va retirer - automatiquement de la liste la boîte aux lettres. + <function>imap_close</function> termine un flot <acronym>IMAP</acronym>. + <function>imap_close</function> prend un argument optionnel + <parameter>flag</parameter>, CL_EXPUNGE, qui va retirer + automatiquement de la liste la boîte aux lettres. </para> </refsect1> </refentry> @@ -838,7 +841,7 @@ <parameter>headers</parameter>, et retourne un objet contenant differents éléments, similaires à la fonction <function>imap_header</function>, hormis les flags, et autres - éléments liés au serveur IMAP. + éléments liés au serveur <acronym>IMAP</acronym>. </para> </refsect1> </refentry> @@ -948,15 +951,15 @@ </listitem> <listitem> <simpara> - LATT_UNMARKED - Cette boîte aux lettres n'est pas marquée. Utilisé uniquement - avec UW-IMAPD. + LATT_UNMARKED - Cette boîte aux lettres n'est pas + marquée. Utilisé uniquement avec UW-IMAPD. </simpara> </listitem> </itemizedlist> </para> <para> - <parameter>ref</parameter> ne devrait être que le serveur IMAP sous - la forme <literal>{imap_server:imap_port}</literal>, et + <parameter>ref</parameter> ne devrait être que le serveur +<acronym>IMAP</acronym> + sous la forme <literal>{imap_server:imap_port}</literal>, et <parameter>pattern</parameter> spécifie la position dans la hiérarchie des boîtes aux lettres, oú il faut commencer à charcher. Si vous voulez passer en revue toute la @@ -1200,22 +1203,24 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_open</function> retourne un flot IMAP en cas de succès, - et <literal>FALSE</literal> en cas d'erreur. <function>imap_open</function> peut aussi être - utilisée pour ouvrir des flots sur des serveurs POP3 et NNTP. + <function>imap_open</function> retourne un flot <acronym>IMAP</acronym> + en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_open</function> peut aussi être utilisée pour + ouvrir des flots sur des serveurs <acronym>POP3</acronym> et +<acronym>NNTP</acronym>. + </para> + <para> + Un nom de boîte aux lettres est constitué d'une adresse de serveur, + et d'une adresse de boîte sur ce serveur. Le mot reservé INBOX + représente la boîte aux lettres de l'utilisateur courant. + L'adresse du serveur, mise entre accolades '{' et '}', est constitué + du nom du serveur ou de son adresse IP, d'une spécification de protocole + (commencant par '/') et d'un port optionnel (spécifié avec ':'). + Cette partie est obligatoire dans les paramètres de la boîte aux + lettres. Les noms de boîtes aux lettres qui contiennent des +caractères + spéciaux (en dehors de l'espace ASCII) doivent être encodés + avec <function>imap_utf7_encode</function>. </para> <para> - Un nom de boîte aux lettre est constitué d'une adresse de serveur, - et d'une adresse de boîte sur ce serveur. Le mot reservé INBOX représente - la boîte aux lettres de l'utilisateur courant. L'adresse du serveur, - mise entre accolades '{' et '}', est constitué du nom du serveur ou de - son adresse IP, d'une spécification de protocole (commencant par '/') - et d'un port optionnel (spécifié avec ':'). Cette partie est obligatoire - dans les paramètres de la boîte aux lettres. Les noms de boîtes aux lettres - qui contiennent des caractères spéciaux (en dehors de l'espace ASCII) doivent - être encodés avec <function>imap_utf7_encode</function>. - </para> - <para> Les options sont un masque de bit, qui peut prendre une ou plusieurs des valeurs suivantes : <itemizedlist> @@ -1231,8 +1236,8 @@ </listitem> <listitem> <simpara> - OP_HALFOPEN - Pour les noms IMAP et NNTP, ouvre une connexion - mais n'ouvre pas une boîte aux lettre. + OP_HALFOPEN - Pour les noms <acronym>IMAP</acronym> et +<acronym>NNTP</acronym>, + ouvre une connexion mais n'ouvre pas une boîte aux lettres. </simpara> </listitem> <listitem> @@ -1244,7 +1249,7 @@ </itemizedlist> </para> <para> - Pour se connecter à un serveur IMAP, on peut utiliser la + Pour se connecter à un serveur <acronym>IMAP</acronym>, on peut utiliser +la commande suivante : <informalexample> <programlisting role="php"> @@ -1253,8 +1258,8 @@ ?> </programlisting> </informalexample> - Pour se connecter à un serveur POP3 qui fonctionne sur le port 110 - de la machine locale on peut utiliser la commande suivante : + Pour se connecter à un serveur <acronym>POP3</acronym> qui fonctionne sur + le port 110 de la machine locale on peut utiliser la commande suivante : <informalexample> <programlisting role="php"> <?php @@ -1262,8 +1267,8 @@ ?> </programlisting> </informalexample> - Pour se connecter à un serveur NNTP qui fonctionne sur le port 119 - de la machine locale on peut utiliser la commande: + Pour se connecter à un serveur<acronym>NNTP</acronym> qui fonctionne sur + le port 119 de la machine locale on peut utiliser la commande: <informalexample> <programlisting role="php"> <?php @@ -1293,11 +1298,13 @@ Retourne <literal>TRUE</literal> si le flot existe toujours, et <literal>FALSE</literal> sinon. </para> <para> - <function>imap_ping</function> vérifie que le flot IMAP est toujours actif, - en lui envoyant un ping. Cette fonction permet de se rendre compte que du mail - est arrivé : c'est même la méthode préconisée pour des tests périodiques de - vérification du courrier. Cette fonction peut aussi servir à garder une connexion - ouverte, avec les serveurs dotés d'un délai d'éxpiration. + <function>imap_ping</function> vérifie que le flot <acronym>IMAP</acronym> + est toujours actif, en lui envoyant un ping. Cette fonction permet de se rendre + compte que du mail est arrivé : c'est même la méthode + préconisée pour des tests périodiques de + vérification du courrier. Cette fonction peut aussi servir + à garder une connexion ouverte, avec les serveurs dotés + d'un délai d'éxpiration. </para> <para> <example> @@ -1379,7 +1386,8 @@ </funcsynopsis> <para> <function>imap_reopen</function> réouvre la connexion spécifiée - au serveur IMAP ou NNTP, avec une nouvelle boîtes aux lettres. + au serveur <acronym>IMAP</acronym> ou <acronym>NNTP</acronym>, + avec une nouvelle boîtes aux lettres. </para> <para> Les options sont des masques de bit, qui peuvent contenir les valeurs suivantes : @@ -1396,8 +1404,8 @@ </listitem> <listitem> <simpara> - OP_HALFOPEN - Pour les noms IMAP et NNTP, ouvre une connexion - mais n'ouvre pas une boîte aux lettre. + OP_HALFOPEN - Pour les noms <acronym>IMAP</acronym> et +<acronym>NNTP</acronym>, + ouvre une connexion mais n'ouvre pas une boîte aux lettres. </simpara> </listitem> <listitem> @@ -1426,10 +1434,12 @@ </funcprototype> </funcsynopsis> <para> - Souscrit à la boîte aux lettres <parameter>mbox</parameter>. + <function>imap_subscribe</function> souscrit à la boîte aux + lettres <parameter>mbox</parameter>. </para> <para> - Retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> en cas d'échec. + <function>imap_subscribe</function> retourne <literal>TRUE</literal> en cas de + succès, et <literal>FALSE</literal> en cas d'échec. </para> </refsect1> </refentry> @@ -1455,7 +1465,8 @@ <function>imap_delete</function>. </para> <para> - Retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_subscribe</function> retourne <literal>TRUE</literal> en cas + de succès, et <literal>FALSE</literal> en cas d'erreur. </para> </refsect1> </refentry> @@ -1476,11 +1487,12 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_unsubscribe</function> termine la souscription à - la boîte aux lettres <parameter>mbox</parameter>. + <function>imap_unsubscribe</function> termine la souscription à + la boîte aux lettres <parameter>mbox</parameter>. </para> <para> - Retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_unsubscribe</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> en cas d'erreur. </para> </refsect1> </refentry> @@ -1712,7 +1724,7 @@ <para> <parameter>mailbox</parameter> retourne une adresse email proprement formatée, à partir du nom de la boîte aux - lettre de l'hôte <parameter>host</parameter>, et + lettres de l'hôte <parameter>host</parameter>, et des informations personnelles <parameter>personal</parameter>. </para> <para> @@ -1957,9 +1969,9 @@ c'est à dire sans canonisation des CRLF FT_PREFETCHTEXT RFC822.TEXT doit être pré téléchargé en même temps que l'entête. - Cela réduit le RTT sur une connexion IMAP, si le message complet - est souhaité. (e.g. dans une opération de sauvegarde dans - un fichier). + Cela réduit le RTT sur une connexion <acronym>IMAP</acronym>, si + le message complet est souhaité. (e.g. dans une opération + de sauvegarde dans un fichier). </literallayout> </informalexample> </para> @@ -2033,10 +2045,10 @@ </funcsynopsis> <para> <function>imap_search</function> effectue une recherche dans la boîte aux - lettres courantes, sur le flot IMAP courant. <parameter>criteria</parameter> - est une chaîne, délimitée par des espaces, dans laquelle - les mots-clés suivants sont acceptés. Tous les arguments - multi-mots doivent être entre guillemets : + lettres courantes, sur le flot <acronym>IMAP</acronym> courant. + <parameter>criteria</parameter> est une chaîne, délimitée + par des espaces, dans laquelle les mots-clés suivants sont +acceptés. + Tous les arguments multi-mots doivent être entre guillemets : <itemizedlist> <listitem> <simpara> @@ -2196,10 +2208,10 @@ </funcsynopsis> <para> <function>imap_last_error</function> retourne le texte complet de la - dernière erreur IMAP (si elle existe) qui est survenu lors de - la dernière requête. La pile d'erreur n'est pas touchée. - Appeler <function>imap_last_error</function> successivement dans nouvelles - erreurs retournera la même erreur. + dernière erreur <acronym>IMAP</acronym> (si elle existe) qui + est survenu lors de la dernière requête. La pile d'erreur + n'est pas touchée. Appeler <function>imap_last_error</function> + successivement dans nouvelles erreurs retournera la même erreur. </para> </refsect1> </refentry> @@ -2219,11 +2231,11 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_errors</function> retourne tous les messages d'erreurs IMAP - générés depuis le dernier appel à - <function>imap_errors</function>, ou depuis le début de la page. - Lorsque <function>imap_errors</function> est appelés, la pile - d'erreur est vidée. + <function>imap_errors</function> retourne tous les messages d'erreurs + <acronym>IMAP</acronym> générés depuis le dernier + appel à <function>imap_errors</function>, ou depuis le + début de la page. Lorsque <function>imap_errors</function> est + appelés, la pile d'erreur est vidée. </para> </refsect1> </refentry> @@ -2244,10 +2256,10 @@ </funcsynopsis> <para> <function>imap_alerts</function> retourne tous les messages d'alerte - IMAP générés depuis le dernier appel à - <function>imap_alerts</function> ou depuis le début de la page. - Lorsque <function>imap_alerts</function> est appelé, la pile - d'alerte est vidée. + <acronym>IMAP</acronym> générés depuis le dernier + appel à <function>imap_alerts</function> ou depuis le début + de la page. Lorsque <function>imap_alerts</function> est appelé, la + pile d'alertes est vidée. </para> </refsect1> </refentry>