[prev in list] [next in list] [prev in thread] [next in thread] 

List:       pear-doc
Subject:    [PEAR-DOC] cvs: peardoc /fr/chapters standards.xml
From:       "Christophe Gesché" <moosh () php ! net>
Date:       2007-06-29 5:48:37
Message-ID: cvsmoosh1183096117 () cvsserver
[Download RAW message or body]

moosh		Fri Jun 29 05:48:37 2007 UTC

  Modified files:              
    /peardoc/fr/chapters	standards.xml 
  Log:
  Sync to EN 1.53 by christian
  - Clarify class coding style as decided on the last pear group meeting
  
http://cvs.php.net/viewvc.cgi/peardoc/fr/chapters/standards.xml?r1=1.40&r2=1.41&diff_format=u
Index: peardoc/fr/chapters/standards.xml
diff -u peardoc/fr/chapters/standards.xml:1.40 peardoc/fr/chapters/standards.xml:1.41
--- peardoc/fr/chapters/standards.xml:1.40	Wed Apr 11 21:34:48 2007
+++ peardoc/fr/chapters/standards.xml	Fri Jun 29 05:48:37 2007
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1" ?>
-<!-- $Revision: 1.40 $ -->
-<!-- EN-Revision: 1.52 Maintainer: moosh Status: not full ready -->
+<!-- $Revision: 1.41 $ -->
+<!-- EN-Revision: 1.53 Maintainer: moosh Status: not full ready -->
 
 <chapter id="standards">
  <title>Convention de codage</title>
@@ -98,7 +98,7 @@
     break;
 
 default:
-    defaultaction;
+    le job par defaut;
     break;
 }
 ]]>
@@ -135,6 +135,23 @@
    </para>
   </sect1>
 
+  <sect1 id="standards.classdef">
+   <title>Definitions des classes</title>
+   <para>
+    Les déclaration de classes ouvrent l'accolade sur une nouvelle ligne:
+    <programlisting role="php">
+     <![CDATA[
+class FooBar
+{
+
+    //... et le code vient ici
+
+}
+     ]]>
+    </programlisting>
+   </para>
+  </sect1>
+
   <sect1 id="standards.funcdef">
    <title>Définitions des fonctions</title>
    <para>
@@ -146,9 +163,9 @@
 function fooFunction($arg1, $arg2 = '')
 {
     if (condition) {
-        statement;
+        le_job;
     }
-    return $val;
+    return $valeur;
 }
 ]]>
     </programlisting>
@@ -875,11 +892,12 @@
   <sect1 id="standards.e_strict">
    <title><literal>E_STRICT</literal>-compatible code</title>
    <para>
-     Starting on 01 January 2007, all new code that is suggested for
-     inclusion into PEAR must be
-     <literal>E_STRICT</literal>-compatible.  This means that it must
-     not produce any warnings or errors when PHP's error reporting level
-     is set to <literal>E_STRICT</literal>.
+     Depuis le 1er janvier 2006, tout nouveau code proposé pour PEAR
+     doit être compatible <literal>E_STRICT</literal>.
+
+     Cela signifie qu'il ne doit pas produire de warning ou d'erreur
+     quand le niveau de rapport d'erreur de php est au niveau
+     <literal>E_STRICT</literal>.
    </para>
    <para>
      The development of existing packages that are not
@@ -896,19 +914,20 @@
   </sect1>
 
   <sect1 id="standards.errors">
-    <title>Error Handling Guidelines</title>
+    <title>Guide de gestion des erreurs</title>
 
     <abstract>
       <para>
         This part of the Coding Standards describes how errors are
-        handled in PEAR packages that are developed for PHP 5 and 6.  It
-        uses Exceptions, introduced in PHP 5.0 with Zend Engine 2, as
-        the error handling mechanism.
+        handled in PEAR packages that are developed for PHP 5 and 6.
+
+        It uses Exceptions, introduced in PHP 5.0 with Zend Engine 2,
+        as the error handling mechanism.
       </para>
     </abstract>
 
     <sect2>
-      <title>Definition of an error</title>
+      <title>Définition d'une erreur</title>
 
       <para>
         An error is defined as an unexpected, invalid program state from
@@ -922,16 +941,17 @@
         <programlisting role="php">
           <![CDATA[
 /*
- * Connect to Specified Database
+ * Connection à la Bade de données spécifiée.
+ *
+ * @throws Exemple_Datasource_Exception quand la
+ *         connection au DSN spécifié ne se fait pas.
  *
- * @throws Example_Datasource_Exception when it can't connect
- * to specified DSN.
  */
 function connectDB($dsn) {
     $this->db =& DB::connect($dsn);
     if (DB::isError($this->db)) {
-        throw new Example_Datasource_Exception(
-                "Unable to connect to $dsn:" . $this->db->getMessage()
+        throw new Exemple_Datasource_Exception(
+                "Impossible de se connecter à $dsn:" . $this->db->getMessage()
         );
     }
 }
@@ -1394,16 +1414,20 @@
 
 
   <sect1 id="standards.bestpractices">
-    <title>Meilleure pratique</title>
+    <title>Les bonnes pratiques</title>
     <para>
      Il y a d'autres choses qui ne sont pas couvertes par la convention de
      codage PEAR qui sont plus sujètes à des préférences personnelles et
-     qui ne sont pas directement liées à la lisibilité du code. Par exemple,
-     l'utilisateur des simples ou des doubles guillements est permis par PHP
-     lui-même afin de rendre la programmation plus simple et il n'y a aucune
-     raison d'utiliser plutôt l'un que l'autre. Ce choix appartient au
-     développeur. La seule recommandation qui nous pouvons faire est
-     de conserver votre choix dans un même paquet et de respecter le style
+     qui ne sont pas directement liées à la lisibilité du code.
+
+     Par exemple, l'utilisateur des simples ou des doubles guillements
+     est permis par PHP lui-même afin de rendre la programmation plus
+     simple et il n'y a aucune raison d'utiliser plutôt l'un que l'autre.
+
+     Ce choix appartient au développeur.
+
+     La seule recommandation qui nous pouvons faire est de conserver
+     votre choix dans un même paquet et de respecter le style
      personnel des autres développeurs.
     </para>
   </sect1>
@@ -1415,6 +1439,7 @@
    </title>
    <para>
     Les sources des paquetages PEAR sont lues par des centaines d'utilisateurs.
+
     Il se peut aussi que d'autres personnes participent
     à votre paquetage dans le futur.
 

-- 
PEAR Documentation List Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

[prev in list] [next in list] [prev in thread] [next in thread]