Sync ds with EN

php · Jan 28, 2024 · fe5638b · fe5638b
1 parent 66c5300
commit fe5638b
Show file tree

Hide file tree

Showing 6 changed files with 149 additions and 83 deletions.
diff --git a/reference/ds/ds.deque.xml b/reference/ds/ds.deque.xml
@@ -1,16 +1,15 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 73026aaaf86e4e3c993be889d5efde4b1c4fed6d Maintainer: alditis Status: ready -->
+<!-- EN-Revision: 6ceccac7860f382f16ac1407baf54f656e85ca0b Maintainer: alditis Status: ready -->
 <!-- Reviewed: no Maintainer: andresdzphp -->
 
 <phpdoc:classref xml:id="class.ds-deque" 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 Deque</title>
- <titleabbrev>Deque</titleabbrev>
+ <titleabbrev>Ds\Deque</titleabbrev>
 
  <partintro>
 
-<!-- {{{ Ds\Deque intro -->
+  <!-- {{{ Ds\Deque intro -->
   <section xml:id="ds-deque.intro">
    &reftitle.intro;
    <para>
@@ -26,53 +25,52 @@
     algo en que <classname>Ds\Vector</classname> no puede competir.
    </para>
    <para>
-
-    Accediendo a un valor por el índice requiere una traducción entre el índice y su 
+    Accediendo a un valor por el índice requiere una traducción entre el índice y su
     posición correspondiente en el búfer: <code>((cabecera + posición) % capacidad)</code>.
    </para>
   </section>
-<!-- }}} -->
-
-<section xml:id="ds-deque.strengths">
-    <title xmlns="http://docbook.org/ns/docbook">Fortalezas</title>
-    <para>
-        <simplelist>
-            <member>Soporta la sintaxis array (corchetes).</member>
-            <member>Utiliza menos memoria total que un &array; para el mismo número de valores.</member>
-            <member>Automáticamente libera la memoria asignada cuando su tamaño cae lo suficientemente bajo.</member>
-            <member>
-                <function>get</function>,
-                <function>set</function>,
-                <function>push</function>,
-                <function>pop</function>,
-                <function>shift</function>, y
-                <function>unshift</function> son todos O(1).
-            </member>
-        </simplelist>
+  <!-- }}} -->
+
+  <section xml:id="ds-deque.strengths">
+   <title xmlns="http://docbook.org/ns/docbook">Fortalezas</title>
+   <para>
+    <simplelist>
+     <member>Soporta la sintaxis array (corchetes).</member>
+     <member>Utiliza menos memoria total que un &array; para el mismo número de valores.</member>
+     <member>Automáticamente libera la memoria asignada cuando su tamaño cae lo suficientemente bajo.</member>
+     <member>
+      <function>get</function>,
+      <function>set</function>,
+      <function>push</function>,
+      <function>pop</function>,
+      <function>shift</function>, y
+      <function>unshift</function> son todos O(1).
+     </member>
+    </simplelist>
    </para>
-</section>
-
-<section xml:id="ds-deque.weaknesses">
-    <title xmlns="http://docbook.org/ns/docbook">Debilidades</title>
-    <para>
-        <simplelist>
-            <member>La capacidad debe ser una potencia de 2.</member>
-            <member>
-                <function>insert</function> y
-                <function>remove</function> son O(n).
-            </member>
-        </simplelist>
+  </section>
+
+  <section xml:id="ds-deque.weaknesses">
+   <title xmlns="http://docbook.org/ns/docbook">Debilidades</title>
+   <para>
+    <simplelist>
+     <member>La capacidad debe ser una potencia de 2.</member>
+     <member>
+      <function>insert</function> y
+      <function>remove</function> son O(n).
+     </member>
+    </simplelist>
    </para>
-</section>
+  </section>
 
   <section xml:id="ds-deque.synopsis">
    &reftitle.classsynopsis;
 
-<!-- {{{ Synopsis -->
+   <!-- {{{ Synopsis -->
    <classsynopsis>
     <ooclass><classname>Ds\Deque</classname></ooclass>
 
-<!-- {{{ Class synopsis -->
+    <!-- {{{ Class synopsis -->
     <classsynopsisinfo>
      <ooclass>
       <classname>Ds\Deque</classname>
@@ -81,9 +79,12 @@
      <oointerface>
       <interfacename>Ds\Sequence</interfacename>
      </oointerface>
+     <oointerface>
+      <interfacename>ArrayAccess</interfacename>
+     </oointerface>
     </classsynopsisinfo>
-<!-- }}} -->
-    <classsynopsisinfo role="comment">Constantes</classsynopsisinfo>
+    <!-- }}} -->
+    <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
@@ -96,11 +97,11 @@
      <xi:fallback/>
     </xi:include>
    </classsynopsis>
-<!-- }}} -->
+   <!-- }}} -->
 
   </section>
 
-<!-- {{{ Ds\Deque constants -->
+  <!-- {{{ Ds\Deque constants -->
   <section xml:id="ds-deque.constants">
    &reftitle.constants;
    <variablelist>
@@ -114,8 +115,31 @@
 
    </variablelist>
   </section>
-<!-- }}} -->
+  <!-- }}} -->
 
+  <section role="changelog">
+   &reftitle.changelog;
+   <para>
+    <informaltable>
+     <tgroup cols="2">
+      <thead>
+       <row>
+        <entry>&Version;</entry>
+        <entry>&Description;</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry>PECL ds 1.3.0</entry>
+        <entry>
+         La clase ahora implementa <classname>ArrayAccess</classname>.
+        </entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </informaltable>
+   </para>
+  </section>
 
  </partintro>
 

diff --git a/reference/ds/ds.hashable.xml b/reference/ds/ds.hashable.xml
@@ -1,12 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: da1b2b494ae55fa085f27bbd6b706e07675f8689 Maintainer: alditis Status: ready -->
+<!-- EN-Revision: ae6b3ce988ca175a4ca3a795bfd31639fc9e82fd Maintainer: alditis Status: ready -->
 <!-- Reviewed: no Maintainer: andresdzphp -->
 
 <phpdoc:classref xml:id="class.ds-hashable" 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 interface Hashable</title>
- <titleabbrev>Hashable</titleabbrev>
+ <titleabbrev>Ds\Hashable</titleabbrev>
 
  <partintro>
 
@@ -38,22 +37,14 @@
   <section xml:id="ds-hashable.synopsis">
    &reftitle.interfacesynopsis;
 
-<!-- {{{ Synopsis -->
-   <classsynopsis>
-    <ooclass><classname>Ds\Hashable</classname></ooclass>
-
-<!-- {{{ Class synopsis -->
-    <classsynopsisinfo>
-     <ooclass>
-      <classname>Ds\Hashable</classname>
-     </ooclass>
-    </classsynopsisinfo>
-<!-- }}} -->
+   <!-- {{{ Synopsis -->
+   <classsynopsis class="interface">
+    <oointerface><interfacename>Ds\Hashable</interfacename></oointerface>
 
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.ds-hashable')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
    </classsynopsis>
-<!-- }}} -->
+   <!-- }}} -->
 
   </section>
 

diff --git a/reference/ds/ds.map.xml b/reference/ds/ds.map.xml
@@ -1,12 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: da1b2b494ae55fa085f27bbd6b706e07675f8689 Maintainer: alditis Status: ready -->
+<!-- EN-Revision: 6ceccac7860f382f16ac1407baf54f656e85ca0b Maintainer: alditis Status: ready -->
 <!-- Reviewed: no Maintainer: andresdzphp -->
 
 <phpdoc:classref xml:id="class.ds-map" 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 Map</title>
- <titleabbrev>Map</titleabbrev>
+ <titleabbrev>Ds\Map</titleabbrev>
 
  <partintro>
 
@@ -61,9 +60,12 @@
      <oointerface>
       <interfacename>Ds\Collection</interfacename>
      </oointerface>
+     <oointerface>
+      <interfacename>ArrayAccess</interfacename>
+     </oointerface>
     </classsynopsisinfo>
 <!-- }}} -->
-    <classsynopsisinfo role="comment">Constantes</classsynopsisinfo>
+    <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
@@ -94,6 +96,29 @@
   </section>
 <!-- }}} -->
 
+  <section role="changelog">
+   &reftitle.changelog;
+   <para>
+    <informaltable>
+     <tgroup cols="2">
+      <thead>
+       <row>
+        <entry>&Version;</entry>
+        <entry>&Description;</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry>PECL ds 1.3.0</entry>
+        <entry>
+         La clase ahora implementa <classname>ArrayAccess</classname>.
+        </entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </informaltable>
+   </para>
+  </section>
 
  </partintro>
 

diff --git a/reference/ds/ds.pair.xml b/reference/ds/ds.pair.xml
@@ -1,12 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 73026aaaf86e4e3c993be889d5efde4b1c4fed6d Maintainer: alditis Status: ready -->
+<!-- EN-Revision: b2a26b15a817e66ca3f4fe945bd21444cfc5a567 Maintainer: alditis Status: ready -->
 <!-- Reviewed: no Maintainer: andresdzphp -->
 
 <phpdoc:classref xml:id="class.ds-pair" 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 Pair</title>
- <titleabbrev>Pair</titleabbrev>
+ <titleabbrev>Ds\Pair</titleabbrev>
 
  <partintro>
 
@@ -39,7 +38,12 @@
 <!-- }}} -->
 
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.ds-pair')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis)"/>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.ds-pair')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis)">
+     <xi:fallback/>
+    </xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.ds-pair')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])">
+     <xi:fallback/>
+    </xi:include>
    </classsynopsis>
 <!-- }}} -->
 

diff --git a/reference/ds/ds.vector.xml b/reference/ds/ds.vector.xml
@@ -1,12 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 73026aaaf86e4e3c993be889d5efde4b1c4fed6d Maintainer: alditis Status: ready -->
+<!-- EN-Revision: 6ceccac7860f382f16ac1407baf54f656e85ca0b Maintainer: alditis Status: ready -->
 <!-- Reviewed: no Maintainer: andresdzphp -->
 
 <phpdoc:classref xml:id="class.ds-vector" 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 Vector</title>
- <titleabbrev>Vector</titleabbrev>
+ <titleabbrev>Ds\Vector</titleabbrev>
 
  <partintro>
 
@@ -55,21 +54,22 @@
   <section xml:id="ds-vector.synopsis">
    &reftitle.classsynopsis;
 
-<!-- {{{ Synopsis -->
+   <!-- {{{ Synopsis -->
    <classsynopsis>
     <ooclass>
-        <classname>Ds\Vector</classname>
+     <classname>Ds\Vector</classname>
     </ooclass>
 
-<!-- {{{ Class synopsis -->
+    <!-- {{{ Class synopsis -->
     <classsynopsisinfo>
 
-    <ooclass><classname>Ds\Vector</classname></ooclass>
-    <oointerface><interfacename>Ds\Sequence</interfacename></oointerface>
+     <ooclass><classname>Ds\Vector</classname></ooclass>
+     <oointerface><interfacename>Ds\Sequence</interfacename></oointerface>
+     <oointerface><interfacename>ArrayAccess</interfacename></oointerface>
 
     </classsynopsisinfo>
-<!-- }}} -->
-    <classsynopsisinfo role="comment">Constantes</classsynopsisinfo>
+    <!-- }}} -->
+    <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
@@ -82,11 +82,11 @@
      <xi:fallback/>
     </xi:include>
    </classsynopsis>
-<!-- }}} -->
+   <!-- }}} -->
 
   </section>
 
-<!-- {{{ Ds\Vector constants -->
+  <!-- {{{ Ds\Vector constants -->
   <section xml:id="ds-vector.constants">
    &reftitle.constants;
    <variablelist>
@@ -100,8 +100,31 @@
 
    </variablelist>
   </section>
-<!-- }}} -->
+  <!-- }}} -->
 
+  <section role="changelog">
+   &reftitle.changelog;
+   <para>
+    <informaltable>
+     <tgroup cols="2">
+      <thead>
+       <row>
+        <entry>&Version;</entry>
+        <entry>&Description;</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry>PECL ds 1.3.0</entry>
+        <entry>
+         La clase ahora implementa <classname>ArrayAccess</classname>.
+        </entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </informaltable>
+   </para>
+  </section>
 
  </partintro>