Merge branch 'master' of github.com:php/doc-pt_br

php · Aug 5, 2023 · b7e07c2 · b7e07c2
2 parents d302a61 + 1545c99
commit b7e07c2
Show file tree

Hide file tree

Showing 7 changed files with 39 additions and 127 deletions.
diff --git a/reference/spl/arrayiterator.xml b/reference/spl/arrayiterator.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: bfef87dc15cdab5c438e716cd939b75e6ee5d4f5 Maintainer: ae Status: ready -->
+<!-- EN-Revision: 73c2b06c2a7baa614ea98022b1ad0529e3c7e680 Maintainer: ae Status: ready -->
 <phpdoc:classref xml:id="class.arrayiterator" 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>A classe ArrayIterator</title>
  <titleabbrev>ArrayIterator</titleabbrev>
@@ -10,8 +10,8 @@
   <section xml:id="arrayiterator.intro">
    &reftitle.intro;
    <para>
-    Este iterator permite remover e modificar valores e chaves quando iterando
-    arrays e objetos.
+    Permite a remoção de elementos, e a modificação de
+    chaves e valores enquanto iterando sobre arrays ou objetos.
    </para>
    <para>
     Quando você quiser iterar o mesmo array múltiplas vezes você precisa

diff --git a/reference/spl/book.xml b/reference/spl/book.xml
@@ -1,22 +1,20 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 6da224c94b124c477d5436071ade1f12aa2a6d80 Maintainer: diogo Status: ready -->
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: e579f9c9383e9dbc293343287086e988c17d0321 Maintainer: diogo Status: ae --><!-- CREDITS: diogo,ae -->
 
 <book xml:id="book.spl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <?phpdoc extension-membership="core" ?>
  <title>Standard PHP Library (SPL)</title>
  <titleabbrev>SPL</titleabbrev>
- 
+
  <preface xml:id="intro.spl">
   &reftitle.intro;
   <para>
-   SPL é uma coleção de interfaces e classes que servem para
-   resolver problemas padrões. 
+   A biblioteca padrão PHP (Standard PHP Library, SPL) é uma coleção de interfaces e classes desenhadas para resolver
+   problemas comuns.
+  </para>
+  <para>
+   A SPL provê um conjunto de estruturas de dados padrão, um conjunto de iteradores para percorrer objetos, um conjunto de interfaces, um conjunto de exceções, e algumas classes para trabalhar com sistema de arquivos, além de prover funções como <function>spl_autoload_register</function>
   </para>
-  <note>
-   <para>
-    Documentação de legado(antiga) gerada com o "doxygen" pode ser encontrada
-    aqui. <!-- Removed link to fix the build ~sobak 12/06/2016 -->
-   </para>
-  </note>
  </preface>
 
  &reference.spl.setup;

diff --git a/reference/spl/constants.xml b/reference/spl/constants.xml
@@ -1,71 +1,8 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 2fd3f0c96d9d221fe37109775af4df4cf949d5d8 Maintainer: diogo Status: ready -->
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: a0ae28d3bc85f927c22649ebd9a590b921534b7d Maintainer: ae Status: ready --><!-- CREDITS: diogo,ae -->
 <appendix xml:id="spl.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.constants;
  &extension.constants;
- <warning>
-  <para>
-   A SPL utiliza constantes de classes desde o PHP 5.1. Versões anteriores utilizam
-   constantes globais no formato <constant>RIT_LEAVES_ONLY</constant>.
-  </para>
- </warning>
- <variablelist>
-  <varlistentry>
-   <term>
-    <constant>RecursiveIteratorIterator::LEAVES_ONLY</constant>
-     (<type>integer</type>)
-   </term>
-   <listitem>
-    <simpara>
-
-    </simpara>
-   </listitem>
-  </varlistentry>
-  <varlistentry>
-   <term>
-    <constant>RecursiveIteratorIterator::SELF_FIRST</constant>
-     (<type>integer</type>)
-   </term>
-   <listitem>
-    <simpara>
-
-    </simpara>
-   </listitem>
-  </varlistentry>
-  <varlistentry>
-   <term>
-    <constant>RecursiveIteratorIterator::CHILD_FIRST</constant>
-     (<type>integer</type>)
-   </term>
-   <listitem>
-    <simpara>
-
-    </simpara>
-   </listitem>
-  </varlistentry>
-  <varlistentry>
-   <term>
-    <constant>CachingIterator::CALL_TOSTRING</constant>
-     (<type>integer</type>)
-   </term>
-   <listitem>
-    <simpara>
-
-    </simpara>
-   </listitem>
-  </varlistentry>
-  <varlistentry>
-   <term>
-    <constant>CachingIterator::CATCH_GET_CHILD</constant>
-     (<type>integer</type>)
-   </term>
-   <listitem>
-    <simpara>
-
-    </simpara>
-   </listitem>
-  </varlistentry>
- </variablelist>
 </appendix>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/spl/countable.xml b/reference/spl/countable.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4724b47c25b48f509355d27291aa6893ad0b40c0 Maintainer: none Status: ready -->
-
+<!-- EN-Revision: 9eb4a46bba05da229be4c8f7a3cb64702e1a2f95 Maintainer: ae Status: ready -->
 <phpdoc:classref xml:id="class.countable" 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>Interface Countable</title>
@@ -22,19 +21,15 @@
    &reftitle.interfacesynopsis;
 
 <!-- {{{ Synopsis -->
-   <classsynopsis>
-    <ooclass><classname>Countable</classname></ooclass>
-
-<!-- {{{ Class synopsis -->
-    <classsynopsisinfo>
-     <ooclass>
-      <classname>Countable</classname>
-     </ooclass>
-    </classsynopsisinfo>
-<!-- }}} -->
+   <classsynopsis class="interface">
+    <oointerface>
+     <interfacename>Countable</interfacename>
+    </oointerface>
 
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.countable')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.countable')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Countable'])">
+     <xi:fallback/>
+    </xi:include>
    </classsynopsis>
 <!-- }}} -->
 
@@ -45,7 +40,6 @@
  &reference.spl.entities.countable;
 
 </phpdoc:classref>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/spl/directoryiterator.xml b/reference/spl/directoryiterator.xml
@@ -1,6 +1,6 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 4724b47c25b48f509355d27291aa6893ad0b40c0 Maintainer: KinnCoelhoJulião Status: ready --><!-- CREDITS: felipe -->
-<phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.directoryiterator" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 071a588364ddef3af5e008b3d6213f98c617b5a0 Maintainer: ae Status: ready --><!-- CREDITS: felipe,KinnCoelhoJulião,ae -->
+<phpdoc:classref xml:id="class.directoryiterator" 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>A classe DirectoryIterator</title>
  <titleabbrev>DirectoryIterator</titleabbrev>
 
@@ -10,7 +10,8 @@
   <section xml:id="directoryiterator.intro">
    &reftitle.intro;
    <para>
-    A classe DirectoryIterator fornece uma interface simples para visualização de conteúdo de diretórios de arquivos.
+    A classe DirectoryIterator fornece uma interface simples para visualização de conteúdo
+    de sistemas de arquivos.
    </para>
   </section>
 <!-- }}} -->
@@ -20,9 +21,10 @@
 
 <!-- {{{ Synopsis -->
    <classsynopsis>
-    <ooclass><classname>DirectoryIterator</classname></ooclass>
+    <ooclass>
+     <classname>DirectoryIterator</classname>
+    </ooclass>
 
-<!-- {{{ Class synopsis -->
     <classsynopsisinfo>
      <ooclass>
       <classname>DirectoryIterator</classname>
@@ -33,20 +35,10 @@
       <classname>SplFileInfo</classname>
      </ooclass>
 
-     <oointerface>
-      <interfacename>Iterator</interfacename>
-     </oointerface>
-
-     <oointerface>
-      <interfacename>Traversable</interfacename>
-     </oointerface>
-
      <oointerface>
       <interfacename>SeekableIterator</interfacename>
      </oointerface>
-
     </classsynopsisinfo>
-<!-- }}} -->
 
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.directoryiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='DirectoryIterator'])">
@@ -56,9 +48,10 @@
      <xi:fallback/>
     </xi:include>
 
-    <classsynopsisinfo role="comment">Métodos</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.directoryiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[1])" />
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.directoryiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
+    <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.splfileinfo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='SplFileInfo'])">
+     <xi:fallback/>
+    </xi:include>
    </classsynopsis>
 
   </section>
@@ -82,7 +75,6 @@
  &reference.spl.entities.directoryiterator;
 
 </phpdoc:classref>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -103,4 +95,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-
diff --git a/reference/spl/reference.xml b/reference/spl/reference.xml
@@ -1,5 +1,5 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 2fd3f0c96d9d221fe37109775af4df4cf949d5d8 Maintainer: diogo Status: ready -->
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 14af302c9c0e561fa6f9cdd956268758ba9a89c5 Maintainer: diogo Status: ready -->
 
 <reference xml:id="ref.spl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>&Functions; da SPL</title>

diff --git a/reference/spl/setup.xml b/reference/spl/setup.xml
@@ -1,5 +1,5 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: diogo Status: ready -->
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: e579f9c9383e9dbc293343287086e988c17d0321 Maintainer: ae Status: ready --><!-- CREDITS: diogo,ae -->
 
 <chapter xml:id="spl.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
@@ -14,15 +14,7 @@
  <!-- {{{ Installation -->
  <section xml:id="spl.installation">
   &reftitle.install;
-  <para>
-   Esta extensão está disponível e é compilada por padrão no PHP 5.3.0.
-  </para>
-  <note>
-   <para>
-    A partir do PHP 5.3.0 esta extensão não pode mais ser desabilitada, 
-    sendo assim, ela estará sempre disponível.
-   </para>
-  </note>
+  &no.install;
  </section>
  <!-- }}} -->