dams Thu Jan 11 00:53:17 2001 EDT
Modified files:
/phpdoc/fr/appendices escaping.xml history.xml http-stuff.xml
migration.xml phpdevel.xml regexp.xml
debugger.xml
Log:
Good number of Typos.
TRUE/FALSE -> <literal>
Index: phpdoc/fr/appendices/escaping.xml
diff -u phpdoc/fr/appendices/escaping.xml:1.1 phpdoc/fr/appendices/escaping.xml:1.2
--- phpdoc/fr/appendices/escaping.xml:1.1 Sat Jul 22 03:09:23 2000
+++ phpdoc/fr/appendices/escaping.xml Thu Jan 11 00:53:17 2001
@@ -3,4 +3,3 @@
<sect>URL encoding (GET)
<sect>POST method
<sect>Escaping for databases
-
Index: phpdoc/fr/appendices/history.xml
diff -u phpdoc/fr/appendices/history.xml:1.1 phpdoc/fr/appendices/history.xml:1.2
--- phpdoc/fr/appendices/history.xml:1.1 Sat Jul 22 03:17:10 2000
+++ phpdoc/fr/appendices/history.xml Thu Jan 11 00:53:17 2001
@@ -1,3 +1,2 @@
<chapt>PHP's history
<sect>Overview of PHP's development
-
Index: phpdoc/fr/appendices/http-stuff.xml
diff -u phpdoc/fr/appendices/http-stuff.xml:1.1 phpdoc/fr/appendices/http-stuff.xml:1.2
--- phpdoc/fr/appendices/http-stuff.xml:1.1 Sat Jul 22 03:17:10 2000
+++ phpdoc/fr/appendices/http-stuff.xml Thu Jan 11 00:53:17 2001
@@ -2,4 +2,3 @@
<sect>Setting an expiry date on generated pages
<sect>Using phpLastModified
<sect>CGI version: why does images break (w/solution)
-
Index: phpdoc/fr/appendices/migration.xml
diff -u phpdoc/fr/appendices/migration.xml:1.3 phpdoc/fr/appendices/migration.xml:1.4
--- phpdoc/fr/appendices/migration.xml:1.3 Fri Dec 8 02:02:38 2000
+++ phpdoc/fr/appendices/migration.xml Thu Jan 11 00:53:17 2001
@@ -5,7 +5,7 @@
<simpara>
PHP 3.0 a été entièrement réécrit. Le nouvel
analyseur syntaxique est beaucoup plus robuste et cohérent qu'en version
- 2.0. Il est aussi nettement plus rapide, et utilise encore moins de
+ 2.0. Il est aussi nettement plus rapide et utilise encore moins de
mémoire. Cependant, ces améliorations n'ont pu être
possible qu'au prix de modifications parfois importantes, tant au niveau des
syntaxes, qu'au niveau des fonctionnalités.
@@ -26,7 +26,7 @@
<simpara>
Un programme de conversion automatique de vos vieux script PHP/FI 2.0 existe.
Il est disponible dans le dossier de convertisseur de la distribution PHP 3.0.
- Ce programme ne fait que repérer les modifications de syntaxe, et ne
+ Ce programme ne fait que repérer les modifications de syntaxe et ne
vous épargnera pas une relecture attentive du script.
</simpara>
</sect1>
@@ -35,19 +35,23 @@
<para>
La première chose que vous remarquerez probablement est que les balises
de PHP start et end ont changé. L'ancienne forme
- <literal><? ></literal> a été remplacée par trois
+ <literal><? ?></literal> a été remplacée par trois
nouvelles balises possibles :
<example>
<title>Migration: Migration: balises start/end </title>
- <programlisting>
-<? echo "Ceci est du code PHP/FI 2.0.\n"; >
+ <programlisting role="php">
+<?php
+echo "Ceci est du code PHP/FI 2.0.\n";?
+?>
</programlisting>
</example>
Comme en version 2.0, PHP/FI accepte aussi cette variante :
<example>
<title>Migration: premières nouvelles balises PHP</title>
- <programlisting>
-<? echo "Ceci est du code PHP 3.0!\n"; ?>
+ <programlisting role="php">
+<?php
+echo "Ceci est du code PHP 3.0!\n";
+?>
</programlisting>
</example>
Notez bien que la balise de fin contient désormais un point
@@ -58,27 +62,36 @@
suivante a été ajoutée :
<example>
<title>Migration: Nouvelles balises PHP</title>
- <programlisting>
-<?php echo "Ceci est du code PHP 3.0!\n"; ?>
+ <programlisting role="php">
+<?php
+echo "Ceci est du code PHP 3.0!\n";
+?>
</programlisting>
</example>
- Some people have had problems with editors that don't understand
- the processing instruction tags at all. Microsoft FrontPage is one
- such editor, and as a workaround for these, the following variation
- was introduced as well:
- <example><title>Deuxièmes nouvelles balises start/end</title>
- <programlisting>
+ Certains d'entre vous rencontrent des problèmes avec les éditeurs qui
+ ne comprennent pas ce type de balises d'instruction : Microsoft FrontPage
+ est l'un de ces éditeurs, et, pour contourner le problème, la
+ variation suivante a été introduite :
+ <example><title>Nouvelles balises PHP</title>
+ <programlisting role="php">
<script language="php">
echo "Ceci est du code PHP 3.0!\n";
</script>
-</programlisting></example></para></sect1>
+ </programlisting>
+ </example>
+ </para>
+ </sect1>
<sect1 id="migration-if-endif">
<title>if..endif syntax</title>
<para>
-La syntaxe alternative pour écrire des instructions if/elseif/else, avec if();
elseif(); else; endif; ne pouvait pas être conservée sans ajouter
beaucoup de complexité à l'analyseur syntaxique. De ce fait, cette
syntaxe à changée :
+ La syntaxe alternative pour écrire des instructions if/elseif/else, avec
+if();
+ elseif(); else; endif; ne pouvait pas être conservée sans ajouter
+beaucoup
+ de complexité à l'analyseur syntaxique. De ce fait, cette syntaxe
+ à changée :
<example>
<title>Migration: ancienne syntaxe if..endif </title>
- <programlisting>
+ <programlisting role="php">
+<?php
if ($foo);
echo "oui\n";
elseif ($bar);
@@ -86,11 +99,13 @@
else;
echo "non\n";
endif;
+?>
</programlisting>
</example>
<example>
<title>Migration: nouvelle syntaxe if..endif</title>
- <programlisting>
+ <programlisting role="php">
+<?php
if ($foo):
echo "oui\n";
elseif ($bar):
@@ -98,46 +113,56 @@
else:
echo "non\n";
endif;
+?>
</programlisting>
</example>
-Notez que les points virgules ont été remplacée par des point
dans toutes les commandes, sauf pour la dernière expression
(endif).</para></sect1>
+ Notez que les points virgules ont été remplacée par des
+points dans
+ toutes les commandes, sauf pour la dernière expression (endif).
+ </para>
+ </sect1>
<sect1 id="migration-while">
<title>while syntax</title>
<para>
- Tout comme pour if..endif, la syntaxe des boucles while..endwhile a changée
- as well:
- <example><title>Migration: ancienne syntaxe while..endwhile </title>
- <programlisting>
+ Tout comme pour if..endif, la syntaxe des boucles while..endwhile a changée
+:
+ <example>
+ <title>Migration: ancienne syntaxe while..endwhile </title>
+ <programlisting role="php">
+<?php
while ($more_to_come);
...
endwhile;
+?>
</programlisting>
</example>
<example><title>Migration: nouvelle syntaxe while..endwhile</title>
- <programlisting>
+ <programlisting role="php">
+<?php
while ($more_to_come):
...
endwhile;
+?>
</programlisting>
</example>
</para>
<warning>
<simpara>
- Attention
- Si vous utilisez la vieille syntaxe while..endwhile en PHP 3.0, vous obtiendrez une
boucle sans fin !
+ Attention : si vous utilisez la vieille syntaxe while..endwhile en PHP 3.0, vous
+ obtiendrez une boucle sans fin !
</simpara>
- </warning></sect1>
+ </warning>
+ </sect1>
<sect1 id="migration-expr">
<title>Types d'expression</title>
<simpara>
-PHP/FI 2.0 utilisait le membre à gauche dans les expressions, pour
déterminer
-le type de résultat attendu. PHP 3.0 prend en compte les deux cotés de
-l'expression, et cela peut produire des résultats inattendus avec les scripts
2.0.
-</simpara>
- <simpara></simpara>
+ PHP/FI 2.0 utilisait le membre à gauche dans les expressions, pour
+déterminer
+ le type de résultat attendu. PHP 3.0 prend en compte les deux cotés
+de
+ l'expression et cela peut produire des résultats inattendus avec les
+scripts 2.0.
+ </simpara>
<para>
-Considérez les lignes suivantes:
- <informalexample><programlisting>
+ Considérez les lignes suivantes:
+ <informalexample>
+ <programlisting role="php">
+<?php
$a[0]=5;
$a[1]=7;
$key = key($a);
@@ -145,109 +170,171 @@
echo "$keyn";
next($a);
}
-</programlisting></informalexample>
-En PHP/FI 2.0, cet exemple va afficher les indices des $a.
-En PHP 3.0, l'exemple ne va rien afficher du tout. La raison est
-qu'en PHP 2.0, puisque l'argument de gauche est de type chaîne,
-une comparaison de chaîne était effectué, et, effectivement,
<literal>""</literal>
-n'est pas <literal>""</literal>, ce qui conduit la boucle à continuer.
-En PHP 3, lorsqu'une chaîne est comparée avec un entier, la comparaison
est de
-type chaîne (la chaîne est convertie en entier).
-Ce qui revient à faire la comparaison entre (<literal>atoi("")</literal>) qui
vaut <literal>0</literal>, et
-la variablelist qui vaut aussi 0, et comme 0==0,
-la boucle ne commence même pas.
+?>
+ </programlisting>
+ </informalexample>
+ En PHP/FI 2.0, cet exemple va afficher les indices des $a.
+ En PHP 3.0, l'exemple ne va rien afficher du tout. La raison est qu'en PHP 2.0,
+puisque
+ l'argument de gauche est de type chaîne, une comparaison de chaîne
+était
+ effectué et, effectivement, <literal>""</literal> n'est pas
+<literal>""</literal>,
+ ce qui conduit la boucle à continuer. En PHP 3, lorsqu'une chaîne est
+ comparée avec un entier, la comparaison est de type chaîne (la
+chaîne
+ est convertie en entier). Ce qui revient à faire la comparaison entre
+ (<literal>atoi("")</literal>) qui vaut <literal>0</literal> et la variable
+ qui vaut aussi 0 et comme 0==0, la boucle ne commence même pas.
</para>
<para>
La correction de ceci est simple : il suffit de remplacer les commandes while par:
- <informalexample><programlisting>
+ <informalexample>
+ <programlisting role="php">
+<?php
while ((string)$key != "") {
-</programlisting></informalexample></para></sect1>
+?>
+ </programlisting>
+ </informalexample>
+ </para>
+ </sect1>
<sect1 id="migration-errors">
<title>Les messages d'erreur ont changé</title>
<simpara>
-Les messages d'erreur en PHP 3.0 sont généralement plus précis
que ceux de la version 2.0., mais vous ne verrez plus la portion de code qui a
causé l'erreur. A la place, un numéro de ligne et un nom de fichier sera
retourné.
- </simpara></sect1>
+ Les messages d'erreur en PHP 3.0 sont généralement plus
+précis que
+ ceux de la version 2.0., mais vous ne verrez plus la portion de code qui a
+causé
+ l'erreur. A la place, un numéro de ligne et un nom de fichier sera
+retourné.
+ </simpara>
+ </sect1>
<sect1 id="migration-booleval">
<title>Evaluation rapide des booléens </title>
+ <simpara>
+ En PHP 3., l' évaluation des est court-circuité. Cela signifie dans
+une
+ expression telle que (<literal>(1 || test_me())</literal>), la fonction test_me()
+ ne sera pas exécutée, car cela ne changera pas le résultat.
+ </simpara>
<simpara>
-En PHP 3., l' évaluation des est court circuité. Cela signifie dans une
expression telle
- que (<literal>(1 || test_me())</literal>), la fonction test_me()
- ne sera pas exécutée, car cela ne changera pas le résultat.
</simpara>
- <simpara>C'est une amélioration mineure, mais qui peut avoir des effets
secondaires importants.</simpara></sect1>
+ C'est une amélioration mineure, mais qui peut avoir des effets secondaires
+importants.
+ </simpara>
+ </sect1>
<sect1 id="migration-truefalse">
- <title>La valeur true/false comme retour de fonctions</title>
+ <title>La valeur <literal>TRUE</literal>/<literal>FALSE</literal> comme retour de
+fonctions</title>
<simpara>
- La plupart des fonctions internes de PHP ont été
réécrite pour qu'elle retourne TRUE en cas de succès, et FALSE en
cas d'erreur, au contraire des fonctions qui retournaient 0 et -1 en PHP/FI 2.0. Le
nouveau comportement est beaucoup plus logique, comme par exemple $fp =
fopen("/your/file") or fail("fichier non trouvé!");.Etant donné que
PHP/FI 2.0 n'a pas de règle claire à propos de ce que les fonctions
doivent retourner en cas d'echec, la plus part des scripts devront probablement
être vérifié manuellement, après avoir utilisé le
convertisseur 2.0 à 3.0.
-</simpara>
+ La plupart des fonctions internes de PHP ont été
+ réécrite pour qu'elle retourne <literal>TRUE</literal> en cas de
+succès,
+ et <literal>FALSE</literal> en cas d'erreur, au contraire des fonctions qui
+retournaient 0 et -1
+ en PHP/FI 2.0. Le nouveau comportement est beaucoup plus logique, comme par
+ exemple $fp = fopen("/your/file") or fail("fichier non trouvé!");.
+ Etant donné que PHP/FI 2.0 n'a pas de règle claire à
+ propos de ce que les fonctions doivent retourner en cas d'échec, la
+ plus part des scripts devront probablement être vérifié
+ manuellement, après avoir utilisé le convertisseur 2.0 à
+ 3.0.
+ </simpara>
<para>
<example>
- <title>Migration depuis 2.0: valeur retournées, ancienne
façon</title>
- <programlisting>
+ <title>
+ Migration depuis 2.0: valeur retournées, ancienne façon
+ </title>
+ <programlisting role="php">
+<?php
$fp = fopen($file, "r");
if ($fp == -1);
echo("Impossible d'ouvrir le fichier $file en lecture <br>\n");
endif;
-</programlisting>
+?>
+ </programlisting>
</example>
<example>
<title>Migration depuis 2.0: valeur retournées, nouvelle
façon</title>
- <programlisting>
+ <programlisting role="php">
+<?php
$fp = @fopen($file, "r") or print("Impossible d'ouvrir le fichier $file en
lecture<br>\n");
-</programlisting>
- </example></para></sect1>
+?>
+ </programlisting>
+ </example>
+ </para>
+ </sect1>
<sect1 id="migration-other">
<title>Diverses incompatibilités</title>
<itemizedlist>
- <listitem><simpara>
- Le module PHP 3.0 pour Apache n'accepte plus les versions d'Apache
antérieure à la version 1.2. Apache 1.2 ou plus récent est
nécessaire.
-</simpara></listitem>
- <listitem><simpara> <function>echo</function> n'utilise plus de chaîne de
formattage. Il faut utiliser <function>printf</function> à la
place.</simpara></listitem>
- <listitem><simpara>
-En PHP/FI 2.0, un effet secondaire de l'implémentation faisait que
<literal>$foo[0]</literal>
- était la même chose que <literal>$foo</literal>. Ce n'est plus vrai en
PHP 3.0. </simpara></listitem>
- <listitem><simpara>
-Lire un tableau avec $array[] n'est plus valable.</simpara>
- <simpara>
- Ainsi, il n'est plus possible de passer en revue un tableau avec des
-boucles telles que <literal>$data = $array[]</literal>. Utilisez
<function>current</function>
-et <function>next</function> à la place.
-</simpara>
- <simpara>
- Ainsi, <literal>$array1[] = $array2</literal> n'ajoute pas les valeurs
-de <literal>$array2</literal> à <literal>$array1</literal>, mais crée
un nouvel élément
-dans <literal>$array1</literal> et y affecte <literal>$array2</literal> comme dernier
-élément. Voir aussi les tableaux multidimensionnels.
-</simpara></listitem>
+ <listitem>
+ <simpara>
+ Le module PHP 3.0 pour Apache n'accepte plus les versions d'Apache
+antérieure
+ à la version 1.2. Apache 1.2 ou plus récent est nécessaire.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <function>echo</function> n'utilise plus de chaîne de formattage. Il faut
+ utiliser <function>printf</function> à la place.
+ </simpara>
+ </listitem>
<listitem>
- <simpara> <literal>"+"</literal> n'est plus utilisable comme opérateur de
-concaténation de chaîne. A la place, il converti les arguments en
nombres,
-et effectue une addition numérique. Utilisez <literal>"."</literal> à
la place.
-</simpara></listitem>
+ <simpara>
+ En PHP/FI 2.0, un effet secondaire de l'implémentation faisait que
+ <literal>$foo[0]</literal> était la même chose que
+ <literal>$foo</literal>. Ce n'est plus vrai en PHP 3.0.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Lire un tableau avec $array[] n'est plus valable.
+ </simpara>
+ <simpara>
+ Ainsi, il n'est plus possible de passer en revue un tableau avec des
+ boucles telles que <literal>$data = $array[]</literal>. Utilisez
+ <function>current</function> et <function>next</function> à la place.
+ </simpara>
+ <simpara>
+ Ainsi, <literal>$array1[] = $array2</literal> n'ajoute pas les valeurs
+ de <literal>$array2</literal> à <literal>$array1</literal>,
+ mais crée un nouvel élément dans <literal>$array1</literal>
+ et y affecte <literal>$array2</literal> comme dernier élément.
+ Voir aussi les tableaux multidimensionnels.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>"+"</literal> n'est plus utilisable comme opérateur de
+ concaténation de chaîne. A la place, il convertit les
+ arguments en nombres et effectue une addition numérique.
+ Utilisez <literal>"."</literal> à la place.
+ </simpara>
+ </listitem>
</itemizedlist>
- <example>
- <title>Migration depuis 2.0: concaténation de chaînes</title>
- <programlisting>
+ <example>
+ <title>Migration depuis 2.0: concaténation de chaînes</title>
+ <programlisting role="php">
+<?php
echo "1" + "1";
-</programlisting>
- <para>
- En PHP 2.0 cela retournerait 11, en PHP 3.0 cela va retourner 2. A la
place, faites :
- <programlisting>
+?>
+ </programlisting>
+ <para>
+ En PHP 2.0 cela retournerait 11, en PHP 3.0 cela va retourner 2. A la place,
+ faîtes :
+ <programlisting role="php">
+<?php
echo "1"."1";
-</programlisting>
- <programlisting>
+?>
+ </programlisting>
+ <programlisting role="php">
+<?php
$a = 1;
$b = 1;
echo $a + $b;
-</programlisting></para>
- <para>
- Cela va afficher 2, tant en PHP 2.0 qu'en 3.0.
- <programlisting>
+?>
+ </programlisting>
+ </para>
+ <para>
+ Cela va afficher 2, tant en PHP 2.0 qu'en 3.0.
+ <programlisting role="php">
+<?php
$a = 1;
$b = 1;
echo $a.$b;
-</programlisting>
- Cela va afficher 11 en PHP 3.0.</para>
- </example></sect1>
+?>
+ </programlisting>
+ Cela va afficher 11 en PHP 3.0.
+ </para>
+ </example>
+ </sect1>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/fr/appendices/phpdevel.xml
diff -u phpdoc/fr/appendices/phpdevel.xml:1.9 phpdoc/fr/appendices/phpdevel.xml:1.10
--- phpdoc/fr/appendices/phpdevel.xml:1.9 Fri Dec 8 02:03:06 2000
+++ phpdoc/fr/appendices/phpdevel.xml Thu Jan 11 00:53:17 2001
@@ -1,7 +1,7 @@
<appendix id="phpdevel">
<title>Développement PHP</title>
<sect1 id="phpdevel-addfunc">
- <title>Adding functions to PHP3</title>
+ <title>Cr&eacut;er une fonction PHP 3</title>
<sect2 id="phpdevel-addfunc-prototype">
<title>Prototypes de fonctions</title>
<para>
@@ -123,7 +123,8 @@
</row>
</tbody>
</tgroup>
- </table></para>
+ </table>
+ </para>
<para>
Si vous recevez un argument d'un type, te que vous voulez l'utiliser
avec un autre type, ou si vous voulez simplement forcer le type, vous
@@ -133,8 +134,9 @@
convert_to_double(arg1);
convert_to_string(arg1);
convert_to_boolean_long(arg1); /* Si la chaîne est "" ou "0" elle devient 0, 1
sinon */
-convert_string_to_number(arg1); /* Converti une chaîne en LONG ou DOUBLE
suivant la chaîne */
- </programlisting></para>
+convert_string_to_number(arg1); /* Convertit une chaîne en LONG ou DOUBLE
+suivant la chaîne */
+ </programlisting>
+ </para>
<simpara>
Ces fonctions convertissent sur place : elles ne retourne aucune valeur.
</simpara>
@@ -144,7 +146,9 @@
<listitem><simpara>IS_STRING: arg1->value.str.val</simpara></listitem>
<listitem><simpara>IS_LONG: arg1->value.lval</simpara></listitem>
<listitem><simpara>IS_DOUBLE: arg1->value.dval</simpara></listitem>
- </itemizedlist></para></sect2>
+ </itemizedlist>
+ </para>
+ </sect2>
<sect2 id="phpdevel-addfunc-memmgmt">
<title>Gestion de la mémoire dans une fonction</title>
<simpara>
@@ -192,7 +196,8 @@
<listitem><simpara>SET_VAR_STRING(name,value)</simpara></listitem>
<listitem><simpara>SET_VAR_DOUBLE(name,value)</simpara></listitem>
<listitem><simpara>SET_VAR_LONG(name,value)</simpara></listitem>
- </itemizedlist></para>
+ </itemizedlist>
+ </para>
<para>
<footnote id="symtab-1">
<simpara>
@@ -219,11 +224,14 @@
<para>
<example>
<title>
- Vérification de l'existance de $foo dans la table des sympboles
+ Vérification de l'existance de <varname>$foo</varname> dans la table
+des sympboles
</title>
- <programlisting>
-if (hash_exists(active_symbol_table,"foo",sizeof("foo"))) { existe... }
-else { n'existe pas }
+ <programlisting role="php">
+if (hash_exists(active_symbol_table,"foo",sizeof("foo"))) {
+ // existe...
+} else {
+ // n'existe pas
+}
</programlisting>
</example>
<example>
@@ -316,14 +324,15 @@
{ introuvable... }
else
{ utilisez arr->value.ht... }
- </programlisting></para>
+ </programlisting>
+ </para>
<simpara>
Notez que hash_find recoit un pointeur sur un pointeur sur pval, et pas un
pointeur sur pval.
</simpara>
<simpara>
- Toutes les fonctions d'accès aux hash retourne SUCCES (SUCCES) ou
- ECHEC (FAILURE), excepté hash_exists(), qui retourne un booléen.
+ Toutes les fonctions d'accès aux hash retourne <literal>TRUE</literal>
+(SUCCES) ou
+ <literal>FALSE</literal> (FAILURE), excepté hash_exists(), qui retourne un
+booléen.
</simpara>
</sect2>
<sect2 id="phpdevel-addfunc-retsimple">
@@ -338,8 +347,8 @@
<listitem><simpara>RETURN_FALSE</simpara></listitem>
<listitem><simpara>RETURN_TRUE</simpara></listitem>
<listitem><simpara>RETURN_LONG(l)</simpara></listitem>
- <listitem><simpara>RETURN_STRING(s,dup) Si dup est TRUE, duplique la
chaîne.</simpara></listitem>
- <listitem><simpara>RETURN_STRINGL(s,l,dup) Retourne la chaîne (s) en
spécifiant la longueur (l).</simpara></listitem>
+ <listitem><simpara>RETURN_STRING(s,dup) Si dup est <literal>TRUE</literal>,
+duplique la chaîne.</simpara></listitem>
+ <listitem><simpara>RETURN_STRINGL(s,l,dup) retourne la chaîne (s) en
+spécifiant la longueur (l).</simpara></listitem>
<listitem><simpara>RETURN_DOUBLE(d)</simpara></listitem>
</itemizedlist>
</para>
@@ -349,10 +358,11 @@
<listitem><simpara>RETVAL_FALSE</simpara></listitem>
<listitem><simpara>RETVAL_TRUE</simpara></listitem>
<listitem><simpara>RETVAL_LONG(l)</simpara></listitem>
- <listitem><simpara>RETVAL_STRING(s,dup) Si dup est TRUE, duplique la
chaîne</simpara></listitem>
- <listitem><simpara>RETVAL_STRINGL(s,l,dup) Retourne la chaîne (s) en
spécifiant la longueur (l).</simpara></listitem>
+ <listitem><simpara>RETVAL_STRING(s,dup) Si dup est <literal>TRUE</literal>,
+duplique la chaîne</simpara></listitem>
+ <listitem><simpara>RETVAL_STRINGL(s,l,dup) retourne la chaîne (s) en
+spécifiant la longueur (l).</simpara></listitem>
<listitem><simpara>RETVAL_DOUBLE(d)</simpara></listitem>
- </itemizedlist></para>
+ </itemizedlist>
+ </para>
<simpara>
Les macros ci dessus vont utiliser estrdup() sur les arguments passés.
Cela vous permet de libérer tranquillement les arguments après
@@ -467,7 +477,9 @@
<listitem><simpara>add_next_index_string(return_value,str)</simpara></listitem>
<listitem><simpara>add_next_index_stringl(return_value,str,length)
- specify the string length</simpara></listitem>
- </itemizedlist></para></sect2>
+ </itemizedlist>
+ </para>
+ </sect2>
<sect2 id="phpdevel-addfunc-reslist">
<title>Using the resource list</title>
<simpara>
@@ -644,7 +656,7 @@
<sect2 id="phpdevel-addfunc-addcfg">
<title>Ajouter des directives de configuration à l'exécution</title>
<para>
- De nombreuses caractéristiques de PHP3 peuvent être configurée
+ De nombreuses caractéristiques de PHP 3 peuvent être
+configurée
à l'éxécution. Ces directives peuvent apparaitre dans le
fichier <filename>php3.ini</filename>, ou, dans le cas du module Apache, dans
le fichier <filename>.conf</filename>. L'avantage de l'avoir dans le fichier
@@ -661,7 +673,7 @@
<listitem>
<simpara>
Ajouter la directive à la structure php3_ini_structure dans le
- fichier mod_php3.h.
+ fichier <filename>mod_php3.h</filename>.
</simpara>
</listitem>
<listitem>
@@ -786,10 +798,10 @@
<title>Rapport d'erreurs</title>
<simpara>
Pour signaler les erreurs d'une fonction interne, vous devez appelez la fonction
- php3_error(). Cette fonction prend deux arguments au
- moins : le niveau de l'erreur, et le message d'erreur, sous forme de chaîne
- de caractères. Tous les arguments suivants sont des paramètres de
- formats de chaîne. Les niveaux d'erreurs sont :
+ php3_error(). Cette fonction prend deux arguments au moins : le niveau de
+l'erreur,
+ et le message d'erreur, sous forme de chaîne de caractères. Tous les
+ arguments suivants sont des paramètres de formats de chaîne. Les
+ niveaux d'erreurs sont :
</simpara>
<sect2 id="internal.e-notice">
<title>E_NOTICE</title>
Index: phpdoc/fr/appendices/regexp.xml
diff -u phpdoc/fr/appendices/regexp.xml:1.1 phpdoc/fr/appendices/regexp.xml:1.2
--- phpdoc/fr/appendices/regexp.xml:1.1 Sat Jul 22 03:17:10 2000
+++ phpdoc/fr/appendices/regexp.xml Thu Jan 11 00:53:17 2001
@@ -1,3 +1,2 @@
<chapt>Regular expressions
<sect>Short overview to regexps with pointers to more info
-
Index: phpdoc/fr/appendices/debugger.xml
diff -u phpdoc/fr/appendices/debugger.xml:1.3 phpdoc/fr/appendices/debugger.xml:1.4
--- phpdoc/fr/appendices/debugger.xml:1.3 Thu Oct 26 23:55:21 2000
+++ phpdoc/fr/appendices/debugger.xml Thu Jan 11 00:53:17 2001
@@ -1,65 +1,63 @@
<appendix id="debugger">
<title>Débuggeur PHP</title>
-
<sect1 id="debugger-using">
<title>Utiliser le débuggeur PHP</title>
-
<para>
- Le débuggeur PHP sert à repérer les bugs
+ Le débuggeur PHP sert à repérer les bugs
récalcitrants. Le débuggeur fonctionne en se
- connectant à un port <acronym>TCP</acronym> à chaque
- démarrage de PHP. Tous les messages d'erreur seront
+ connectant à un port <acronym>TCP</acronym> à chaque
+ démarrage de PHP. Tous les messages d'erreur seront
envoyés sur cette connexion. Cette page est faite pour un
- "serveur de débuggage", qui peut peut fonctionner avec un
+ "serveur de débuggage", qui peut peut fonctionner avec un
<acronym>IDE</acronym> ou un éditeur programmable (tel que Emacs).
</para>
<para>
- Comment paramétrer le débuggeur :
+ Comment paramétrer le débuggeur :
<orderedlist>
<listitem>
- <simpara>
- Réservez un port TCP pour le débuggeur dans le fichier
- <link linkend="configuration.file">de configuration</link>
+ <simpara>
+ Réservez un port TCP pour le débuggeur dans le fichier
+ <link linkend="configuration.file">de configuration</link>
(<link linkend="ini.debugger.port">debugger.port</link>) et activez le
(<link linkend="ini.debugger.enabled">debugger.enabled</link>).
</simpara>
</listitem>
<listitem>
- <simpara>
+ <simpara>
Configurer un client TCP sur ce port (par exemple
<command>socket -l -s 1400</command> sous UNIX).
</simpara>
</listitem>
<listitem>
- <simpara>
+ <simpara>
Dans votre code, placez la ligne
"debugger_on(<replaceable>host</replaceable>)", oú
<replaceable>host</replaceable> est l'IP ou le nom de l'hôte qui supporte le
client <acronym>TCP</acronym>.
</simpara>
</listitem>
</orderedlist>
- Désormais, toutes les alertes, notes, ... seront envoyées
- sur la socket client, <emphasis>même si vous avez inactivé
+ Désormais, toutes les alertes, notes, ... seront envoyées
+ sur la socket client, <emphasis>même si vous avez inactivé
le rapport d'erreur avec <function>error_reporting</function></emphasis>.
</para>
<note>
<para>
Le code du déggeur n'a pas été porté
- en PHP 4.0, au moment de la rédaction de ce manuel :
+ en PHP 4.0, au moment de la rédaction de ce manuel :
seule la version 3.0 accepte le débuggeur.
</para>
</note>
</sect1>
-
<sect1 id="debugger-protocol">
<title>Protocole du débuggeur</title>
<para>
- Le protocole de débugage est ligne par ligne. Chaque ligne a un type
<emphasis>type</emphasis>, et plusieurs lignes composent un message
+ Le protocole de débugage est ligne par ligne. Chaque ligne a un type
+ <emphasis>type</emphasis> et plusieurs lignes composent un message
Chaque message commence avec une ligne du type <literal>start</literal> et se
- termine avec une ligne de type <literal>end</literal>. PHP peut envoyer des
+ termine avec une ligne de type <literal>end</literal>. PHP peut envoyer des
lignes de plusieurs messages simultanément.
</para>
<para>
- Voici un exemple de ligne à ce format :
+ Voici un exemple de ligne à ce format :
<informalexample>
<literallayout>
<replaceable>date</replaceable> <replaceable>time</replaceable>
@@ -90,7 +88,7 @@
<term><replaceable>host</replaceable></term>
<listitem>
<simpara>
- Le nom DNS ou adresse IP de l'hôte qui a généré
+ Le nom DNS ou adresse IP de l'hôte qui a généré
l'erreur.
</simpara>
</listitem>
@@ -99,7 +97,7 @@
<term><replaceable>pid</replaceable></term>
<listitem>
<simpara>
- PID (process id) sur l'hôte <replaceable>host</replaceable>, qui a
+ PID (process id) sur l'hôte <replaceable>host</replaceable>, qui a
généré
l'erreur.
</simpara>
@@ -109,7 +107,7 @@
<term><replaceable>type</replaceable></term>
<listitem>
<para>
- Type de la ligne. Indique au programme client comment traiter les
+ Type de la ligne. Indique au programme client comment traiter les
données suivantes :
<table>
<title>Types des lignes du Débuggeur</title>
@@ -122,10 +120,10 @@
</thead>
<tbody>
<row>
- <entry><literal>start</literal></entry>
+ <entry><literal>start</literal></entry>
<entry>
- Indique au programme client que le message du débuggeur
- commence ici. Le contenu de <replaceable>data</replaceable> sera un type
+ Indique au programme client que le message du débuggeur
+ commence ici. Le contenu de <replaceable>data</replaceable> sera un type
d'erreur, comme listé ci dessous.
</entry>
</row>
@@ -136,9 +134,9 @@
<row>
<entry><literal>location</literal></entry>
<entry>
- Nom du fichier, et numéro de ligne, oú l'erreur est
+ Nom du fichier et numéro de ligne, oú l'erreur est
survenue. La première occurence de <literal>location</literal>
- contiendra toujours la localisation générale.
+ contiendra toujours la localisation générale.
<replaceable>data</replaceable> contiendra :
<literal><replaceable>file</replaceable>:<replaceable>line</replaceable></literal>.
Il y a toujours une indication de <literal>location</literal>
@@ -148,24 +146,24 @@
</row>
<row>
<entry>
- <literal>frames</literal></entry>
- <entry>
- Nombre de frames dans le dump de la pile. Si il y a 4 frames, attendez
- vous à des information sur 4 niveaux de fonctions. Si la ligne
- "frame" n'existe pas, la profondeur doit être 0 (une erreur
- est survenue au niveau général).
- </entry>
+ <literal>frames</literal></entry>
+ <entry>
+ Nombre de frames dans le dump de la pile. Si il y a 4 frames, attendez
+ vous à des information sur 4 niveaux de fonctions. Si la ligne
+ "frame" n'existe pas, la profondeur doit être 0 (une erreur
+ est survenue au niveau général).
+ </entry>
</row>
<row>
<entry>
- <literal>function</literal></entry>
+ <literal>function</literal></entry>
<entry>
- Nom de la fonction qui a généré l'erreur. Elle sera
+ Nom de la fonction qui a généré l'erreur. Elle sera
répétée à chaque niveau de la pile d'appel.
</entry>
</row>
<row>
- <entry><literal>end</literal></entry>
+ <entry><literal>end</literal></entry>
<entry>
Indique au client que le message du débuggeur se termine ici.
</entry>
@@ -183,7 +181,6 @@
</listitem>
</varlistentry>
</variablelist>
-
<table>
<title>Types d'erreur du débuggeur</title>
<tgroup cols="2">
@@ -225,7 +222,6 @@
</tbody>
</tgroup>
</table>
-
<example>
<title>Exemple de message du débuggeur</title>
<literallayout>
@@ -240,9 +236,7 @@
</example>
</para>
</sect1>
-
</appendix>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
