Partial sync SPL with EN

Some XInclude failures for now but will resolve soon
php · Jan 28, 2024 · f39ae3d · f39ae3d
1 parent 701d971
commit f39ae3d
Show file tree

Hide file tree

Showing 106 changed files with 1,333 additions and 1,829 deletions.
diff --git a/reference/spl/appenditerator.xml b/reference/spl/appenditerator.xml
@@ -1,15 +1,13 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: b77ea449e7387667c8c8386ea4f736748abf2787 Maintainer: chuso Status: ready -->
+<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: chuso Status: ready -->
 <!-- Reviewed: yes Maintainer: seros -->
-
 <phpdoc:classref xml:id="class.appenditerator" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
- 
+
  <title>La clase AppendIterator</title>
  <titleabbrev>AppendIterator</titleabbrev>
- 
+
  <partintro>
-  
+
   <!-- {{{ AppendIterator intro -->
   <section xml:id="appenditerator.intro">
    &reftitle.intro;
@@ -18,50 +16,43 @@
    </para>
   </section>
   <!-- }}} -->
-  
+
   <section xml:id="appenditerator.synopsis">
    &reftitle.classsynopsis;
-   
+
    <!-- {{{ Synopsis -->
-   <classsynopsis>
-    <ooclass><classname>AppendIterator</classname></ooclass>
-
-    <!-- {{{ Class synopsis -->
-    <classsynopsisinfo>
-     <ooclass>
-      <classname>AppendIterator</classname>
-     </ooclass>
-
-     <ooclass>
-      <modifier>extends</modifier>
-      <classname>IteratorIterator</classname>
-     </ooclass>
-
-     <oointerface>
-      <interfacename>OuterIterator</interfacename>
-     </oointerface>
-
-    </classsynopsisinfo>
-    <!-- }}} -->
-
+   <classsynopsis class="class">
+    <ooclass>
+     <classname>AppendIterator</classname>
+    </ooclass>
+
+    <ooclass>
+     <modifier>extends</modifier>
+     <classname>IteratorIterator</classname>
+    </ooclass>
+
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.appenditerator')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[1])" />
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.appenditerator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
-
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.appenditerator')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='AppendIterator'])">
+     <xi:fallback/>
+    </xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.appenditerator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='AppendIterator'])">
+     <xi:fallback/>
+    </xi:include>
+
     <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.iteratoriterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
-
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.iteratoriterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='IteratorIterator'])">
+     <xi:fallback/>
+    </xi:include>
    </classsynopsis>
    <!-- }}} -->
-   
+
   </section>
-  
+
  </partintro>
- 
+
  &reference.spl.entities.appenditerator;
-
-</phpdoc:classref>
 
+</phpdoc:classref>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/spl/appenditerator/append.xml b/reference/spl/appenditerator/append.xml
@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: ad0e460b0213839e66de0793f3a2fde9415f57e3 Maintainer: yago Status: ready -->
-
+<!-- EN-Revision: d51166ca16fda8e766849505b84f9306ef443f71 Maintainer: yago Status: ready -->
+<!-- Reviewed: no -->
 <refentry xml:id="appenditerator.append" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>AppendIterator::append</refname>
@@ -10,7 +9,7 @@
 
  <refsect1 role="description">
   &reftitle.description;
-  <methodsynopsis>
+  <methodsynopsis role="AppendIterator">
    <modifier>public</modifier> <type>void</type><methodname>AppendIterator::append</methodname>
    <methodparam><type>Iterator</type><parameter>iterator</parameter></methodparam>
   </methodsynopsis>
@@ -41,7 +40,7 @@
    &return.void;
   </para>
  </refsect1>
- 
+
  <refsect1 role="examples"><!-- {{{ -->
   &reftitle.examples;
   <para>
@@ -71,7 +70,7 @@ abcdef
     </screen>
    </example><!-- }}} -->
   </para>
- </refsect1><!-- }}} --> 
+ </refsect1><!-- }}} -->
 
  <refsect1 role="seealso">
   &reftitle.seealso;
@@ -83,7 +82,6 @@ abcdef
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/spl/appenditerator/construct.xml b/reference/spl/appenditerator/construct.xml
@@ -1,8 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: ad0e460b0213839e66de0793f3a2fde9415f57e3 Maintainer: yago Status: ready -->
+<!-- EN-Revision: d51166ca16fda8e766849505b84f9306ef443f71 Maintainer: yago Status: ready -->
 <!-- Reviewed: no Maintainer: yago -->
-
 <refentry xml:id="appenditerator.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>AppendIterator::__construct</refname>
@@ -11,10 +9,9 @@
 
  <refsect1 role="description">
   &reftitle.description;
-  <constructorsynopsis role="oop">
-   <modifier>public</modifier> 
-   <methodname>AppendIterator::__construct</methodname>
-   <void />
+  <constructorsynopsis role="AppendIterator">
+   <modifier>public</modifier> <methodname>AppendIterator::__construct</methodname>
+   <void/>
   </constructorsynopsis>
   <para>
    Construye un AppendIterator.
@@ -26,13 +23,6 @@
   &no.function.parameters;
  </refsect1>
 
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-   &return.void;
-  </para>
- </refsect1>
-
  <refsect1 role="examples"><!-- {{{ -->
   &reftitle.examples;
   <para>
@@ -106,21 +96,21 @@ while ($appendIterator->valid()) {
 1 => 4 => Ham
 ]]>
     </screen>
-   </example><!-- }}} --> 
+   </example><!-- }}} -->
   </para>
- </refsect1><!-- }}} --> 
- 
+ </refsect1><!-- }}} -->
+
  <refsect1 role="notes"><!-- {{{ -->
   &reftitle.notes;
   <caution>
    <para>
-    Al usar <function>iterator_to_array</function> para copiar los valores de AppendIterator 
+    Al usar <function>iterator_to_array</function> para copiar los valores de AppendIterator
     a un array, debe asignarse al parámetro opcional <parameter>use_key</parameter> el valor
     &false;. Si <parameter>use_key</parameter> no es &false;, las claves que se repitan en los
     iteradores internos se sobrescribirán en el array final. No existe ninguna forma para preservar las claves originales.
    </para>
   </caution>
- </refsect1><!-- }}} --> 
+ </refsect1><!-- }}} -->
 
  <refsect1 role="seealso">
   &reftitle.seealso;
@@ -132,7 +122,6 @@ while ($appendIterator->valid()) {
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/spl/appenditerator/current.xml b/reference/spl/appenditerator/current.xml
@@ -1,8 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: ad0e460b0213839e66de0793f3a2fde9415f57e3 Maintainer: yago Status: ready -->
+<!-- EN-Revision: d51166ca16fda8e766849505b84f9306ef443f71 Maintainer: yago Status: ready -->
 <!-- Reviewed: no Maintainer: yago -->
-
 <refentry xml:id="appenditerator.current" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>AppendIterator::current</refname>
@@ -11,9 +9,9 @@
 
  <refsect1 role="description">
   &reftitle.description;
-  <methodsynopsis>
+  <methodsynopsis role="AppendIterator">
    <modifier>public</modifier> <type>mixed</type><methodname>AppendIterator::current</methodname>
-   <void />
+   <void/>
   </methodsynopsis>
   <para>
    Obtiene el valor actual.
@@ -46,7 +44,6 @@
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/spl/appenditerator/getarrayiterator.xml b/reference/spl/appenditerator/getarrayiterator.xml
@@ -1,39 +1,37 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 114db4724709cb624e8acd840978b6935f75c13a Maintainer: seros Status: ready -->
+<!-- EN-Revision: d51166ca16fda8e766849505b84f9306ef443f71 Maintainer: seros Status: ready -->
 <!-- Reviewed: yes Maintainer: seros -->
-
 <refentry xml:id="appenditerator.getarrayiterator" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>AppendIterator::getArrayIterator</refname>
   <refpurpose>Obtiene el getArrayIterator</refpurpose>
  </refnamediv>
- 
+
  <refsect1 role="description">
   &reftitle.description;
-  <methodsynopsis>
+  <methodsynopsis role="AppendIterator">
    <modifier>public</modifier> <type>ArrayIterator</type><methodname>AppendIterator::getArrayIterator</methodname>
-   <void />
+   <void/>
   </methodsynopsis>
   <para>
-   Este método obtiene el objeto <classname>ArrayIterator</classname> empleado para 
+   Este método obtiene el objeto <classname>ArrayIterator</classname> empleado para
    almacenar los iteradores añadidos con <methodname>AppendIterator::append</methodname>.
   </para>
  </refsect1>
- 
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   &no.function.parameters;
  </refsect1>
- 
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
    Devuelve un <classname>ArrayIterator</classname> que contiene
-   los iteradores añadidos.  
+   los iteradores añadidos.
   </para>
  </refsect1>
- 
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -42,9 +40,8 @@
    </simplelist>
   </para>
  </refsect1>
-
-</refentry>
 
+</refentry>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/spl/appenditerator/getiteratorindex.xml b/reference/spl/appenditerator/getiteratorindex.xml
@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: ad0e460b0213839e66de0793f3a2fde9415f57e3 Maintainer: yago Status: ready -->
-
+<!-- EN-Revision: d51166ca16fda8e766849505b84f9306ef443f71 Maintainer: yago Status: partial -->
+<!-- Reviewed: no -->
 <refentry xml:id="appenditerator.getiteratorindex" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>AppendIterator::getIteratorIndex</refname>
@@ -10,9 +9,9 @@
 
  <refsect1 role="description">
   &reftitle.description;
-  <methodsynopsis>
-   <modifier>public</modifier> <type>int</type><methodname>AppendIterator::getIteratorIndex</methodname>
-   <void />
+  <methodsynopsis role="AppendIterator">
+   <modifier>public</modifier> <type class="union"><type>int</type><type>null</type></type><methodname>AppendIterator::getIteratorIndex</methodname>
+   <void/>
   </methodsynopsis>
   <para>
    Obtiene el índice del iterador actual actual.
@@ -27,11 +26,10 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Devuelve un <type>integer</type>, que es el índice basado en cero
-   del iterador interno actual.
+   Returns the zero-based, integer index of the current inner iterator if it exists, or &null; otherwise.
   </para>
  </refsect1>
- 
+
  <refsect1 role="examples"><!-- {{{ -->
   &reftitle.examples;
   <para>
@@ -80,7 +78,6 @@ foreach ($iterator as $key => $current) {
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/spl/appenditerator/key.xml b/reference/spl/appenditerator/key.xml
@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: e3b9788fa77cd885d77ed22a0f69073b2cab62d4 Maintainer: aeoris Status: ready -->
-
+<!-- EN-Revision: d51166ca16fda8e766849505b84f9306ef443f71 Maintainer: aeoris Status: ready -->
+<!-- Reviewed: no -->
 <refentry xml:id="appenditerator.key" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>AppendIterator::key</refname>
@@ -10,9 +9,9 @@
 
  <refsect1 role="description">
   &reftitle.description;
-  <methodsynopsis>
+  <methodsynopsis role="AppendIterator">
    <modifier>public</modifier> <type>scalar</type><methodname>AppendIterator::key</methodname>
-   <void />
+   <void/>
   </methodsynopsis>
   <para>
    Obtener la clave actual.
@@ -30,7 +29,7 @@
    La clave actual si es válida o &null; en caso contrario.
   </para>
  </refsect1>
- 
+
  <refsect1 role="examples"><!-- {{{ -->
   &reftitle.examples;
   <para>
@@ -98,7 +97,6 @@ c capybara
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml