cvs: phpdoc-fr /appendices about.xml

From: Date: Wed, 03 Mar 2004 13:25:27 +0000
Subject: cvs: phpdoc-fr /appendices about.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-1979@lists.php.net to get a copy of this message
didou Wed Mar 3 08:25:27 2004 EDT Modified files: /phpdoc-fr/appendices about.xml Log: sync with en

http://cvs.php.net/diff.php/phpdoc-fr/appendices/about.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc-fr/appendices/about.xml diff -u phpdoc-fr/appendices/about.xml:1.14 phpdoc-fr/appendices/about.xml:1.15 --- phpdoc-fr/appendices/about.xml:1.14 Sun Feb 29 09:26:49 2004 +++ phpdoc-fr/appendices/about.xml Wed Mar 3 08:25:26 2004 @@ -1,27 +1,19 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- - TODO: add manual conventions section (eg. how to read - function usage parts, what is fixed width, what is - bold, what is linked - - add some tips about combining the versions (online- - offline), and using "http://anymirror.php.net/funcname" ---> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.30 Maintainer: didou Status: ready --> +<!-- Reviewed: no --> <appendix id="about"> <title>A propos du manuel</title> <sect1 id="about.formats"> <title>Formats</title> - <para> + <para> 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> - <para> - Certains éditeurs ont fournis des versions imprimées de ces manuels. Nous n'en + <note> + <para> + Certains éditeurs ont fournis des versions imprimées de ce manuel. Nous n'en recommandons aucune, car elles sont rapidement obsolètes. </para> </note> @@ -29,24 +21,25 @@ Vous pouvez lire le manuel en ligne sur le site <ulink url="&url.php;">&url.php;</ulink> 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. + 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 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. + évident est que vous devez être en ligne pour profiter de ce format. </para> <para> Il y a de nombreux formats de manuel pour la consultation hors ligne, et le format le plus approprié dépend de votre OS et de vos goûts personnels. Pour savoir comment le manuel est généré, lisez la section - <link linkend="about.generate">'Comment le manuel est généré'</link>. + <link linkend="about.generate">'Comment le manuel est généré'</link> de cet + appendice. </para> <para> - Le format le plus portable est le manuel au format HTML. Le manuel est fourni - dans un format en une seule page HTML, ou comme un ensemble de fichier - de taille réduite (mais un bon millier de fichiers tout de même). Les + Les formats le plus portables sont le HTML et le texte plain. Le manuel est fourni + dans un format en une seule page HTML, ou comme un ensemble de fichiers + de tailles réduites (mais un bon millier de fichiers tout de même). Les formats HTML et texte simple sont disponibles sous forme de fichiers d'archives compressées avec bzip2. </para> @@ -58,7 +51,7 @@ <note> <para> 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>. + <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>. </para> </note> <para> @@ -107,20 +100,29 @@ plus qu'il n'existe de garantie quand à l'exactitude du manuel lui-même. </para> </note> + <note> + <para> + Pour des questions de portée de licence, les notes utilisateurs sont + considérées comme faisant partie du manuel &php;, et sont donc couvertes par la + même licence qui couvre cette documenation (Open Publication License à ce + jour). Pour plus de détails, lisez la page <link + linkend="copyright">Manual's Copyright</link>. + </para> + </note> </sect1> <sect1 id="about.prototypes"> <title>Comment lire la définition d'une fonction (prototype)</title> <para> - Chaque fonction est documentée pour permettre un accès rapide, - et savoir décoder le manuel rendra votre lecture plus facile. Plutôt + Chaque fonction est documentée pour permettre une compréhension rapide. + Savoir décoder le manuel rendra votre lecture plus facile. Plutôt que de dépendre d'exemples prêts en copier/coller, il est mieux de - savoir lire la définition d'une fonction. Voici comment : + savoir lire la définition d'une fonction (prototype). Voici comment : </para> <note> <title> - Pré-requis : Connaissances de bases des <link linkend="language.types">types</link>. + Pré-requis : Connaissances de base des <link linkend="language.types">types</link>. </title> <para> Bien que &php; soit un langage sans typage fort, une connaissance @@ -137,11 +139,13 @@ <screen role="html"> strlen -PHP 3, PHP 4 - +(PHP 3, PHP 4 >= 4.0.0) +strlen -- Retourne la taille de la chaîne + +Description int strlen ( string str ) -strlen retourne la taille de la chaîne str . +strlen() retourne la taille de la chaîne str. </screen> </para> <para> @@ -165,7 +169,7 @@ </row> <row> <entry> - (&php; 3, &php; 4) + (&php; 3, &php; 4 >= 4.0.0) </entry> <entry> strlen() est présente dans toutes les versions de &php; 3 et &php; 4. @@ -198,7 +202,7 @@ </para> <para> <screen role="html"> - type_retourné nom_de_la fonction ( type_du_paramètre nom_du_paramètre ) + type_retourné nom_de_la_fonction ( type_du_paramètre nom_du_paramètre ) </screen> </para> <para> @@ -212,10 +216,10 @@ </para> <para> Qu'est ce que cela signifie? <function>in_array</function> retourne - un &boolean; &true; en cas de réussite ( le paramètre + un &boolean; &true; en cas de réussite (le paramètre <parameter>needle</parameter> a été trouvé dans le tableau <parameter>haystack</parameter>) ou &false; en cas d'échec - ( le paramètre <parameter>needle</parameter> n'a pas été trouvé + (le paramètre <parameter>needle</parameter> n'a pas été trouvé 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 @@ -248,20 +252,20 @@ "disponibles uniquement en CVS" ne vous seront pas accessibles. Toutefois, ces fonctionnalités seront sûrement 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>. + de &php;, passez par <ulink url="&url.php.anoncvs;">le serveur CVS</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, + destinées à la version &php; 5.0.0, alors que la version publique actuelle + est &php; 4.3.x). 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;. </para> </sect1> <sect1 id="about.more"> - <title>Où trouver plus d'informations 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 @@ -291,13 +295,14 @@ </para> <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>. + utiliser le système de rapport de bogues : <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. Classez le rapport sous la catégorie <literal>"Documentation Problem"</literal>. - Vous pouvez aussi poster vos problèmes ici même. + Vous pouvez aussi poster les problèmes liés aux différents formats du + manuel à cet endroit. </para> <note> <para> - N'abusez pas du système de bugs pour envoyer des demandes d'aide. Utilisez + N'abusez pas du système de bogues pour envoyer des demandes d'aide. Utilisez les listes de diffusion ou les sites de communauté, tels que mentionnés ci-dessus. </para> @@ -306,15 +311,15 @@ En contribuant aux notes, vous pouvez fournir de nouveaux exemples, mettre en lumière des effets de bords ou apporter des clarifications pour les autres lecteurs. Mais ne prenez pas le système d'annotation pour - un système de soumission de bugs. Vous pouvez en savoir plus sur les + un système de soumission de bogues. Vous pouvez en savoir plus sur les annotations dans la section - <link linkend="about.notes">'A propos des notes d'utilisateurs'</link> + <link linkend="about.notes">'A propos des notes utilisateurs'</link> </para> <para> - Si vous connaissez l'anglais et une autre langue, vous pouvez aussi - contribuer en participant à la traduction. Si vous voulez démarrer - une nouvelle traduction, ou participer au projet, alors commencez - par lire <ulink url="&url.php.dochowto;">&url.php.dochowto;</ulink>. + Si vous connaissez l'anglais et une autre langue, vous pouvez aussi + contribuer en participant à la traduction. Si vous voulez démarrer + une nouvelle traduction, ou participer au projet, alors commencez + par lire <ulink url="&url.php.dochowto;">&url.php.dochowto;</ulink>. </para> </sect1> @@ -369,8 +374,7 @@ 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 documentation 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 @@ -382,23 +386,22 @@ </para> <note> <para> - Si vous voulez démarrer une nouvelle e traduction dans votre langue, entrez en + Si vous voulez démarrer une nouvelle traduction dans votre langue, entrez en 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 intéressé pour traduire la documentation + Indiquez dans le message que vous êtes intéressé par la traduction de 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. + site de traduction, ou rejoindre l'équipe qui a pris en charge cette traduction. </para> </note> <para> Actuellement, le manuel est disponible, partiellement ou en totalité, dans les langues suivantes : - Allemand, Chinois (simplifié), Chinois (traditionnel), Coréen, Espagnol, - 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. + Allemand, Chinois (simplifié), Chinois (traditionnel), Chinois + (contonais de Hong Kong), Coréen, Espagnol, 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> Ils peuvent tous être téléchargés ici : <ulink url="&url.php.docs;">&url.php.docs;</ulink>. @@ -418,9 +421,8 @@ </para> <para> Pour les problèmes liés à la traduction, vous pouvez - contacter directement les éditeurs de ce manuel - <ulink url="mailto:&email.dams;">&email.dams;</ulink> et <ulink - url="mailto:didou@keliglia.com">didou@keliglia.com</ulink>. + contacter directement les éditeurs de ce manuel sur + <ulink url="mailto:doc-fr@lists.php.net">doc-fr@lists.php.net</ulink>. </para> </sect1> </appendix>
« previous php.doc.fr (#1979) next »