sync with en rev

2026-03-23 22:52:12 +01:00 · 2024-11-24 21:58:02 -03:00
parent 528008279b
commit 1009bd71de
12 changed files with 97 additions and 58 deletions
--- a/language-snippets.ent
+++ b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8b502f81f951a1af64396b69823f7a35b7637541 Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
+<!-- EN-Revision: 9a5b92a30888d6423db112f07a9b344cf6fc4891 Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->

 <!ENTITY installation.enabled.disable 'Esta extensão está habilitada por padrão. Ela pode ser desabilitada usando a seguinte opção em tempo de compilação: '>

@@ -205,8 +205,8 @@ e informações sobre quaisquer variáveis predefinidas que eles possam
 fornecer.</simpara></tip>'>

 <!ENTITY tip.fopen-wrapper.stat '<tip xmlns="http://docbook.org/ns/docbook"><simpara>A partir do PHP 5.0.0, esta função
-também pode ser usada com <emphasis>alguns</emphasis> wrappers URL. Consulte os
-<xref linkend="wrappers"/> para determinar quais wrappers suportam
+também pode ser usada com <emphasis>alguns</emphasis> empacotadores de URL. Consulte os
+<xref linkend="wrappers"/> para determinar quais empacotadores suportam
 a família de funções <function>stat</function>.</simpara></tip>'>

 <!ENTITY tip.ob-capture '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Assim como qualquer coisa que envia
@@ -2071,6 +2071,10 @@ para esta extensão <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym
 <!ENTITY pecl.moved-ver 'Esta extensão foi movida para o repositório &link.pecl;
 e não é mais distribuída com o PHP desde a versão '>

+<!ENTITY warn.pecl.unmaintained '<warning xmlns="http://docbook.org/ns/docbook">
+ <simpara>Esta extensão está <emphasis>sem manutenção</emphasis>.</simpara>
+</warning>'>
+
 <!-- PGSQL entities -->

 <!ENTITY pgsql.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Uma instância de <classname>PgSql\Connection</classname>.</para>'>
--- a/reference/filesystem/functions/glob.xml
+++ b/reference/filesystem/functions/glob.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fdd2aca71cfb2af77e365633a57e79e22bc1786e Maintainer: diogo Status: ready --><!-- CREDITS: galvao,leonardolara -->
+<!-- EN-Revision: 5fb1bb4a70dc9cf2538d9a78f423579b805137b4 Maintainer: leonardolara Status: ready --><!-- CREDITS: diogo,galvao,leonardolara -->
 <refentry xml:id="function.glob" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
 <refnamediv>
  <refname>glob</refname>
-  <refpurpose>Acha caminhos que combinam com um padrão</refpurpose>
+  <refpurpose>Encontra caminhos que combinam com uma expressão</refpurpose>
 </refnamediv>

 <refsect1 role="description">
@@ -15,10 +15,17 @@
  </methodsynopsis>
  <para>
   A função <function>glob</function> procura por todos os caminhos
-   que combinem com o padrão <parameter>pattern</parameter> de acordo
+   que correspondem à expressão em <parameter>pattern</parameter> de acordo
   com as regras usadas pela função glob() da libc, que é semelhante
   às regras usadas por shells comuns.
  </para>
+  <simpara>
+   O comportamento em sistemas Unix e macOS é determinado pela implementação
+   de glob() no sistema. No Windows, é usada uma implementação que está em conformidade
+   com a definição POSIX 1003.2 para glob() e inclui
+   uma extensão para lidar com a convenção <literal>[!...]</literal>
+   para negar um intervalo.
+  </simpara>
 </refsect1>

 <refsect1 role="parameters">
@@ -78,13 +85,9 @@
  <para>
   Retorna um array contendo os arquivos/diretórios que corresponderam, um array
   vazio se nenhum arquivo correspondeu ou &false; em caso de erro.
+   A menos que <literal>GLOB_NOSORT</literal> tenha sido usada, os nomes serão
+   ordenados alfabeticamente e numericamente.
  </para>
-  <note>
-   <para>
-    Em alguns sistemas é impossível distinguir entre resultado vazio ou um
-    erro.
-   </para>
-  </note>
 </refsect1>

 <refsect1 role="examples">
@@ -110,6 +113,30 @@ foreach (glob("*.txt") as $arquivo) {
 tamanho de funclist.txt 44686
 tamanho de funcsummary.txt 267625
 tamanho de quickref.txt 137820
+]]>
+    </screen>
+   </example>
+   <example>
+    <title>
+     Exemplo com uma expressão mais complexa
+    </title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+foreach (glob("caminho/*/*.{txt,md}", \GLOB_BRACE) as $filename) {
+    echo "$filename\n";
+}
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+caminho/docs/mailinglist-rules.md
+caminho/docs/README.md
+caminho/docs/release-process.md
+caminho/pear/install-pear.txt
+caminho/Zend/README.md
 ]]>
    </screen>
   </example>
--- a/reference/gmagick/book.xml
+++ b/reference/gmagick/book.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 9a5b92a30888d6423db112f07a9b344cf6fc4891 Maintainer: leonardolara Status: ready -->
+<!-- State: experimental -->

 <book xml:id="book.gmagick" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <?phpdoc extension-membership="pecl" ?>
@@ -9,6 +10,7 @@
 <preface xml:id="intro.gmagick">
  &reftitle.intro;
  <para>
+   &warn.experimental;
   Gmagick é uma extensão PHP para criar, modificar e obter metainformações de imagens usando a API GraphicsMagick.
  </para>
  <para>
--- a/reference/imagick/book.xml
+++ b/reference/imagick/book.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 10a34d49b54eacd49d481fea5203378b04796bc3 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: 9a5b92a30888d6423db112f07a9b344cf6fc4891 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <!-- State: experimental -->

 <book xml:id="book.imagick" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -11,6 +11,7 @@
 <preface xml:id="intro.imagick">
  &reftitle.intro;
  <para>
+   &warn.experimental;
   Imagick é uma extensão PHP nativa para criar e modificar imagens usando a
   API ImageMagick.
  </para>
--- a/reference/mqseries/book.xml
+++ b/reference/mqseries/book.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 9a5b92a30888d6423db112f07a9b344cf6fc4891 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- State: experimental -->

 <book xml:id="book.mqseries" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <?phpdoc extension-membership="pecl" ?>
@@ -8,10 +9,11 @@
 <!-- {{{ preface -->
 <preface xml:id="intro.mqseries">
  &reftitle.intro;
-  <simpara>
+  <para>
+   &warn.experimental;
   Esta extensão visa fornecer uma interface para comunicação com os
   gerenciadores de filas da série WebSphere MQ da IBM.
-  </simpara>
+  </para>
  <simpara>
   A interface imita a interface do cliente C-API da série WebSphere MQ o mais
   próximo possível. Usando as mesmas convenções de nomenclatura e possibilidades da
--- a/reference/recode/book.xml
+++ b/reference/recode/book.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 9a5b92a30888d6423db112f07a9b344cf6fc4891 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- State: deprecated -->

 <book xml:id="book.recode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <?phpdoc extension-membership="pecl" ?>
@@ -10,6 +11,7 @@
 <preface xml:id="intro.recode">
  &reftitle.intro;
  <para>
+   &warn.pecl.unmaintained;
   Este módulo contém uma interface para a biblioteca GNU Recode. A biblioteca GNU
   Recode converte arquivos entre vários conjuntos de caracteres codificados e
   codificações de superfície. Quando isso não pode ser alcançado com exatidão, pode eliminar
--- a/reference/rnp/book.xml
+++ b/reference/rnp/book.xml
@@ -1,4 +1,5 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9a5b92a30888d6423db112f07a9b344cf6fc4891 Maintainer: leonardolara Status: ready -->
+<!-- State: experimental -->
 <book xml:id="book.rnp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <?phpdoc extension-membership="pecl" ?>
 <title>Rnp</title>
@@ -7,6 +8,7 @@
 <preface xml:id="intro.rnp">
  &reftitle.intro;
  <para>
+   &warn.experimental;
   Este módulo permite usar a biblioteca <link
   xlink:href="&url.rnp;">RNP</link>.
   RNP é uma biblioteca OpenPGP em C++ de alto
--- a/reference/ui/book.xml
+++ b/reference/ui/book.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 9a5b92a30888d6423db112f07a9b344cf6fc4891 Maintainer: leonardolara Status: ready -->
+<!-- State: experimental -->

 <book xml:id="book.ui" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <?phpdoc extension-membership="pecl" ?>
@@ -9,7 +10,10 @@
 <preface xml:id="intro.ui">
  &reftitle.intro;
  <para>
-   Esta extensão encapsula a biblioteca libui para fornecer uma API orientada a objetos para o desenvolvimento multi-plataforma de interfaces de usuário com sensação e visual nativos.
+   &warn.experimental;
+   Esta extensão encapsula a biblioteca <link xlink:href="&url.ui.libui;">libui</link>
+   para fornecer uma API orientada a objetos para o desenvolvimento multi-plataforma
+   de interfaces de usuário com sensação e visual nativos.
  </para>
 </preface>

--- a/reference/xsl/xsltprocessor/setparameter.xml
+++ b/reference/xsl/xsltprocessor/setparameter.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 03817004058a9d8d847626ce6582342dd2645e48 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,leonardolara -->
+<!-- EN-Revision: 68e72e60ba0b318e21bb8b4a87abba35adb891c8 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,leonardolara -->
 <refentry xml:id="xsltprocessor.setparameter" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>XSLTProcessor::setParameter</refname>
@@ -70,6 +70,14 @@
  </para>
 </refsect1>

+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Lança uma exceção <exceptionname>ValueError</exceptionname> se qualquer argumento
+   contiver bytes nulos.
+  </simpara>
+ </refsect1>
+
 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
@@ -81,6 +89,13 @@
     </row>
    </thead>
    <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Agora lança uma exceção <exceptionname>ValueError</exceptionname> se qualquer argumento
+       contiver bytes nulos ao invés de truncar silenciosamente.
+      </entry>
+     </row>
     <row>
      <entry>8.4.0</entry>
      <entry>
--- a/reference/zmq/book.xml
+++ b/reference/zmq/book.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: ae Status: ready -->
+<!-- EN-Revision: 9a5b92a30888d6423db112f07a9b344cf6fc4891 Maintainer: ae Status: ready --><!-- CREDITS: ae,leonardolara -->
+<!-- State: experimental -->

 <book xml:id="book.zmq" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <?phpdoc extension-membership="pecl" ?>
@@ -9,6 +10,7 @@
 <preface xml:id="intro.zmq">
  &reftitle.intro;
  <para>
+   &warn.experimental;
   "ØMQ é uma biblioteca que permite a criação e implementação rápida de aplicações baseadas na troca rápida de mensagens." --0MQ Website
  </para>
  <para>
--- a/reference/zmq/configure.xml
+++ b/reference/zmq/configure.xml
@@ -1,33 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ab56145968b47219d62cf76870c9b5698ac8f956 Maintainer: leonardolara Status: ready -->
-
-<section xml:id="zmq.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- &reftitle.install;
-
- <para>
-  &pecl.info;
-  <link xlink:href="&url.pecl.package;zmq">&url.pecl.package;zmq</link>
- </para>
-</section>
-
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
-->
--- a/reference/zmq/setup.xml
+++ b/reference/zmq/setup.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ab56145968b47219d62cf76870c9b5698ac8f956 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 9a5b92a30888d6423db112f07a9b344cf6fc4891 Maintainer: leonardolara Status: ready -->

 <chapter xml:id="zmq.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.setup;
@@ -9,7 +9,18 @@
  <para>
   A extensão ZMQ requer uma versão igual ou superior a versão 2.0.7 da biblioteca 0MQ. A biblioteca 0MQ pode ser adquirida em <link xlink:href="&url.zeromq;area:download">&url.zeromq;area:download</link>.
  </para>
-  &reference.zmq.configure;
+ </section>
+
+ <section xml:id="zmq.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+  &reftitle.install;
+
+  <para>
+   &pecl.info.dead;
+   <link xlink:href="&url.pecl.package;zmq">&url.pecl.package;zmq</link>
+  </para>
+  <para>
+   &pecl.windows.download.avail;
+  </para>
 </section>
 </chapter>