[Sync-En] DOM, GMP, OpenSSL and SysV semaphores: sync recent doc-en changes

reference/dom/domdocument/loadxml.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 765749a26b620538117fff4425fafb3ed5834b54 Maintainer: yannick Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 587b7ec5ece08cb9feba0475d23fdfb28754b701 Maintainer: yannick Status: ready -->
 <refentry xml:id="domdocument.loadxml" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>DOMDocument::loadXML</refname>
@@ -52,12 +51,10 @@
  </refsect1>
  <refsect1 role="errors">
   &reftitle.errors;
-  <para>
-   Si une chaîne vide est passée comme paramètre <parameter>source</parameter>,
-   une alerte sera générée. Cette alerte n'est pas générée
-   par libxml, et ne peut être gérée en utilisant les fonctions de gestion
-   d'erreur de libxml.
-  </para>
+  <simpara>
+   Lève une <exceptionname>ValueError</exceptionname> si <parameter>source</parameter>
+   est une chaîne vide.
+  </simpara>
  </refsect1>
  <refsect1 role="changelog">
   &reftitle.changelog;
@@ -76,6 +73,14 @@
        Cette fonction a maintenant un type de retour <type>bool</type> provisoire.
       </entry>
      </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Passer une chaîne vide comme paramètre <parameter>source</parameter> lève désormais une
+       <exceptionname>ValueError</exceptionname> ; auparavant, une <constant>E_WARNING</constant>
+       était émise et &false; était retourné.
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>

reference/gmp/functions/gmp-random-seed.xml

@@ -1,7 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: b412bbd26214f7281ac7dd858710e09952a275f2 Maintainer: girgias Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: ea41e5c4e5b73512b59c76f6a45ea146a97667a9 Maintainer: girgias Status: ready -->
 <refentry xml:id="function.gmp-random-seed" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>gmp_random_seed</refname>
@@ -23,11 +21,10 @@
     <varlistentry>
      <term><parameter>seed</parameter></term>
      <listitem>
-      <para>
-       La graine à définir pour les fonctions <function>gmp_random</function>,
-       <function>gmp_random_bits</function>, et
+      <simpara>
+       La graine à définir pour les fonctions <function>gmp_random_bits</function> et
        <function>gmp_random_range</function>.
-      </para>
+      </simpara>
 
       &gmp.parameter; 
      </listitem>
@@ -43,13 +40,13 @@
   </para>
  </refsect1>
 
- <refsect1 role="errors"><!-- {{{ -->
+ <refsect1 role="errors">
   &reftitle.errors;
   <para>
    Lève une exception <classname>ValueError</classname> si le
    paramètre <parameter>seed</parameter> est invalide.
   </para>
- </refsect1><!-- }}} -->
+ </refsect1>
 
  <refsect1 role="changelog">
   &reftitle.changelog;
@@ -67,7 +64,7 @@
       <entry>
        Si le paramètre <parameter>seed</parameter> est invalide, <function>gmp_random_seed</function>
        lève une exception <classname>ValueError</classname> dorénavant.
-       Précédemment une alerte <constant>E_WARNING</constant> était émise.
+       Précédemment une alerte <constant>E_WARNING</constant> était émise et &false; était retourné.
       </entry>
      </row>
     </tbody>
@@ -86,25 +83,27 @@
 // Définition de la graine
 gmp_random_seed(100);
 
-var_dump(gmp_strval(gmp_random(1)));
+var_dump(gmp_strval(gmp_random_bits(10)));
 
 // Définition de la graine avec une autre valeur
 gmp_random_seed(gmp_init(-100));
 
-var_dump(gmp_strval(gmp_random_bits(10)));
+var_dump(gmp_strval(gmp_random_range(0, 100)));
 
 // Définition de la graine avec une valeur invalide
-var_dump(gmp_random_seed('not a number'));
+try {
+    gmp_random_seed('not a number');
+} catch (\ValueError $e) {
+    echo $e->getMessage(), PHP_EOL;
+}
 ]]>
     </programlisting>
     &example.outputs;
     <screen>
 <![CDATA[
-string(20) "15370156633245019617"
-string(3) "683"
-
-Warning: gmp_random_seed(): Unable to convert variable to GMP - string is not an integer in %s on line %d
-bool(false)
+string(3) "800"
+string(2) "32"
+gmp_random_seed(): Argument #1 ($seed) is not an integer string
 ]]>
     </screen>
    </example>
@@ -115,7 +114,6 @@ bool(false)
   &reftitle.seealso;
   <simplelist>
    <member><function>gmp_init</function></member>
-   <member><function>gmp_random</function></member>
    <member><function>gmp_random_bits</function></member>
    <member><function>gmp_random_range</function></member>
   </simplelist>

reference/openssl/functions/openssl-random-pseudo-bytes.xml

@@ -1,7 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 52c495140bdb84f45f186bfb1cccf09788b0121e Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: 9666c3ea1febc91522ac52e02e692002413701f4 Maintainer: yannick Status: ready -->
 <refentry xml:id="function.openssl-random-pseudo-bytes" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>openssl_random_pseudo_bytes</refname>
@@ -22,7 +20,8 @@
   <para>
    Indique également si l'algorithme fort de cryptologie a été utilisé pour
    produire ces octets pseudo-aléatoires, en utilisant le paramètre
-   <parameter>strong_result</parameter>.
+   <parameter>strong_result</parameter>. Il est rare que cette valeur soit &false;,
+   mais certains systèmes peuvent être défectueux ou anciens.
   </para>
  </refsect1>
 
@@ -66,6 +65,10 @@
   <para>
    <function>openssl_random_pseudo_bytes</function> lance une <classname>Exception</classname> en cas d'échec.
   </para>
+  <simpara>
+   Lance une <exceptionname>ValueError</exceptionname> si <parameter>length</parameter>
+   est inférieur à <literal>1</literal>.
+  </simpara>
  </refsect1>
 
  <refsect1 role="changelog">

reference/sem/functions/sem-get.xml

@@ -1,7 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: e1ed939373254ebf51ed7822d1a700eb4abeb3a1 Maintainer: yannick Status: ready -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-get">
  <refnamediv>
   <refname>sem_get</refname>
@@ -68,7 +66,7 @@
     <listitem>
      <simpara>
       Le paramètre optionnel <parameter>auto_release</parameter> spécifie
-      si le sémaphore doit être automatiquement libéré à la fermeture.
+      si le sémaphore doit être automatiquement libéré à la fin de la requête.
      </simpara>
     </listitem>
    </varlistentry>
@@ -78,7 +76,8 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Retourne une ressource de sémaphore en cas de succès, et &false; en cas d'erreur.
+   Retourne un identifiant de sémaphore positif en cas de succès, ou &false;
+   en cas d'erreur.
   </simpara>
  </refsect1>
 
@@ -125,6 +124,16 @@
     sémaphore.
    </simpara>
   </warning>
+  <warning>
+   <simpara>
+    Si <parameter>auto_release</parameter> est activé, les acquisitions détenues
+    par un objet <classname>SysvSemaphore</classname> sont également libérées dès
+    que l'objet est libéré, par exemple lorsque la variable qui le contient est
+    détruite avec unset, écrasée ou sort de la portée, et pas
+    seulement à la fin de la requête. Conservez une référence à l'objet aussi
+    longtemps que le sémaphore doit rester acquis.
+   </simpara>
+  </warning>
  </refsect1>
 
  <refsect1 role="seealso">