[Sync-En] chapters, chmonly: fix typos and grammar

chapters/intro.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0bae88c19601e7f67ae6a22a8f9aa44cb9342cc1 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: cd7a4b94a4cf282d8fd70803f0e2fdd159557444 Maintainer: lacatoire Status: ready -->
 
 <chapter xml:id="introduction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <info>
@@ -50,7 +50,7 @@ echo "Bonjour, je suis un script PHP !";
    qui permettent au serveur web de passer en <quote>mode PHP</quote>.
   </para>
   <para>
-   Ce qui distingue PHP des langages de script comme le Javascript,
+   Ce qui distingue PHP des langages de script comme JavaScript,
    est que le code est exécuté sur le serveur, générant ainsi le HTML, qui
    sera ensuite envoyé au client. Le client ne reçoit que le
    résultat du script, sans aucun moyen d'avoir accès au code
@@ -131,34 +131,34 @@ echo "Bonjour, je suis un script PHP !";
    la programmation procédurale ou objet (OOP), ou encore un mélange des
    deux.
   </para>
-  <para>
+  <simpara>
    PHP ne se limite pas à la production de code HTML. Ses capacités incluent
    la création de types de fichiers riches, tels que des images ou des fichiers PDF, le chiffrement de données
    et l'envoi d'e-mails. Il peut également facilement générer n'importe quel texte, tel que JSON
    ou XML. PHP peut générer automatiquement ces fichiers et les enregistrer dans
-   le système de fichiers au lieu de les imprimer, formant ainsi un cache côté serveur pour
+   le système de fichiers au lieu de les afficher, formant ainsi un cache côté serveur pour
    le contenu dynamique.
-  </para>
-  <para>
+  </simpara>
+  <simpara>
    Une des forces les plus significatives de PHP est qu'il supporte
    <link linkend="refs.database">énormément de bases de données</link>.
    Écrire une page web faisant appel à une base de données devient
    terriblement simple, en utilisant une des extensions spécifiques
-   aux bases de données (par exemple pour <link linkend="book.mysqli">mysql</link>),
+   aux bases de données (par exemple pour <link linkend="book.mysqli">MySQL</link>),
    ou utilisant une couche d'abstraction comme <link linkend="book.pdo">PDO</link>,
    ou une connexion à n'importe quelle base de données supportant le standard
    Open Database Connection via l'extension <link linkend="book.uodbc">ODBC</link>.
    Les autres bases de données peuvent utiliser l'extension
    <link linkend="book.curl">cURL</link> ou <link linkend="book.sockets">sockets</link>
    comme CouchDB.
-  </para>
+  </simpara>
   <simpara>
    PHP supporte de nombreux protocoles comme
    LDAP, IMAP, SNMP, NNTP, POP3, HTTP, COM (sous Windows) et
    encore d'autres. Il peut aussi ouvrir des sockets réseau,
    et interagir avec n'importe quel autre protocole.
   </simpara>
-  <para>
+  <simpara>
    PHP possède des fonctionnalités utiles dans le
    <link linkend="refs.basic.text">traitement de texte</link>,
    incluant les expressions régulières compatibles Perl (<link linkend="book.pcre">PCRE</link>),
@@ -168,7 +168,7 @@ echo "Bonjour, je suis un script PHP !";
    et étend le jeu de fonctionnalités en ajoutant le support de
    <link linkend="book.simplexml">SimpleXML</link>, <link linkend="book.xmlreader">XMLReader</link>
    et <link linkend="book.xmlwriter">XMLWriter</link>.
-  </para>
+  </simpara>
   <para>
    Beaucoup d'autres extensions existent, catégorisées
    <link linkend="extensions">alphabétiquement</link> et par <link linkend="funcref">catégorie</link>.

chapters/tutorial.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1340d3595bde8489ea1385868ffd75471a56999b Maintainer: lacatoire Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: cd7a4b94a4cf282d8fd70803f0e2fdd159557444 Maintainer: lacatoire Status: ready -->
 
  <chapter xml:id="tutorial" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <info><title>Une introduction à PHP</title></info>
@@ -106,7 +105,7 @@ php -S localhost:8000
     de balises spéciales qui permettent de réaliser beaucoup de choses intéressantes.
    </para>
 
-   <para>
+   <simpara>
     Le point important de cet exemple était de montrer le format des
     balises spéciales PHP. Nous avons utilisé ici
     <literal>&lt;?php</literal> pour indiquer le début de la balise PHP.
@@ -115,11 +114,11 @@ php -S localhost:8000
     au mode HTML et vice-versa, de cette manière, à volonté. Pour plus
     d'informations, consulter la section du manuel sur la
     <link linkend="language.basic-syntax">syntaxe basique de PHP</link>.
-   </para>
+   </simpara>
 
    <note>
     <info><title>Une note sur les retours à la ligne</title></info>
-    <para>
+    <simpara>
      Les retours à la ligne ont une signification minime en HTML, cependant,
      c'est toujours une bonne idée de rendre le HTML aussi joli et propre
      que possible en y ajoutant des retours à la ligne. Un retour à la ligne
@@ -131,12 +130,12 @@ php -S localhost:8000
      PHP (<literal>?&gt;</literal>) pour forcer l'espace et un retour à
      la ligne à afficher, ou d'ajouter explicitement un retour à la ligne
      dans le dernier echo/print du bloc PHP.
-    </para>
+    </simpara>
    </note>
 
    <note>
     <info><title>Une note sur les éditeurs de texte</title></info>
-    <para>
+    <simpara>
      Il existe de nombreux éditeurs de texte et environnements de
      développement (IDE) utilisables pour créer, éditer
      et gérer des applications PHP. Une liste partielle de ces outils
@@ -145,22 +144,22 @@ php -S localhost:8000
      Pour recommander un éditeur particulier, il suffit de visiter
      cette page et de demander au webmestre de l'ajouter. Avoir au minimum
      un éditeur de texte avec la coloration syntaxique peut être utile.
-    </para>
+    </simpara>
    </note>
 
    <note>
     <info><title>Une note sur les traitements de texte</title></info>
-    <para>
+    <simpara>
      Les traitements de texte tels que StarOffice Writer, Microsoft Word et
-     Abiword sont de très mauvais choix pour éditer des scripts PHP.
+     AbiWord sont de très mauvais choix pour éditer des scripts PHP.
      Pour utiliser l'un d'entre eux malgré tout pour tester des
      scripts, il faut s'assurer de sauver les fichiers au format
      texte seul (<emphasis>plain text</emphasis>) : sinon, PHP ne sera pas capable de lire
      et d'exécuter ces scripts.
-    </para>
+    </simpara>
    </note>
 
-   <para>
+   <simpara>
     Maintenant que le script PHP précédent fonctionne, c'est le moment
     de créer le plus célèbre script PHP ! Un appel à la fonction
     <function>phpinfo</function> affichera beaucoup d'informations
@@ -169,7 +168,7 @@ php -S localhost:8000
     linkend="language.variables.predefined">variables pré-définies disponibles</link>,
     les modules PHP chargés ainsi que la <link linkend="configuration">configuration</link>.
     Prendre le temps de revoir ces informations importantes.
-   </para>
+   </simpara>
    <para>
     <example>
      <info><title>Récupération des informations du système à partir de PHP</title></info>
@@ -233,12 +232,12 @@ Mozilla/5.0 (Linux) Firefox/112.0
     </screen>
    </example>
    </para>
-   <para>
+   <simpara>
     Il y a de nombreux <link linkend="language.types">types</link> de
     variables disponibles en PHP. Dans l'exemple ci-dessus, nous avons affiché
     un élément d'une variable <link linkend="language.types.array">Tableau (Array)</link>.
     Les tableaux peuvent être très utiles.
-   </para>
+   </simpara>
    <para>
     <varname>$_SERVER</varname> est juste une variable qui est automatiquement
     disponible dans le script. Une liste de toutes les variables qui sont
@@ -289,7 +288,7 @@ Vous utilisez Firefox.
     de consulter le chapitre consacré à
     <link linkend="langref">la référence du langage</link>.
    </para>
-   <para>
+   <simpara>
     Le second concept que nous avons introduit est la fonction <function>str_contains</function>.
     <function>str_contains</function> est une fonction intégrée à PHP, qui détermine
     la présence d'une chaîne donnée dans une autre. Dans notre cas, nous
@@ -307,7 +306,7 @@ Vous utilisez Firefox.
     la page du manuel
     "<link linkend="about.prototypes">comment lire une définition de fonction</link>"
     ainsi que la <link linkend="language.functions">section sur les fonctions PHP</link>.
-   </para>
+   </simpara>
    <para>
     Il est maintenant possible de progresser et de montrer comment passer entre les modes PHP et HTML,
     au milieu d'un bloc PHP :
@@ -343,27 +342,27 @@ if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox')) {
      </screen>
     </example>
    </para>
-   <para>
+   <simpara>
     Au lieu d'utiliser une commande <function>echo</function> pour afficher
     du texte, il est possible d'utiliser du code HTML pur. Le point important à noter
     ici est que la logique de programmation est conservée. Seul un des deux
     blocs HTML sera affiché, suivant le résultat de la fonction <function>str_contains</function>.
     En d'autres termes, cela dépend si la chaîne <literal>Firefox</literal>
     a été trouvée ou non.
-   </para>
+   </simpara>
   </section>
 
   <section xml:id="tutorial.forms">
    <info><title>Utiliser un formulaire</title></info>
-   <para>
+   <simpara>
     L'un des points forts de PHP est sa capacité à gérer les formulaires.
     Le concept de base qui est important à comprendre est que tous les
     champs d'un formulaire seront automatiquement disponibles dans le
     script PHP d'action. Consulter le chapitre du manuel concernant les
     <link linkend="language.variables.external">variables depuis des sources externes à PHP</link>
     pour plus d'informations et d'exemples sur la façon d'utiliser les
     formulaires. Voici un exemple de formulaire HTML :
-   </para>
+   </simpara>
    <para>
     <example>
      <info><title>Un simple formulaire HTML</title></info>
@@ -410,12 +409,12 @@ Tu as 29 ans.
      </screen>
     </example>
    </para>
-   <para>
+   <simpara>
     Mis à part les parties <function>htmlspecialchars</function> et
     <literal>(int)</literal>, ce script ne fait que des choses évidentes.
     <function>htmlspecialchars</function> s'assure que tous les caractères
     spéciaux HTML sont proprement encodés afin d'éviter des injections
-    de balises HTML et de Javascript dans les pages. Pour l'âge, vu que
+    de balises HTML et de JavaScript dans les pages. Pour l'âge, vu que
     c'est un entier, il est possible de le
     <link linkend="language.types.typecasting">convertir</link> en un
     &integer;. PHP peut également le faire
@@ -434,7 +433,7 @@ Tu as 29 ans.
     <varname>$_REQUEST</varname>,
     pour ne pas se soucier de la source des données. Elle contient
     un mélange des données de GET, POST et COOKIE.
-   </para>
+   </simpara>
   </section>
 
   <section xml:id="tutorial.whatsnext">

chmonly/aboutchm.xml

@@ -1,10 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: Fan2Shrek Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 4d624ced045b1f0012d9010351e250e8b2bbb755 Maintainer: Fan2Shrek Status: ready -->
  <chapter xml:id="chm.about" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>À propos de cette édition</title>
 
-  <para>
+  <simpara>
    L'édition Windows HTML Help du Manuel PHP est destinée aux
    développeurs qui veulent avoir le manuel à portée de main à tout
    moment, et qui souhaitent lire les pages du manuel et les notes
@@ -14,12 +13,13 @@
    intéressantes fournies par l'application de visualisation, par les
    scripts que nous utilisons pour générer ce format et par d'autres
    contributeurs sous forme de skins.
-  </para>
+  </simpara>
 
-  <para>
+  <simpara>
    Cette distribution du Manuel PHP contient de nombreux fichiers, y compris
    le fichier principal du manuel <filename>php_manual_fr.chm</filename>.
-   Le manuel peut être visualisé en double-cliquant sur ce fichier.
+   Le manuel peut être visualisé en double-cliquant sur ce fichier
+   (comme on pouvait s'en douter).
    <!--
    The user notes are in <filename>php_manual_notes.chm</filename>. You
    only need to have one copy of this file on your computer, regardless
@@ -30,7 +30,7 @@
    Il est également possible de voir un fichier <filename>php_manual_fr.chw</filename> dans le
    répertoire ; il est généré lors de la première utilisation de l'onglet d'index, et
    il contient un index des pages du manuel.
-  </para>
+  </simpara>
 
   <para>
    Pour ceux qui sont intéressés par les détails techniques sur Microsoft HTML Help,

chmonly/integration.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7cecc752c7a19aa6ea422ac7ae82952a21bedd67 Maintainer: lacatoire Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 4d624ced045b1f0012d9010351e250e8b2bbb755 Maintainer: lacatoire Status: ready -->
  <chapter xml:id="chm.integration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Intégration du Manuel PHP</title>
 
@@ -18,24 +17,24 @@
    mais il est peut-être nécessaire de connaître quelques détails sur le contenu
    du CHM pour intégrer avec succès le manuel dans l'environnement.
   </para>
-  <para>
+  <simpara>
    Le CHM est construit en utilisant des feuilles de style XSL à partir de sources XML. C'est
    actuellement unique dans la famille du Manuel PHP, car toutes les autres versions sont
    générées à l'aide de feuilles de style DSSSL. Cela signifie également que
    des différences de rendu non intentionnelles peuvent apparaître. Un script de conversion
-   spécial est exécuté sur la sortie XSLT, ajoutant plusieurs fonctionnalités sympas,
+   spécial est exécuté sur la sortie XSLT, ajoutant plusieurs fonctionnalités utiles,
    et emballant le manuel avec les fichiers de préférences et
    les exemples de skin.
-  </para>
-  <para>
+  </simpara>
+  <simpara>
    Les CHMs peuvent être considérés comme des fichiers
    compressés avec un accès supporté par le système d'exploitation pour les fichiers à l'intérieur et un
    support de recherche et d'index ajouté. Cependant, les CHMs ne peuvent être visualisés qu'en utilisant l'HTML Help
    Viewer ; il est possible d'accéder directement aux fichiers à l'intérieur en utilisant un préfixe
    d'URL spécial, le nom du fichier CHM et le fichier demandé à l'intérieur. Comme tout
    le contenu de l'aide est stocké dans des fichiers HTML, il est possible d'afficher des pages du CHM
    dans Internet Explorer.
-  </para>
+  </simpara>
   <simpara>
    En supposant que le fichier <filename>php_manual_en.chm</filename> se trouve dans
    <filename>c:\phpmanual</filename>, l'index du manuel (visible
@@ -88,12 +87,12 @@
    et de fournir la chaîne spécifiée par l'IDE comme paramètre. Un exemple
    pour cela est l'intégration UltraEdit 9 (voir le site web de l'édition).
   </para>
-  <para>
+  <simpara>
    L'index du manuel (accessible via l'onglet index sur le volet de navigation)
    peut également être utilisé à des fins d'intégration. Toutes les pages HTML
    sont incluses dans l'index avec leurs titres comme termes d'index (y compris
    les pages de description des fonctions).
-  </para>
+  </simpara>
   <para>
    Pour les développeurs d'applications de bureau souhaitant intégrer
    étroitement le CHM dans leur programme (comme afficher l'arborescence de la table des matières