cvs: phpdoc-fr /appendices about.xml migration.xml
| From: | Damien Seguy | Date: | Wed, 21 May 2003 02:30:10 +0000 |
| Subject: | cvs: phpdoc-fr /appendices about.xml migration.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-397@lists.php.net to get a copy of this message | ||
dams Tue May 20 22:30:10 2003 EDT
Modified files:
/phpdoc-fr/appendices about.xml migration.xml
Log:
Spelling mistakes
Index: phpdoc-fr/appendices/about.xml diff -u phpdoc-fr/appendices/about.xml:1.8 phpdoc-fr/appendices/about.xml:1.9 --- phpdoc-fr/appendices/about.xml:1.8 Sun Apr 13 09:29:19 2003 +++ phpdoc-fr/appendices/about.xml Tue May 20 22:30:09 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <!-- TODO: add manual conventions section (eg. how to read @@ -15,7 +15,7 @@ <sect1 id="about.formats"> <title>Formats</title> <para> - Le manuel PHP est fourni en différents formats. Ces formats sont divisés en + Le manuel &php; est fourni en différents formats. Ces formats sont divisés en deux groupes : ceux qui sont disponibles en ligne, et les téléchargeables. </para> <note> @@ -26,12 +26,12 @@ </note> <para> Vous pouvez lire le manuel en ligne sur le site <ulink url="&url.php;">&url.php;</ulink> - et sur les nombreux mirroirs. Pour un confort d'utilisation accru, il est recommandé - d'uitiliser un mirroir proche de chez vous. Vous pouvez le voir en version - HTML simple (et facilement imprimable), ou bien aux couleurs de PHP.net. + et sur les nombreux miroirs. Pour un confort d'utilisation accru, il est recommandé + d'utiliser un miroir proche de chez vous. Vous pouvez le voir en version + HTML simple (et facilement imprimable), ou bien aux couleurs de &php;.net. </para> <para> - Un des points forts du manuel en ligne sur la plupart des formats + Un des points forts du manuel en ligne sur la plus part des formats téléchargeable, est l'intégration des <link linkend="about.notes">notes des utilisateurs</link>. Un inconvénient évident est que vous devez être en ligne pour profiter de ces formats. @@ -50,27 +50,28 @@ compressées avec bzip2. </para> <para> - Un autre format populaire et portable est le format PDF, le plus pratique pour + Un autre format populaire et portable est le format <acronym>PDF</acronym>, le plus pratique pour les impressions. Mais avant de lancer une telle impression, pensez bien que le manuel au complet faire plus de 2000 pages, et qu'il est constamment révisé. </para> <note> <para> - Si vous n'avez pas de programme capable de lire les fichiers PDF, téléchargez - le <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>. + Si vous n'avez pas de programme capable de lire les fichiers <acronym>PDF</acronym>, téléchargez + le <productname><ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink></productname>. </para> </note> <para> Pour les propriétaires de PDA Palm, deux formats Palm document et iSilo - sont optimisés pour cette plateforme. Vous pouvez emporter votre PDA avec + sont optimisés pour cette plate-forme. Vous pouvez emporter votre <acronym>PDA</acronym> avec vous dans vos déplacements quotidiens, et utiliser les programmes - <ulink url="&url.palm.doc;">DOC</ulink> et <ulink url="&url.palm.isilo;">iSilo</ulink> - pour améliorer vos connaissances de PHP, ou bien profiter de ses + <acronym><ulink url="&url.palm.doc;">DOC</ulink></acronym> et + <productname><ulink url="&url.palm.isilo;">iSilo</ulink></productname> + pour améliorer vos connaissances de &php;, ou bien profiter de ses références rapides. </para> <para> - Pour les plate-formes Windowsm, le format Windows HTML Help fourni une - version HTML du manuel, avec l'application Windows HTML Help : il intègre + Pour les plates-formes Windows, le format <productname>Windows HTML Help</productname> fournit une + version HTML du manuel, avec l'application <productname>Windows HTML Help</productname> : il intègre un moteur de recherche complet, un index et des signets. De nombreux IDE sous Windows fournissent des liens avec ce format pour une meilleure intégration. @@ -139,7 +140,7 @@ int Êstrlen ( string Ê str ) -strlen retourne la taille de la chaîne string . +strlen retourne la taille de la chaîne str . </screen> </para> <para> @@ -163,10 +164,10 @@ </row> <row> <entry> - (PHP 3, PHP 4) + (&php; 3, &php; 4) </entry> <entry> - strlen() est présente dans toutes les versions de PHP 3 et PHP 4. + strlen() est présente dans toutes les versions de &php; 3 et &php; 4. </entry> </row> <row> @@ -174,7 +175,7 @@ int </entry> <entry> - Type de valeur retourné par cette fonction, qui est en l'occurence + Type de valeur retourné par cette fonction, qui est en l'occurrence un &integer; (i.e. la taille d'une chaîne est mesurée par un nombre). </entry> </row> @@ -217,56 +218,56 @@ dans le tableau <parameter>haystack</parameter>). Le premier paramètre s'appelle <parameter>needle</parameter> et il peut être de différents <link linkend="language.types">types</link> : il porte - donc la mention <emphasis>mixed</emphasis>. Le paramètre <parameter>needle</parameter> - (ce que nous recherchons) peut être une valeur scalaire ( &string;, &integer;, - ou &float;), ou encore un &array;. + donc la mention <emphasis><literal>mixed</literal></emphasis>. + Le paramètre <parameter>needle</parameter> (ce que nous recherchons) + peut être une valeur scalaire ( &string;, &integer;, ou &float;), ou encore un &array;. <parameter>haystack</parameter> (le &array; dans lequel nous recherchons) est le second paramètre. Le troisième paramètre, <parameter>strict</parameter>, - est optionnel. Tous les paramètres optoinnels sont placés entre crochets. + est optionnel. Tous les paramètres optionnels sont placés entre crochets. La manuel indique que le paramètre <parameter>strict</parameter> vaut par défaut &false;. Reportez-vous au manuel de chaque fonction pour savoir comment elle fonctionne. </para> </sect1> <sect1 id="about.phpversions"> - <title>Versions de PHP docummentées dans ce manuel</title> + <title>Versions de &php; documentées dans ce manuel</title> <para> - Cette documentation contient des informations sur PHP 4, avec - des notes compatibilités et de migration depuis PHP 3. Le comportement, + Cette documentation contient des informations sur &php; 4, avec + des notes compatibilités et de migration depuis &php; 3. Le comportement, les paramètres, les valeurs retournées, etc... qui ont changé entre deux versions du manuel &php; sont documentées dans les notes utilisateurs, - et dasn le manuel lui même. + et dans le manuel lui même. </para> <para> Vous pouvez trouvez des portions de documentation destinées aux - versions CVS de PHP, ce qui signifie que les toutes dernières versions - de développement de PHP proposent ces fonctionnalités. Si vous n'êtes - pas un développeur PHP, et que vous n'avez pas la possibilité d'utiliser - la dernière version de PHP, les fonctionnalités indiquées comme + versions CVS de &php;, ce qui signifie que les toutes dernières versions + de développement de &php; proposent ces fonctionnalités. Si vous n'êtes + pas un développeur &php;, et que vous n'avez pas la possibilité d'utiliser + la dernière version de &php;, les fonctionnalités indiquées comme "disponibles uniquement en CVS" ne vous seront pas accessibles. Toutefois, ces fonctionnalités seront surement disponible dans la prochaine version - stable de PHP. Si vous voulez obtenir une version des derniers sources - de PHP, passez par <ulink url="&url.php.anoncvs;">le serveur CVS anonyme</ulink>. + stable de &php;. Si vous voulez obtenir une version des derniers sources + de &php;, passez par <ulink url="&url.php.anoncvs;">le serveur CVS anonyme</ulink>. </para> <para> Vous pouvez aussi rencontrer de la documentation qui est disponible pour - une version de PHP qui n'est pas encore publiée (par exemple, des fonctions - destinées à la version PHP 4.3.0, alors que la version publique actuelle - est PHP 4.2.3). La plupart du temps, ce n'est pas une erreur de documentation, + une version de &php; qui n'est pas encore publiée (par exemple, des fonctions + destinées à la version &php; 4.3.0, alors que la version publique actuelle + est &php; 4.2.3). La plupart du temps, ce n'est pas une erreur de documentation, mais une indication sur les fonctionnalités qui seront disponible avec la - prochaine publication de PHP. + prochaine publication de &php;. </para> </sect1> <sect1 id="about.more"> - <title>Où trouver plus d'information sur PHP?</title> + <title>Où trouver plus d'informations sur &php;?</title> <para> Ce manuel n'a pas pour objectif de fournir des présentations sur les pratiques de programmation. Si vous être un néophyte total, ou même un programmeur débutant, vous pouvez trouver difficile d'apprendre - la programmation PHP avec uniquement ce manuel : il serait mieux de trouver + la programmation &php; avec uniquement ce manuel : il serait mieux de trouver des ressources plus orientée vers l'apprentissage. Vous pouvez aussi - trouver une liste des livres traitant de PHP sur + trouver une liste des livres traitant de &php; sur <ulink url="&url.php.books;">&url.php.books;</ulink>. </para> <para> @@ -277,7 +278,7 @@ à l'URL <ulink url="&url.php.support;">&url.php.support;</ulink>, ainsi qu'une liste d'archives, et de ressources de support en ligne. De plus, à <ulink url="&url.php.links;">&url.php.links;</ulink>, il y a une liste - de sites web dédiés à PHP, avec des articles, des forum, des bibliothèques + de sites web dédiés à &php;, avec des articles, des forum, des bibliothèques de code. </para> </sect1> @@ -290,8 +291,8 @@ <para> Si vous trouvez des erreurs, dans n'importe quelle traduction de la documentation utiliser le système de rapport de bugs : <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. - Classez le rapport sous la catégorie "Documentation Problem". Vous pouvez aussi - poster vos problèmes ici même. + Classez le rapport sous la catégorie <literal>"Documentation Problem"</literal>. + Vous pouvez aussi poster vos problèmes ici même. </para> <note> <para> @@ -320,13 +321,13 @@ <title>Comment sont générées les documentations</title> <para> Ce manuel est écrit en <acronym>XML</acronym>, en utilisant - <ulink url="&url.docbook.xml;">la DTD de DocBook XM </ulink>, et - <ulink url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document - Style and Semantics Specification Language) pour le formatage, + <ulink url="&url.docbook.xml;">la DTD de DocBook XML</ulink>, et + <ulink url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> + (<literal>Document Style and Semantics Specification Language</literal>) pour le format, et aussi, expérimentalement, <ulink url="&url.xslt;"><acronym>XSLT</acronym></ulink> - (Extensible Stylesheet Language Transformations) - pour les maintenance et les formatages. + (<literal>eXtensible Stylesheet Language Transformations</literal>) + pour les maintenances et les formats. </para> <para> Grâce au format <acronym>XML</acronym> comme source, nous avons @@ -337,16 +338,18 @@ écrit par <ulink url="&url.jclark;">James Clark</ulink> et <ulink url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink> écrit par <ulink url="&url.nwalsh;">Norman Walsh</ulink>. - Nous utilisons <ulink url="&url.winhelp;">Microsoft HTML Help Workshop</ulink> - pour générer le format Windows HTML Help format du manuel, - et bien sur, PHP lui-même pour réaliser certaines conversions - et formatages. + Nous utilisons <productname><ulink url="&url.winhelp;">Microsoft HTML Help Workshop</ulink></productname> + pour générer le format <productname>Windows HTML Help</productname> format du manuel, + et bien sur, &php; lui-même pour réaliser certaines conversions + et formats. </para> <para> Vous pouvez télécharger le manuel dans différentes langues, y compris un format en texte plein, <acronym>HTML</acronym>, - <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo et - Windows HTML Help, à l'URL <ulink url="&url.php.docs;">&url.php.docs;</ulink>. + <acronym>PDF</acronym>, <productname>PalmPilot DOC</productname>, + <productname>PalmPilot iSilo</productname> et + <productname>Windows HTML Help</productname>, à l'URL + <ulink url="&url.php.docs;">&url.php.docs;</ulink>. Les manuels sont mis à jours automatiquement, avec la mise à jour des sources. </para> @@ -361,18 +364,19 @@ <sect1 id="about.translations"> <title>Traductions</title> <para> - La manuel PHP est disponible non seulement en anglais, mais aussi dans + La manuel &php; est disponible non seulement en anglais, mais aussi dans différentes langues. Le texte du manuel est écrit d'abord en anglais, puis des équipes à travers le monde, assure la traduction du manuel dans leur langue natale. Si la traduction d'une section n'est pas encore disponible, - le système de création de la doc présentera alors la version anglaise. + le système de création de la documentation présentera + alors la version anglaise. </para> <para> Les contributeurs aux documentations partent des codes sources <acronym>XML</acronym> disponibles sur le CVS <ulink url="&url.php.cvs;">&url.php.cvs;</ulink> puis traduisent dans leur langue. Ils <emphasis>n'utilisent pas</emphasis> le format <acronym>HTML</acronym>, le texte plein, ou encore le format - PDF. C'est le système d'édition qui se charge de faire les conversions + <acronym>PDF</acronym>. C'est le système d'édition qui se charge de faire les conversions du format <acronym>XML</acronym> vers un format lisible. </para> <note> @@ -381,7 +385,7 @@ contact avec l'équipe de documentation en vous inscrivant à la liste de diffusion : <ulink url="mailto:&email.php.doc.subscribe;">&email.php.doc.subscribe;</ulink>. L'adresse de la liste de diffusion est <literal>&email.php.doc;</literal>. - Indiquez dans le message que vous êtes interessé pour traduire la documentation + Indiquez dans le message que vous êtes intéressé pour traduire la documentation dans une nouvelle langue, et quelqu'un viendra vous aider à démarrer un nouveau site de traduction, ou rejoindre l'équipe qui a pris en charge cette traduction. @@ -391,8 +395,8 @@ Actuellement, le manuel est disponible, partiellement ou en totalité, dans les langues suivantes : Allemand, Chinois (simplifié), Chinois (traditionnel), Coréen, Espagnol, - Finnois, Français, Hebreu, Hongrois, Italien, Japonais, Néerlandais, Polonais, - Portuguais brésilien, Roumain, Russe, Slovaque, Slovène, Suédois, + Finnois, Français, Hébreu, Hongrois, Italien, Japonais, Néerlandais, Polonais, + Portugais brésilien, Roumain, Russe, Slovaque, Slovène, Suédois, Tchèque et Turc. </para> <para> @@ -406,9 +410,9 @@ La version française est traduite quotidiennement et disponible chez Nexen (<ulink url="&url.nexen;">nexen.net/</ulink>). Ce manuel a été généré à partir de - la documentation originale en anglais du PHP Documentation Group, au + la documentation originale en anglais du &php; Documentation Group, au format XML. Elle est 100% compatible avec le système de génération - du groupe PHP. Elle est traité avec un système développé par + du groupe &php;. Elle est traité avec un système développé par Nexen pour produire divers autres formats. </para> <para> Index: phpdoc-fr/appendices/migration.xml diff -u phpdoc-fr/appendices/migration.xml:1.16 phpdoc-fr/appendices/migration.xml:1.17 --- phpdoc-fr/appendices/migration.xml:1.16 Tue May 20 18:57:33 2003 +++ phpdoc-fr/appendices/migration.xml Tue May 20 22:30:09 2003 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> +<!-- $Revision: 1.17 $ --> <appendix id="migration"> <title>Migration de PHP/FI 2.0 à PHP 3.0</title> <sect1 id="migration.about"> <title>A propos des incompatibilités en 3.0</title> <simpara> - PHP 3.0 a été entièrement réécrit. Le nouveau + 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 mémoire. Cependant, ces améliorations n'ont pu être
Index: phpdoc-fr/appendices/about.xml diff -u phpdoc-fr/appendices/about.xml:1.8 phpdoc-fr/appendices/about.xml:1.9 --- phpdoc-fr/appendices/about.xml:1.8 Sun Apr 13 09:29:19 2003 +++ phpdoc-fr/appendices/about.xml Tue May 20 22:30:09 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <!-- TODO: add manual conventions section (eg. how to read @@ -15,7 +15,7 @@ <sect1 id="about.formats"> <title>Formats</title> <para> - Le manuel PHP est fourni en différents formats. Ces formats sont divisés en + Le manuel &php; est fourni en différents formats. Ces formats sont divisés en deux groupes : ceux qui sont disponibles en ligne, et les téléchargeables. </para> <note> @@ -26,12 +26,12 @@ </note> <para> Vous pouvez lire le manuel en ligne sur le site <ulink url="&url.php;">&url.php;</ulink> - et sur les nombreux mirroirs. Pour un confort d'utilisation accru, il est recommandé - d'uitiliser un mirroir proche de chez vous. Vous pouvez le voir en version - HTML simple (et facilement imprimable), ou bien aux couleurs de PHP.net. + et sur les nombreux miroirs. Pour un confort d'utilisation accru, il est recommandé + d'utiliser un miroir proche de chez vous. Vous pouvez le voir en version + HTML simple (et facilement imprimable), ou bien aux couleurs de &php;.net. </para> <para> - Un des points forts du manuel en ligne sur la plupart des formats + Un des points forts du manuel en ligne sur la plus part des formats téléchargeable, est l'intégration des <link linkend="about.notes">notes des utilisateurs</link>. Un inconvénient évident est que vous devez être en ligne pour profiter de ces formats. @@ -50,27 +50,28 @@ compressées avec bzip2. </para> <para> - Un autre format populaire et portable est le format PDF, le plus pratique pour + Un autre format populaire et portable est le format <acronym>PDF</acronym>, le plus pratique pour les impressions. Mais avant de lancer une telle impression, pensez bien que le manuel au complet faire plus de 2000 pages, et qu'il est constamment révisé. </para> <note> <para> - Si vous n'avez pas de programme capable de lire les fichiers PDF, téléchargez - le <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>. + Si vous n'avez pas de programme capable de lire les fichiers <acronym>PDF</acronym>, téléchargez + le <productname><ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink></productname>. </para> </note> <para> Pour les propriétaires de PDA Palm, deux formats Palm document et iSilo - sont optimisés pour cette plateforme. Vous pouvez emporter votre PDA avec + sont optimisés pour cette plate-forme. Vous pouvez emporter votre <acronym>PDA</acronym> avec vous dans vos déplacements quotidiens, et utiliser les programmes - <ulink url="&url.palm.doc;">DOC</ulink> et <ulink url="&url.palm.isilo;">iSilo</ulink> - pour améliorer vos connaissances de PHP, ou bien profiter de ses + <acronym><ulink url="&url.palm.doc;">DOC</ulink></acronym> et + <productname><ulink url="&url.palm.isilo;">iSilo</ulink></productname> + pour améliorer vos connaissances de &php;, ou bien profiter de ses références rapides. </para> <para> - Pour les plate-formes Windowsm, le format Windows HTML Help fourni une - version HTML du manuel, avec l'application Windows HTML Help : il intègre + Pour les plates-formes Windows, le format <productname>Windows HTML Help</productname> fournit une + version HTML du manuel, avec l'application <productname>Windows HTML Help</productname> : il intègre un moteur de recherche complet, un index et des signets. De nombreux IDE sous Windows fournissent des liens avec ce format pour une meilleure intégration. @@ -139,7 +140,7 @@ int Êstrlen ( string Ê str ) -strlen retourne la taille de la chaîne string . +strlen retourne la taille de la chaîne str . </screen> </para> <para> @@ -163,10 +164,10 @@ </row> <row> <entry> - (PHP 3, PHP 4) + (&php; 3, &php; 4) </entry> <entry> - strlen() est présente dans toutes les versions de PHP 3 et PHP 4. + strlen() est présente dans toutes les versions de &php; 3 et &php; 4. </entry> </row> <row> @@ -174,7 +175,7 @@ int </entry> <entry> - Type de valeur retourné par cette fonction, qui est en l'occurence + Type de valeur retourné par cette fonction, qui est en l'occurrence un &integer; (i.e. la taille d'une chaîne est mesurée par un nombre). </entry> </row> @@ -217,56 +218,56 @@ dans le tableau <parameter>haystack</parameter>). Le premier paramètre s'appelle <parameter>needle</parameter> et il peut être de différents <link linkend="language.types">types</link> : il porte - donc la mention <emphasis>mixed</emphasis>. Le paramètre <parameter>needle</parameter> - (ce que nous recherchons) peut être une valeur scalaire ( &string;, &integer;, - ou &float;), ou encore un &array;. + donc la mention <emphasis><literal>mixed</literal></emphasis>. + Le paramètre <parameter>needle</parameter> (ce que nous recherchons) + peut être une valeur scalaire ( &string;, &integer;, ou &float;), ou encore un &array;. <parameter>haystack</parameter> (le &array; dans lequel nous recherchons) est le second paramètre. Le troisième paramètre, <parameter>strict</parameter>, - est optionnel. Tous les paramètres optoinnels sont placés entre crochets. + est optionnel. Tous les paramètres optionnels sont placés entre crochets. La manuel indique que le paramètre <parameter>strict</parameter> vaut par défaut &false;. Reportez-vous au manuel de chaque fonction pour savoir comment elle fonctionne. </para> </sect1> <sect1 id="about.phpversions"> - <title>Versions de PHP docummentées dans ce manuel</title> + <title>Versions de &php; documentées dans ce manuel</title> <para> - Cette documentation contient des informations sur PHP 4, avec - des notes compatibilités et de migration depuis PHP 3. Le comportement, + Cette documentation contient des informations sur &php; 4, avec + des notes compatibilités et de migration depuis &php; 3. Le comportement, les paramètres, les valeurs retournées, etc... qui ont changé entre deux versions du manuel &php; sont documentées dans les notes utilisateurs, - et dasn le manuel lui même. + et dans le manuel lui même. </para> <para> Vous pouvez trouvez des portions de documentation destinées aux - versions CVS de PHP, ce qui signifie que les toutes dernières versions - de développement de PHP proposent ces fonctionnalités. Si vous n'êtes - pas un développeur PHP, et que vous n'avez pas la possibilité d'utiliser - la dernière version de PHP, les fonctionnalités indiquées comme + versions CVS de &php;, ce qui signifie que les toutes dernières versions + de développement de &php; proposent ces fonctionnalités. Si vous n'êtes + pas un développeur &php;, et que vous n'avez pas la possibilité d'utiliser + la dernière version de &php;, les fonctionnalités indiquées comme "disponibles uniquement en CVS" ne vous seront pas accessibles. Toutefois, ces fonctionnalités seront surement disponible dans la prochaine version - stable de PHP. Si vous voulez obtenir une version des derniers sources - de PHP, passez par <ulink url="&url.php.anoncvs;">le serveur CVS anonyme</ulink>. + stable de &php;. Si vous voulez obtenir une version des derniers sources + de &php;, passez par <ulink url="&url.php.anoncvs;">le serveur CVS anonyme</ulink>. </para> <para> Vous pouvez aussi rencontrer de la documentation qui est disponible pour - une version de PHP qui n'est pas encore publiée (par exemple, des fonctions - destinées à la version PHP 4.3.0, alors que la version publique actuelle - est PHP 4.2.3). La plupart du temps, ce n'est pas une erreur de documentation, + une version de &php; qui n'est pas encore publiée (par exemple, des fonctions + destinées à la version &php; 4.3.0, alors que la version publique actuelle + est &php; 4.2.3). La plupart du temps, ce n'est pas une erreur de documentation, mais une indication sur les fonctionnalités qui seront disponible avec la - prochaine publication de PHP. + prochaine publication de &php;. </para> </sect1> <sect1 id="about.more"> - <title>Où trouver plus d'information sur PHP?</title> + <title>Où trouver plus d'informations sur &php;?</title> <para> Ce manuel n'a pas pour objectif de fournir des présentations sur les pratiques de programmation. Si vous être un néophyte total, ou même un programmeur débutant, vous pouvez trouver difficile d'apprendre - la programmation PHP avec uniquement ce manuel : il serait mieux de trouver + la programmation &php; avec uniquement ce manuel : il serait mieux de trouver des ressources plus orientée vers l'apprentissage. Vous pouvez aussi - trouver une liste des livres traitant de PHP sur + trouver une liste des livres traitant de &php; sur <ulink url="&url.php.books;">&url.php.books;</ulink>. </para> <para> @@ -277,7 +278,7 @@ à l'URL <ulink url="&url.php.support;">&url.php.support;</ulink>, ainsi qu'une liste d'archives, et de ressources de support en ligne. De plus, à <ulink url="&url.php.links;">&url.php.links;</ulink>, il y a une liste - de sites web dédiés à PHP, avec des articles, des forum, des bibliothèques + de sites web dédiés à &php;, avec des articles, des forum, des bibliothèques de code. </para> </sect1> @@ -290,8 +291,8 @@ <para> Si vous trouvez des erreurs, dans n'importe quelle traduction de la documentation utiliser le système de rapport de bugs : <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. - Classez le rapport sous la catégorie "Documentation Problem". Vous pouvez aussi - poster vos problèmes ici même. + Classez le rapport sous la catégorie <literal>"Documentation Problem"</literal>. + Vous pouvez aussi poster vos problèmes ici même. </para> <note> <para> @@ -320,13 +321,13 @@ <title>Comment sont générées les documentations</title> <para> Ce manuel est écrit en <acronym>XML</acronym>, en utilisant - <ulink url="&url.docbook.xml;">la DTD de DocBook XM </ulink>, et - <ulink url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document - Style and Semantics Specification Language) pour le formatage, + <ulink url="&url.docbook.xml;">la DTD de DocBook XML</ulink>, et + <ulink url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> + (<literal>Document Style and Semantics Specification Language</literal>) pour le format, et aussi, expérimentalement, <ulink url="&url.xslt;"><acronym>XSLT</acronym></ulink> - (Extensible Stylesheet Language Transformations) - pour les maintenance et les formatages. + (<literal>eXtensible Stylesheet Language Transformations</literal>) + pour les maintenances et les formats. </para> <para> Grâce au format <acronym>XML</acronym> comme source, nous avons @@ -337,16 +338,18 @@ écrit par <ulink url="&url.jclark;">James Clark</ulink> et <ulink url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink> écrit par <ulink url="&url.nwalsh;">Norman Walsh</ulink>. - Nous utilisons <ulink url="&url.winhelp;">Microsoft HTML Help Workshop</ulink> - pour générer le format Windows HTML Help format du manuel, - et bien sur, PHP lui-même pour réaliser certaines conversions - et formatages. + Nous utilisons <productname><ulink url="&url.winhelp;">Microsoft HTML Help Workshop</ulink></productname> + pour générer le format <productname>Windows HTML Help</productname> format du manuel, + et bien sur, &php; lui-même pour réaliser certaines conversions + et formats. </para> <para> Vous pouvez télécharger le manuel dans différentes langues, y compris un format en texte plein, <acronym>HTML</acronym>, - <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo et - Windows HTML Help, à l'URL <ulink url="&url.php.docs;">&url.php.docs;</ulink>. + <acronym>PDF</acronym>, <productname>PalmPilot DOC</productname>, + <productname>PalmPilot iSilo</productname> et + <productname>Windows HTML Help</productname>, à l'URL + <ulink url="&url.php.docs;">&url.php.docs;</ulink>. Les manuels sont mis à jours automatiquement, avec la mise à jour des sources. </para> @@ -361,18 +364,19 @@ <sect1 id="about.translations"> <title>Traductions</title> <para> - La manuel PHP est disponible non seulement en anglais, mais aussi dans + La manuel &php; est disponible non seulement en anglais, mais aussi dans différentes langues. Le texte du manuel est écrit d'abord en anglais, puis des équipes à travers le monde, assure la traduction du manuel dans leur langue natale. Si la traduction d'une section n'est pas encore disponible, - le système de création de la doc présentera alors la version anglaise. + le système de création de la documentation présentera + alors la version anglaise. </para> <para> Les contributeurs aux documentations partent des codes sources <acronym>XML</acronym> disponibles sur le CVS <ulink url="&url.php.cvs;">&url.php.cvs;</ulink> puis traduisent dans leur langue. Ils <emphasis>n'utilisent pas</emphasis> le format <acronym>HTML</acronym>, le texte plein, ou encore le format - PDF. C'est le système d'édition qui se charge de faire les conversions + <acronym>PDF</acronym>. C'est le système d'édition qui se charge de faire les conversions du format <acronym>XML</acronym> vers un format lisible. </para> <note> @@ -381,7 +385,7 @@ contact avec l'équipe de documentation en vous inscrivant à la liste de diffusion : <ulink url="mailto:&email.php.doc.subscribe;">&email.php.doc.subscribe;</ulink>. L'adresse de la liste de diffusion est <literal>&email.php.doc;</literal>. - Indiquez dans le message que vous êtes interessé pour traduire la documentation + Indiquez dans le message que vous êtes intéressé pour traduire la documentation dans une nouvelle langue, et quelqu'un viendra vous aider à démarrer un nouveau site de traduction, ou rejoindre l'équipe qui a pris en charge cette traduction. @@ -391,8 +395,8 @@ Actuellement, le manuel est disponible, partiellement ou en totalité, dans les langues suivantes : Allemand, Chinois (simplifié), Chinois (traditionnel), Coréen, Espagnol, - Finnois, Français, Hebreu, Hongrois, Italien, Japonais, Néerlandais, Polonais, - Portuguais brésilien, Roumain, Russe, Slovaque, Slovène, Suédois, + Finnois, Français, Hébreu, Hongrois, Italien, Japonais, Néerlandais, Polonais, + Portugais brésilien, Roumain, Russe, Slovaque, Slovène, Suédois, Tchèque et Turc. </para> <para> @@ -406,9 +410,9 @@ La version française est traduite quotidiennement et disponible chez Nexen (<ulink url="&url.nexen;">nexen.net/</ulink>). Ce manuel a été généré à partir de - la documentation originale en anglais du PHP Documentation Group, au + la documentation originale en anglais du &php; Documentation Group, au format XML. Elle est 100% compatible avec le système de génération - du groupe PHP. Elle est traité avec un système développé par + du groupe &php;. Elle est traité avec un système développé par Nexen pour produire divers autres formats. </para> <para> Index: phpdoc-fr/appendices/migration.xml diff -u phpdoc-fr/appendices/migration.xml:1.16 phpdoc-fr/appendices/migration.xml:1.17 --- phpdoc-fr/appendices/migration.xml:1.16 Tue May 20 18:57:33 2003 +++ phpdoc-fr/appendices/migration.xml Tue May 20 22:30:09 2003 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> +<!-- $Revision: 1.17 $ --> <appendix id="migration"> <title>Migration de PHP/FI 2.0 à PHP 3.0</title> <sect1 id="migration.about"> <title>A propos des incompatibilités en 3.0</title> <simpara> - PHP 3.0 a été entièrement réécrit. Le nouveau + 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 mémoire. Cependant, ces améliorations n'ont pu être