Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
julionc merged 1 commit into from
Oct 21, 2026
Merged

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 13 additions & 7 deletions reference/dom/domdocument/loadxml.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 765749a26b620538117fff4425fafb3ed5834b54 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 587b7ec5ece08cb9feba0475d23fdfb28754b701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domdocument.loadxml" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -51,12 +51,10 @@
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
Si se pasa una cadena vacía como argumento <parameter>source</parameter>,
se generará una advertencia. Esta advertencia no es generada
por libxml, y no puede ser gestionada utilizando las funciones de gestión
de errores de libxml.
</para>
<simpara>
Lanza una <exceptionname>ValueError</exceptionname> si <parameter>source</parameter>
es una cadena vacía.
</simpara>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
Expand All @@ -75,6 +73,14 @@
Esta función tiene ahora un tipo de retorno <type>bool</type> provisional.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Pasar una cadena vacía como <parameter>source</parameter> lanza ahora una
<exceptionname>ValueError</exceptionname>; anteriormente, se generaba un
<constant>E_WARNING</constant> y se devolvía &false;.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Expand Down
35 changes: 17 additions & 18 deletions reference/gmp/functions/gmp-random-seed.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b412bbd26214f7281ac7dd858710e09952a275f2 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: ea41e5c4e5b73512b59c76f6a45ea146a97667a9 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.gmp-random-seed" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -23,11 +22,10 @@
<varlistentry>
<term><parameter>seed</parameter></term>
<listitem>
<para>
La semilla a definir para las funciones <function>gmp_random</function>,
<function>gmp_random_bits</function>, y
<simpara>
La semilla a definir para las funciones <function>gmp_random_bits</function> y
<function>gmp_random_range</function>.
</para>
</simpara>

&gmp.parameter;
</listitem>
Expand All @@ -43,13 +41,13 @@
</para>
</refsect1>

<refsect1 role="errors"><!-- {{{ -->
<refsect1 role="errors">
&reftitle.errors;
<para>
Levanta una excepción <classname>ValueError</classname> si el
argumento <parameter>seed</parameter> es inválido.
</para>
</refsect1><!-- }}} -->
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
Expand All @@ -67,7 +65,7 @@
<entry>
Si el argumento <parameter>seed</parameter> es inválido, <function>gmp_random_seed</function>
levanta una excepción <classname>ValueError</classname> a partir de ahora.
Anteriormente se emitía una advertencia <constant>E_WARNING</constant>.
Anteriormente se emitía una advertencia <constant>E_WARNING</constant> y se devolvía &false;.
</entry>
</row>
</tbody>
Expand All @@ -86,25 +84,27 @@
// definir la semilla
gmp_random_seed(100);

var_dump(gmp_strval(gmp_random(1)));
var_dump(gmp_strval(gmp_random_bits(10)));

// definir la semilla a otro valor
gmp_random_seed(gmp_init(-100));

var_dump(gmp_strval(gmp_random_bits(10)));
var_dump(gmp_strval(gmp_random_range(0, 100)));

// definir una semilla con un valor inválido
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>
Expand All @@ -115,7 +115,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>
Expand Down
10 changes: 7 additions & 3 deletions reference/openssl/functions/openssl-random-pseudo-bytes.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 52c495140bdb84f45f186bfb1cccf09788b0121e Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9666c3ea1febc91522ac52e02e692002413701f4 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.openssl-random-pseudo-bytes" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -22,7 +21,8 @@
<para>
Indica asimismo si el algoritmo fuerte de criptología ha sido utilizado para
producir estos octetos pseudo-aleatorios, utilizando el argumento
<parameter>strong_result</parameter>.
<parameter>strong_result</parameter>. Es poco frecuente que sea &false;, pero algunos
sistemas pueden estar defectuosos o ser antiguos.
</para>
</refsect1>

Expand Down Expand Up @@ -65,6 +65,10 @@
<para>
<function>openssl_random_pseudo_bytes</function> lanza una <classname>Exception</classname> en caso de error.
</para>
<simpara>
Lanza una <exceptionname>ValueError</exceptionname> si <parameter>length</parameter>
es inferior a <literal>1</literal>.
</simpara>
</refsect1>

<refsect1 role="changelog">
Expand Down
23 changes: 16 additions & 7 deletions reference/sem/functions/sem-get.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e1ed939373254ebf51ed7822d1a700eb4abeb3a1 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-get">
<refnamediv>
Expand Down Expand Up @@ -57,7 +56,7 @@
<listitem>
<simpara>
Los permisos del semáforo.
Actualmente, este valor solo se aplica
En realidad, este valor solo se aplica
si el proceso es el único proceso actualmente
adjunto al semáforo.
</simpara>
Expand All @@ -68,7 +67,7 @@
<listitem>
<simpara>
El argumento opcional <parameter>auto_release</parameter> especifica
si el semáforo debe ser liberado automáticamente al cerrar.
si el semáforo debe ser liberado automáticamente al finalizar la petición.
</simpara>
</listitem>
</varlistentry>
Expand All @@ -78,7 +77,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Retorna un recurso de semáforo en caso de éxito, y &false; en caso de error.
Retorna un identificador de semáforo positivo en caso de éxito, y &false; en caso de error.
</simpara>
</refsect1>

Expand All @@ -97,8 +96,8 @@
<entry>8.0.0</entry>
<entry>
En caso de éxito, esta función retorna una instancia de
<classname>SysvSemaphore</classname> ahora; anteriormente; un
<type>resource</type> era retornado.
<classname>SysvSemaphore</classname> ahora; anteriormente,
se retornaba un <type>resource</type>.
</entry>
</row>
<row>
Expand All @@ -125,6 +124,16 @@
semáforo.
</simpara>
</warning>
<warning>
<simpara>
Si <parameter>auto_release</parameter> está habilitado, las reservas
mantenidas por un objeto <classname>SysvSemaphore</classname> también se
liberan en cuanto el objeto es liberado, por ejemplo cuando la variable que
lo contiene es destruida con unset, sobrescrita o sale de ámbito, y no solo
al finalizar la petición. Conserve una referencia al objeto durante todo el
tiempo que el semáforo deba permanecer reservado.
</simpara>
</warning>
</refsect1>

<refsect1 role="seealso">
Expand Down
Loading