[Sync-En] try/catch, error handling, Error, Exception, quotemeta, match: sync with doc-en

language/control-structures/finally.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7c915c0c28b8e2e4306333c64602ee4800c73754 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 31d9f67dd1a2574dd870a2dc2ccacbed75d2ce36 Maintainer: lacatoire Status: ready -->
 
 <sect1 xml:id="control-structures.finally" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>finally</title>
@@ -13,7 +13,7 @@
   relancée.
   Il est exécuté avant la reprise du flux d'exécution normal.
   La seule exception à cette règle est l'arrêt brutal du script, comme lors d'un
-  appel à <function>exit</function> ou d'une erreur fatale (par exemple lorsque
+  appel à <function>exit</function> ou d'une erreur fatale (par exemple, lorsque
   le temps d'exécution maximal est dépassé).
  </simpara>
  <example>
@@ -28,15 +28,15 @@ function inverse($x) {
 try {
     echo inverse(5) . "\n";
 } catch (\DivisionByZeroError $e) {
-    echo 'Erreur attrapée : ',  $e->getMessage(), "\n";
+    echo 'Erreur attrapée : ', $e->getMessage(), "\n";
 } finally {
     echo "Premier finally.\n";
 }
 
 try {
     echo inverse(0) . "\n";
 } catch (\DivisionByZeroError $e) {
-    echo 'Erreur attrapée : ',  $e->getMessage(), "\n";
+    echo 'Erreur attrapée : ', $e->getMessage(), "\n";
 } finally {
     echo "Second finally.\n";
 }
@@ -250,7 +250,7 @@ function generate()
     try {
         yield 1;
         yield 2;
-    } catch(\Exception $e) {
+    } catch (\Exception $e) {
         echo 'catch';
     } finally {
         echo "finally\n";
@@ -262,7 +262,7 @@ try {
         echo $i, "\n";
         throw new Exception();
     }
-} catch(Exception $e) {
+} catch (Exception $e) {
     echo 'catch externe';
 }
 ]]>
@@ -297,7 +297,7 @@ function generate()
     try {
         yield 1;
         yield 2;
-    } catch(\Exception $e) {
+    } catch (\Exception $e) {
         echo 'catch';
     } finally {
         echo "finally\n";
@@ -310,7 +310,7 @@ try {
         echo $i, "\n";
         throw new Exception();
     }
-} catch(Exception $e) {
+} catch (Exception $e) {
     echo 'catch externe';
 }
 ]]>
@@ -410,10 +410,10 @@ quitter
 
   <simpara>
    Lorsque <function>exit</function> est appelé dans un bloc &finally;, tous les
-   autres blocs &finally; externes sont ignorés.
+   blocs &finally; externes sont ignorés.
   </simpara>
   <example>
-   <title>Ignorer le bloc &finally; externe en appelant <function>exit</function></title>
+   <title>Ignorer un bloc &finally; externe en appelant <function>exit</function></title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -454,7 +454,7 @@ function generate()
     try {
         yield 1;
         yield 2;
-    } catch(\Exception $e) {
+    } catch (\Exception $e) {
         echo 'catch';
     } finally {
         echo "finally interne\n";

language/control-structures/match.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e674990649cd2b111b8dd1175a7a1befcc621635 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: f0aab5b5f496704a2c21e4960c9f620e19f6d3c4 Maintainer: lacatoire Status: ready -->
 
 <sect1 xml:id="control-structures.match" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>match</title>
@@ -208,7 +208,7 @@ try {
         1, 2 => foo(),
         3, 4 => bar(),
     };
-} catch (\UnhandledMatchError $e) {
+} catch (UnhandledMatchError $e) {
     var_dump($e);
 }
 ]]>

language/control-structures/throw.xml

@@ -1,17 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7c915c0c28b8e2e4306333c64602ee4800c73754 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 31d9f67dd1a2574dd870a2dc2ccacbed75d2ce36 Maintainer: lacatoire Status: ready -->
 
 <sect1 xml:id="control-structures.throw" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>throw</title>
  <?phpdoc print-version-for="throw"?>
  <simpara>
   Le mot-clé &throw; est une expression et peut être utilisé dans n'importe
-  quel contexte d'expression. Il prend en argument une instance d'un objet
+  quel contexte d'expression. Il prend en argument un objet
   <exceptionname>Throwable</exceptionname>.
  </simpara>
  <caution>
   <simpara>
-   Antérieurement à PHP 8.0, le mot-clé &throw; était une instruction et non
+   Antérieurement à PHP 8.0.0, le mot-clé &throw; était une instruction et non
    une expression.
   </simpara>
  </caution>

language/control-structures/try-catch.xml

@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7c915c0c28b8e2e4306333c64602ee4800c73754 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 31d9f67dd1a2574dd870a2dc2ccacbed75d2ce36 Maintainer: lacatoire Status: ready -->
 
 <sect1 xml:id="control-structures.try-catch" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>Try...Catch</title>
+ <title>try...catch</title>
  <sect2 xml:id="control-structures.try" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>try</title>
   <?phpdoc print-version-for="try"?>
@@ -37,7 +37,7 @@
    Il spécifie une ou plusieurs sous-classes de
    <exceptionname>Throwable</exceptionname> (le plus souvent
    <exceptionname>Exception</exceptionname>) qu'il peut traiter, et
-   éventuellement une variable à laquelle assigner l'exception.
+   éventuellement une variable à laquelle l'exception est assignée.
   </simpara>
   <simpara>
    Le premier bloc &catch; qui correspond à la classe de l'objet
@@ -185,9 +185,9 @@ class B extends Exception {}
 
 try {
     throw new A;
-} catch(A $e) {
+} catch (A $e) {
     throw new B;
-} catch(B) {
+} catch (B) {
     echo 'Bonjour';
 }
 

language/error-handling.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7c915c0c28b8e2e4306333c64602ee4800c73754 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 31d9f67dd1a2574dd870a2dc2ccacbed75d2ce36 Maintainer: lacatoire Status: ready -->
 
 <chapter xml:id="language.error-handling" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="interactive">
  <title>Gestion des erreurs</title>
@@ -80,15 +80,16 @@
    <simpara>
     Les objets <exceptionname>Throwable</exceptionname> ne peuvent pas être
     clonés. Tenter de <link linkend="language.oop5.cloning">cloner</link> un tel
-    objet lance une erreur <exceptionname>Error</exceptionname>, même si une
-    sous-classe déclare sa propre méthode
-    <link linkend="object.clone">__clone()</link>, avec le message suivant :
+    objet lance une erreur <exceptionname>Error</exceptionname> avec le message
+    suivant :
     <literal>Trying to clone an uncloneable object of class Exception</literal>.
+    Cela se produit même si une sous-classe déclare sa propre méthode
+    <link linkend="object.clone">__clone()</link>.
    </simpara>
   </warning>
 
   <sect2 xml:id="language.error-handling.throwable.user">
-   <title><literal>Gestionnaire d'exceptions global</literal></title>
+   <title>Gestionnaire d'exceptions global</title>
    <simpara>
     Il est possible d'ajouter un gestionnaire pour toute erreur
     <exceptionname>Throwable</exceptionname> non attrapée avec
@@ -104,9 +105,6 @@
    <simpara>
     Une exception définie par l'utilisateur peut être créée en étendant la
     classe native <exceptionname>Exception</exceptionname>.
-    Pour connaître les méthodes et propriétés accessibles dans une classe fille
-    dérivée de <exceptionname>Exception</exceptionname>, il faut consulter sa
-    page.
    </simpara>
    <simpara>
     Si une classe étend la classe native <exceptionname>Exception</exceptionname>
@@ -232,7 +230,7 @@ Une fonction personnalisée pour ce type d'exception
    Les erreurs de diagnostic, aussi appelées erreurs traditionnelles, servent à
    signaler un certain nombre de conditions différentes, et peuvent être
    affichées et/ou enregistrées dans un journal selon les besoins.
-   Par défaut, PHP signale tous les diagnostics. (Antérieurement à PHP 8.0,
+   Par défaut, PHP signale tous les diagnostics. (Antérieurement à PHP 8.0.0,
    les diagnostics <constant>E_NOTICE</constant> et
    <constant>E_DEPRECATED</constant> n'étaient pas signalés par défaut.)
   </simpara>
@@ -270,7 +268,7 @@ Une fonction personnalisée pour ce type d'exception
    <link linkend="ini.display-errors"><parameter>display_errors</parameter></link>
    détermine si le diagnostic est affiché dans la sortie du script.
    Ceci devrait toujours être désactivé dans un environnement de production,
-   car il peut contenir des informations confidentielles, telles que les mots de
+   car la sortie peut contenir des informations confidentielles, telles que les mots de
    passe de base de données. Il est cependant souvent utile de l'activer lors
    du développement, car cela assure un signalement immédiat des problèmes.
   </simpara>
@@ -334,7 +332,7 @@ Une fonction personnalisée pour ce type d'exception
 <?php
 function exceptions_error_handler($severity, $message, $filename, $lineno) {
     if (error_reporting() & $severity) {
-       throw new ErrorException($message, 0, $severity, $filename, $lineno);
+        throw new ErrorException($message, 0, $severity, $filename, $lineno);
     }
 }
 

language/predefined/error.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: girgias Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: c4f95a6974306cf162dd4a6c89162cb310429762 Maintainer: girgias Status: ready -->
 <reference xml:id="class.error" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Error</title>
  <titleabbrev>Error</titleabbrev>
@@ -10,10 +9,12 @@
 <!-- {{{ Error intro -->
   <section xml:id="error.intro">
    &reftitle.intro;
-   <para>
-    <ooclass><classname>Error</classname></ooclass> est la classe de base pour toutes
-    les erreurs internes de PHP.
-   </para>
+   <simpara>
+    <ooclass><classname>Error</classname></ooclass> est la classe de base des
+    erreurs qui indiquent des erreurs de programmation. Ces erreurs nécessitent
+    généralement une correction du programme plutôt qu'un traitement pendant le
+    fonctionnement normal.
+   </simpara>
   </section>
 <!-- }}} -->
 
@@ -74,12 +75,8 @@
     </fieldsynopsis>
 
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Error'])">
-     <xi:fallback/>
-    </xi:include>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Error'])">
-     <xi:fallback/>
-    </xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Error'])"/>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Error'])"/>
    </classsynopsis>
 
 <!-- }}} -->

language/predefined/exception.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 462d2bcb3fa7e76dd84baadf261146bc62574ca9 Maintainer: yannick Status: ready -->
-<!-- Reviewed: yes Maintainer: yannick -->
+<!-- EN-Revision: c4f95a6974306cf162dd4a6c89162cb310429762 Maintainer: yannick Status: ready -->
 <reference xml:id="class.exception" role="exception" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Exception</title>
  <titleabbrev>Exception</titleabbrev>
@@ -10,10 +9,10 @@
 <!-- {{{ Exception intro -->
   <section xml:id="exception.intro">
    &reftitle.intro;
-   <para>
+   <simpara>
     <ooclass><classname>Exception</classname></ooclass> est la classe de base
-    pour toutes les exceptions utilisateur.
-   </para>
+    des exceptions qui peuvent être traitées pendant le fonctionnement normal.
+   </simpara>
   </section>
 <!-- }}} -->
 
@@ -74,12 +73,8 @@
     </fieldsynopsis>
 
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Exception'])">
-     <xi:fallback/>
-    </xi:include>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Exception'])">
-     <xi:fallback/>
-    </xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Exception'])"/>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Exception'])"/>
    </classsynopsis>
 
 <!-- }}} -->

reference/strings/functions/quotemeta.xml

@@ -1,7 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 6330e4d73192c49a6867c6bbc3cbf09d63a1e36a Maintainer: yannick Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: a518b2c5379647ca31d11602d5842f605f5c233c Maintainer: yannick Status: ready -->
 <refentry xml:id="function.quotemeta" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>quotemeta</refname>
@@ -40,11 +38,34 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Retourne la chaîne dont les métacaractères ont été protégés ou
-   &false; si une chaîne vide est fournie dans le paramètre
-   <parameter>string</parameter>.
-  </para>
+  <simpara>
+   Retourne la chaîne dont les métacaractères ont été protégés. Si une chaîne
+   vide est fournie dans le paramètre <parameter>string</parameter>, une chaîne
+   vide est retournée.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Retourne une chaîne vide, au lieu de &false;, lorsque
+       <parameter>string</parameter> est vide.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
  </refsect1>
 
  <refsect1 role="examples">