dams Fri Mar 2 07:28:05 2001 EDT
Modified files:
/phpdoc/fr/functions ccvs.xml datetime.xml imap.xml mcal.xml
pcre.xml pdf.xml array.xml
Log:
Added lastest updates (two imap new functions)
Index: phpdoc/fr/functions/ccvs.xml
diff -u phpdoc/fr/functions/ccvs.xml:1.3 phpdoc/fr/functions/ccvs.xml:1.4
--- phpdoc/fr/functions/ccvs.xml:1.3 Tue Jan 16 02:38:38 2001
+++ phpdoc/fr/functions/ccvs.xml Fri Mar 2 07:28:05 2001
@@ -44,26 +44,12 @@
url="&url.redhat.ccvs;">&url.redhat.ccvs;</ulink>.
</simpara>
<simpara>
- Cette documentatin est en chantier. Jusqu'à sa finalisation, RedHat
- entretient une version légèrement démodée mais bien
pratique
- à <ulink url="&url.redhat.support;">&url.redhat.support;</ulink>.
+ Cette documentation est en chantier. Jusqu'à sa finalisation, RedHat
+ entretient une version légèrement démodée
+ mais bien pratique à
+ <ulink url="&url.redhat.support;">&url.redhat.support;</ulink>.
</simpara>
</partintro>
- <refentry>
- <refnamediv>
- <refname></refname>
- <refpurpose></refpurpose>
- </refnamediv>
- <refsect1>
- <title></title>
- <funcsynopsis>
- <funcprototype>
- <funcdef> <function></function></funcdef>
- <paramdef> <parameter></parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsect1>
- </refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/fr/functions/datetime.xml
diff -u phpdoc/fr/functions/datetime.xml:1.11 phpdoc/fr/functions/datetime.xml:1.12
--- phpdoc/fr/functions/datetime.xml:1.11 Sun Feb 4 10:22:44 2001
+++ phpdoc/fr/functions/datetime.xml Fri Mar 2 07:28:05 2001
@@ -17,7 +17,11 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>checkdate</function> retourne <literal>TRUE</literal> si la date
fournie est valide, et sinon <literal>FALSE</literal>.
+ <function>checkdate</function> retourne <literal>TRUE</literal>
+ si la date
+
+<parameter>day</parameter>/<parameter>month</parameter>/<parameter>year</parameter>
+ est valide, et sinon <literal>FALSE</literal>.
+ Notez bien que l'ordre des arguments n'est pas l'ordre français.
La date est considérée comme valide si :
<itemizedlist>
<listitem>
@@ -923,7 +927,7 @@
<para>
Voir aussi <function>setlocale</function> et <function>mktime</function>
et le <ulink url="&spec.strftime;">groupe de spécifications de
- <function>strftime</function></ulink>.
+ strftime()</ulink>.
</para>
</refsect1>
</refentry>
Index: phpdoc/fr/functions/imap.xml
diff -u phpdoc/fr/functions/imap.xml:1.8 phpdoc/fr/functions/imap.xml:1.9
--- phpdoc/fr/functions/imap.xml:1.8 Wed Feb 7 01:11:59 2001
+++ phpdoc/fr/functions/imap.xml Fri Mar 2 07:28:05 2001
@@ -1005,6 +1005,68 @@
</para>
</refsect1>
</refentry>
+ <refentry id="function.imap-get-quota">
+ <refnamediv>
+ <refname>imap_get_quota</refname>
+ <refpurpose>
+ Lit les quotas des boîtes aux lettres
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>imap_get_quota</function></funcdef>
+ <paramdef>int <parameter>imap_stream</parameter></paramdef>
+ <paramdef>string <parameter>quota_root</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imap_get_quota</function> retourne un tableau contenant
+ les valeurs de quota et courante de la boîte aux lettres
+ <parameter>quota_root</parameter>. Le quota représente la
+ taille maximale de votre boîte aux lettres. La valeur courante
+ est l'espace actuellement utilisé par votre boîte aux lettres.
+ <function>imap_get_quota</function> retournera <literal>FALSE</literal>
+ en cas d'échec.
+ </para>
+ <para>
+ <function>imap_get_quota</function> ne fonctionne actuellement qu'avec
+ les librairies c-client2000.
+ </para>
+ <para>
+ <parameter>imap_stream</parameter> doit avoir été créé
+ avec la fonction <function>imap_status</function>. Ce flot est
+ nécessairement ouvert en tant qu'administrateur du serveur, pour que
+ les droits nécessaires lui soit alloué.
+ <parameter>quota_root</parameter> doit être de la forme :
+ "<literal>user.nom</literal>", où "nom" est le nom de la
+ boîte aux lettres que vous souhaitez analyser.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>imap_get_quota</function></title>
+ <programlisting role="php">
+<?php
+$mbox = imap_open("{votre.hote.imap}","mailadmin","mot de passe",OP_HALFOPEN)
+ || die("Connexion impossible : ".imap_last_error());
+
+$quota_value = imap_get_quota($mbox, "user.toto");
+if(is_array($quota_value)) {
+ print "Utilisation actuelle : " . $quota_value['usage'];
+ print "Quota : " . $quota_value['limit'];
+}
+imap_close($mbox);
+?>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Voir aussi <function>imap_open</function> et
+ <function>imap_set_quota</function>.
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.imap-listsubscribed">
<refnamediv>
<refname>imap_listsubscribed</refname>
@@ -1026,6 +1088,72 @@
Les arguments <parameter>ref</parameter> et <parameter>pattern</parameter>
indiquent respectivement, le dossier oú chercher et le nom des
boîtes recherchées, sous la forme d'un masque.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imap-set-quota">
+ <refnamediv>
+ <refname>imap_set_quota</refname>
+ <refpurpose>Modifie le quota d'une boîte aux lettres</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imap_set_quota</function></funcdef>
+ <paramdef>int <parameter>imap_stream</parameter></paramdef>
+ <paramdef>string <parameter>quota_root</parameter></paramdef>
+ <paramdef>int <parameter>quota_limit</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imap_set_quota</function> modifie le quota de la
+ boîte aux lettres <parameter>quota_root</parameter>, en la
+ fixant à <parameter>quota_limit</parameter>. <function>imap_set_quota</function>
+ requiert que <parameter>imap_stream</parameter> ait été
+ ouvert avec un compte d'administrateur, pour avoir les droits
+ nécessaires : elle ne fonctionnera avec aucun autre
+ utilisateur.
+ </para>
+ <para>
+ <function>imap_get_quota</function> ne fonctionne actuellement qu'avec
+ les librairies c-client2000.
+ </para>
+ <para>
+ <parameter>imap_stream</parameter> doit avoir été créé
+ avec la fonction <function>imap_status</function>. Ce flot est
+ nécessairement ouvert en tant qu'administrateur du serveur, pour que
+ les droits nécessaires lui soit alloué.
+ <parameter>quota_root</parameter> doit être de la forme :
+ "<literal>user.nom</literal>", où "nom" est le nom de la
+ boîte aux lettres que vous souhaitez analyser.
+ <parameter>quota_limit</parameter> est la nouvelle taille
+ maximum (en ko) de la boîte <parameter>quota_root</parameter>.
+ </para>
+ <para>
+ <function>imap_set_quota</function> retourne <literal>TRUE</literal>
+ en cas de succès, et <literal>FALSE</literal> sinon.
+ </para>
+ <para>
+ <example>
+ <title><function>imap_set_quota</function> example</title>
+ <programlisting role="php">
+<?php
+$mbox = imap_open ("{votre.hote.imap:143}", "mailadmin", "mot de passe");
+
+if(!imap_set_quota($mbox, "user.toto", 3000)) {
+ print "Erreur lors de la modification des quotas\n";
+ return;
+}
+
+imap_close($mbox);
+?>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Voir aussi <function>imap_open</function> et
+ <function>imap_set_quota</function>.
</para>
</refsect1>
</refentry>
Index: phpdoc/fr/functions/mcal.xml
diff -u phpdoc/fr/functions/mcal.xml:1.8 phpdoc/fr/functions/mcal.xml:1.9
--- phpdoc/fr/functions/mcal.xml:1.8 Thu Feb 22 03:04:28 2001
+++ phpdoc/fr/functions/mcal.xml Fri Mar 2 07:28:05 2001
@@ -429,12 +429,13 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>mcal_append_event</function> enregistre
- l'événement global dans le calendrier
- MCAL <parameter>mcal_stream</parameter>.
+ <function>mcal_append_event</function> enregistre
+ l'événement global dans le calendrier
+ MCAL <parameter>mcal_stream</parameter>.
</para>
<para>
- Retourne l'uid de l'enregistement ainsi inséré.
+ <function>mcal_append_event</function> retourne l'uid de l'enregistement
+ ainsi inséré.
</para>
</refsect1>
</refentry>
@@ -442,7 +443,7 @@
<refnamediv>
<refname>mcal_store_event</refname>
<refpurpose>
- Modifie un événement dans un calendrier MCAL.
+ Modifie un événement dans un calendrier MCAL.
</refpurpose>
</refnamediv>
<refsect1>
@@ -459,7 +460,9 @@
MCAL <parameter>mcal_stream</parameter>.
</para>
<para>
- Retourne <literal>TRUE</literal> en cas de succès, et
<literal>FALSE</literal> en cas d'erreur.
+ <function>mcal_store_event</function> retourne l'identifiant
+ de l'événement modifié en cas de succès, et
+ <literal>FALSE</literal> en cas d'erreur.
</para>
</refsect1>
</refentry>
@@ -502,12 +505,12 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>mcal_snooze</function> éteind l'alarme de
- l'événement identifié par l'UID
- <parameter>uid</parameter>.
+ <function>mcal_snooze</function> éteind l'alarme de
+ l'événement identifié par l'UID
+ <parameter>uid</parameter>.
</para>
<para>
- Retourne <literal>TRUE</literal>.
+ <function>mcal_snooze</function> retourne <literal>TRUE</literal>.
</para>
</refsect1>
</refentry>
@@ -573,12 +576,12 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>mcal_event_init</function> initialise la structure
- globale d'un flot. Cela remet tous les éléments
- de la structure à 0, ou à leur valeur par défaut.
+ <function>mcal_event_init</function> initialise la structure
+ globale d'un flot. Cela remet tous les éléments
+ de la structure à 0, ou à leur valeur par défaut.
</para>
<para>
- Retourne <literal>TRUE</literal>.
+ <function>mcal_event_init</function> retourne <literal>TRUE</literal>.
</para>
</refsect1>
</refentry>
@@ -604,7 +607,8 @@
valeur de <parameter>category</parameter>.
</para>
<para>
- Retourne <literal>TRUE</literal>.
+ <function>mcal_event_set_category</function> retourne
+ <literal>TRUE</literal>.
</para>
</refsect1>
</refentry>
@@ -629,7 +633,7 @@
la structure globale à la valeur de <parameter>title</parameter>.
</para>
<para>
- Retourne <literal>TRUE</literal>.
+ <function>mcal_event_set_title</function> retourne <literal>TRUE</literal>.
</para>
</refsect1>
</refentry>
@@ -702,7 +706,7 @@
début de la structure globale.
</para>
<para>
- Retourne <literal>TRUE</literal>.
+ <function>mcal_event_set_start</function> retourne <literal>TRUE</literal>.
</para>
</refsect1>
</refentry>
@@ -774,7 +778,7 @@
déclenchement.
</para>
<para>
- Retourne <literal>TRUE</literal>.
+ <function>mcal_event_set_alarm</function> retourne <literal>TRUE</literal>.
</para>
</refsect1>
</refentry>
@@ -800,7 +804,7 @@
pour privée.
</para>
<para>
- Retourne <literal>TRUE</literal>.
+ <function>mcal_event_set_class</function> retourne <literal>TRUE</literal>.
</para>
</refsect1>
</refentry>
@@ -969,8 +973,8 @@
</funcsynopsis>
<para>
<function>mcal_date_compare</function> compares les deux
- dates données, et retourne <0, 0, >0 si a<b,
- a==b, a>b respectivement.
+ dates données, et retourne <0, 0, > 0 si a<b,
+ a==b, a>b respectivement.
</para>
</refsect1>
</refentry>
@@ -978,7 +982,7 @@
<refnamediv>
<refname>mcal_next_recurrence</refname>
<refpurpose>
- Retourne la prochaine occurence d'une événement.
+ Retourne la prochaine occurence d'une événement.
</refpurpose>
</refnamediv>
<refsect1>
@@ -994,7 +998,8 @@
<para>
<function>mcal_next_recurrence</function> retourne un objet
contenant la prochaine date de l'événement, ou
- la date de l'événement suivant la date. Retourne
+ la date de l'événement suivant la date.
+ <function>mcal_next_recurrence</function> retourne
un objet date vide si l'événement n'a pas de
réoccurence, ou si quelquechose est invalide. Utilisez
<parameter>weekstart</parameter> pour déterminer le premier jour.
Index: phpdoc/fr/functions/pcre.xml
diff -u phpdoc/fr/functions/pcre.xml:1.18 phpdoc/fr/functions/pcre.xml:1.19
--- phpdoc/fr/functions/pcre.xml:1.18 Wed Feb 21 02:39:50 2001
+++ phpdoc/fr/functions/pcre.xml Fri Mar 2 07:28:05 2001
@@ -281,7 +281,10 @@
<?php
// Cet exemple utilise les références arrières (\\2).
// Elles indiquent à l'analyseur qu'il doit trouver quelquechose qu'il
-// a déjà repéré un peu plus tôt (ici, ([\w]+)).
+// a déjà repéré un peu plus tôt
+// le nombre 2 indique que c'est le deuxième jeu de parenthèses
+// capturante qui doit être utilisé (ici, ([\w]+)).
+// L'antislash est nécessaire ici, car la chaîne est entre guillemets doubles
$html = "<B>Texte en gras</B><a href=salut.html>clique moi</?>
preg_match_all ("/(<([\w]+)[?>]?>)(.*)(<\/\\?>)/", $html, $matches);
for ($i=0; $i< count($matches[0]); $i++) {
Index: phpdoc/fr/functions/pdf.xml
diff -u phpdoc/fr/functions/pdf.xml:1.11 phpdoc/fr/functions/pdf.xml:1.12
--- phpdoc/fr/functions/pdf.xml:1.11 Mon Feb 26 03:10:50 2001
+++ phpdoc/fr/functions/pdf.xml Fri Mar 2 07:28:05 2001
@@ -257,7 +257,7 @@
signifique notamment qu'il faut remplacer 4 par 'winansi'.
</simpara>
<simpara>
- Si vous utilisez PDFLib 2.30, <function>pdf_set_text_matrix</function>
+ Si vous utilisez PDFLib 2.30, pdf_set_text_matrix()
a disparu. Elle n'est plus supporté. En général,
il est recommandé de consulter les notes de version de la PDFLib
pour lister toutes les modifications.
@@ -1543,14 +1543,11 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>pdf_place_image</function> place l'image <parameter>image</parameter>
- dans la page courante, à la position (<parameter>x-coor</parameter>,
- <parameter>x-coor</parameter>). L'image peut changer d'échelle
- simultanémement.
+ <function>pdf_place_image</function> place l'image <parameter>image</parameter>
+ dans la page courante, à la position (<parameter>x-coor</parameter>,
+ <parameter>x-coor</parameter>). L'image peut changer d'échelle
+ simultanémement.
</para>
- <para>
- Voir aussi <function>pdf_put_image</function>.
- </para>
</refsect1>
</refentry>
<refentry id="function.pdf-rect">
@@ -2358,7 +2355,7 @@
</para>
</refsect1>
</refentry>
- <refentry id="function.pdf-set-transition">
+ <refentry id="function.pdf-set-text-matrix">
<refnamediv>
<refname>pdf_set_text_matrix</refname>
<refpurpose>Obsolète: Modifie la transition des pages</refpurpose>
@@ -2366,7 +2363,7 @@
<refsect1>
<title>Description</title>
<para>
- See <function>pdf_set_parameter</function>.
+ Voir <function>pdf_set_parameter</function>.
</para>
</refsect1>
</refentry>
@@ -2671,7 +2668,6 @@
Voir aussi <function>pdf_close_image</function>,
<function>pdf_open_jpeg</function>,
<function>pdf_open_gif</function>,
- <function>pdf_execute_image</function>,
<function>pdf_place_image</function> et
<function>pdf_put_image</function>.
</para>
Index: phpdoc/fr/functions/array.xml
diff -u phpdoc/fr/functions/array.xml:1.22 phpdoc/fr/functions/array.xml:1.23
--- phpdoc/fr/functions/array.xml:1.22 Tue Feb 20 06:40:31 2001
+++ phpdoc/fr/functions/array.xml Fri Mar 2 07:28:05 2001
@@ -1797,13 +1797,13 @@
</computeroutput>
</para>
<para>
- La variable $taille n'a pas été réécrite, car on
- avait spécifié le paramètre EXTR_PREFIX_SAME, qui a permis
- la création $wddx_size. Si EXTR_SKIP avait été
- utilisé, alors $wddx_size n'aurait pas été
- créé. Avec EXTR_OVERWRITE, $taille aurait pris la valeur "moyen",
- et avec EXTR_PREFIX_ALL, les variables créées seraient
- $wddx_couleur, $wddx_taille, et $wddx_forme.
+ La variable $taille n'a pas été réécrite, car on
+ avait spécifié le paramètre EXTR_PREFIX_SAME, qui a permis
+ la création $wddx_size. Si EXTR_SKIP avait été
+ utilisé, alors $wddx_size n'aurait pas été
+ créé. Avec EXTR_OVERWRITE, $taille aurait pris la valeur "moyen",
+ et avec EXTR_PREFIX_ALL, les variables créées seraient
+ $wddx_couleur, $wddx_taille, et $wddx_forme.
</para>
</refsect1>
</refentry>
@@ -1826,7 +1826,8 @@
</funcsynopsis>
<para>
<function>in_array</function> recherche <parameter>needle</parameter> dans
- <parameter>haystack</parameter> et retourne <literal>TRUE</literal> si il s'y
trouve, ou <literal>FALSE</literal> sinon.
+ <parameter>haystack</parameter> et retourne <literal>TRUE</literal>
+ si il s'y trouve, ou <literal>FALSE</literal> sinon.
</para>
<para>
Si le troisième paramètre <parameter>strict</parameter> est
optionel. S'il
@@ -1848,7 +1849,9 @@
</para>
<para>
<example>
- <title><function>in_array</function> avec le paramètre
<parameter>strict</parameter></title>
+ <title>
+ <function>in_array</function> avec le paramètre
+<parameter>strict</parameter>
+ </title>
<programlisting role="php">
<?php
$a = array('1.10', 12.4, 1.13);
@@ -1878,10 +1881,12 @@
</para>
</refsect1>
</refentry>
- <refentry id="function.search-array">
+ <refentry id="function.array-search">
<refnamediv>
<refname>array_search</refname>
- <refpurpose>Recherche dans un tableau la clé associée à une
valeur</refpurpose>
+ <refpurpose>
+ Recherche dans un tableau la clé associée à une valeur
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
