Update to outdated files and inclusion of untranslated files (#349)

* Update to language-snippets.ent * Update to migration83/other-changes * Update to httpresponseheader.xml * Inclusion of new files at language/predefined * Including new translations missing in language/predefined/* --------- Co-authored-by: LEONARDO LARA RODRIGUES <[email protected]>
php · Nov 14, 2023 · fa170e1 · fa170e1
1 parent 2de38b6
commit fa170e1
Show file tree

Hide file tree

Showing 65 changed files with 4,251 additions and 4 deletions.
diff --git a/appendices/migration83/other-changes.xml b/appendices/migration83/other-changes.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 224e2a46765308809dfc560371ed1e119c16a046 Maintainer: marcosmarcolin Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 1b964cf138931212dd082503f48de084d9d07c2b Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin,leonardolara -->
 <sect1 xml:id="migration83.other-changes" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Outras mudanças</title>
 
@@ -386,6 +386,15 @@
     será lançado.
    </para>
 
+   <para>
+    <function>proc_open</function> retorna falso se o array <parameter>$command</parameter>
+    for inválido, em vez de um objeto do tipo resource que produz um aviso posteriormente.
+    Este já era o comportamento no Windows mas agora também é aplicável se a implementação
+    posix_spawn estiver em uso (maioria das plataformas Linux, BSD e MacOS). Ainda existem
+    algumas plataformas antigas onde este comportamento não foi alterado já que posix_spawn não
+    é suportado nelas.
+   </para>
+
    <para>
     <function>array_sum</function> e <function>array_product</function> agora
     emitem um aviso quando os valores no array não podem ser convertidos para int ou float.

diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ca426e50716c122e6fed8009369792e98d7c57b8 Maintainer: adiel Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara -->
+<!-- EN-Revision: 7b1704c9a9d3100e85b47568cb0f06ee2122db08 Maintainer: adiel Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara -->
 
 <!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: '>
 
@@ -1348,6 +1348,38 @@ seja inserido, por exemplo, com <function xmlns="http://docbook.org/ns/docbook">
   das <link linkend="libxml.constants">constantes de opções da libxml</link>.
 </para>'>
 
+<!ENTITY dom.errors.hierarchy.parent '<varlistentry xmlns="http://docbook.org/ns/docbook">
+ <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
+  <listitem>
+  <para>
+    Emitido se o pai é de um tipo que não permite filhos do
+    tipo de um dos <parameter>nodes</parameter> informados, ou se o nó a ser
+    inserido é um dos ancestrais deste nó, ou este próprio nó.
+  </para>
+ </listitem>
+</varlistentry>'>
+
+<!ENTITY dom.errors.hierarchy.self '<varlistentry xmlns="http://docbook.org/ns/docbook">
+ <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
+  <listitem>
+  <para>
+    Emitido se este nó é de um tipo que não permite filhos do
+    tipo de um dos <parameter>nodes</parameter> informados, ou se o nó a ser
+    inserido é um dos ancestrais deste nó, ou o próprio nó.
+  </para>
+ </listitem>
+</varlistentry>'>
+
+<!ENTITY dom.errors.wrong_document '<varlistentry xmlns="http://docbook.org/ns/docbook">
+ <term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
+  <listitem>
+  <para>
+    Emitido se um dos <parameter>nodes</parameter> informados foi criado a partir de um documento
+    diferente daquele que criou este nó.
+  </para>
+ </listitem>
+</varlistentry>'>
+
 <!-- FileSystem entities -->
 <!ENTITY fs.emits.warning.on.failure '<para xmlns="http://docbook.org/ns/docbook">
 Em caso de falha, um <constant>E_WARNING</constant> será emitido.

diff --git a/language/predefined/allowdynamicproperties/construct.xml b/language/predefined/allowdynamicproperties/construct.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 681fd84dbdef6c0f8fe92848677d95a993b66143 Maintainer: _ Status: ready --><!-- CREDITS: leonardolara -->
+<refentry xml:id="allowdynamicproperties.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>AllowDynamicProperties::__construct</refname>
+  <refpurpose>Constrói uma nova instância do atributo AllowDynamicProperties</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <constructorsynopsis role="AllowDynamicProperties">
+   <modifier>public</modifier> <methodname>AllowDynamicProperties::__construct</methodname>
+   <void/>
+  </constructorsynopsis>
+  <para>
+   Constrói uma nova instância de <classname>AllowDynamicProperties</classname>.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+</refentry>
+ <!-- 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
+ -->
diff --git a/language/predefined/argumentcounterror.xml b/language/predefined/argumentcounterror.xml
@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: _ Status: ready --><!-- CREDITS: leonardolara -->
+<phpdoc:exceptionref xml:id="class.argumentcounterror" 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>ArgumentCountError</title>
+ <titleabbrev>ArgumentCountError</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ Error intro -->
+  <section xml:id="argumentcounterror.intro">
+   &reftitle.intro;
+   <para>
+    <ooclass><classname>ArgumentCountError</classname></ooclass> é disparado
+    quando parâmetros insuficientes são passados para uma função ou método definidos pelo usuário.
+   </para>
+   <para>
+    Este erro também é disparado quando argumentos demais são passados para uma
+    função interna não variável.
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="argumentcounterror.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis class="class">
+    <ooexception>
+     <exceptionname>ArgumentCountError</exceptionname>
+    </ooexception>
+
+    <ooclass>
+     <modifier>extends</modifier>
+     <classname>TypeError</classname>
+    </ooclass>
+
+    <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
+     <xi:fallback/>
+    </xi:include>
+
+    <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Error'])">
+     <xi:fallback/>
+    </xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Error'])">
+     <xi:fallback/>
+    </xi:include>
+   </classsynopsis>
+
+<!-- }}} -->
+
+  </section>
+ </partintro>
+</phpdoc:exceptionref>
+<!-- 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
+-->
diff --git a/language/predefined/backedenum.xml b/language/predefined/backedenum.xml
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9eb4a46bba05da229be4c8f7a3cb64702e1a2f95 Maintainer: _ Status: ready --><!-- CREDITS: leonardolara -->
+<phpdoc:classref xml:id="class.backedenum" 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 interface BackedEnum</title>
+ <titleabbrev>BackedEnum</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ BackedEnum intro -->
+  <section xml:id="backedenum.intro">
+   &reftitle.intro;
+   <para>
+    A interface <classname>BackedEnum</classname> é aplicada automaticamente pelo motor do PHP a
+    enumerações lastreadas. Não pode ser implementada por classes definidas pelo usuário.
+    Enumerações não podem substituir seu métodos, já que as implementações padrões são fornecidas
+    pelo motor. Está disponível apenas para verificações de tipo.
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="backedenum.synopsis">
+   &reftitle.interfacesynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis class="interface">
+    <oointerface>
+     <interfacename>BackedEnum</interfacename>
+    </oointerface>
+
+    <oointerface>
+     <modifier>extends</modifier>
+     <interfacename>UnitEnum</interfacename>
+    </oointerface>
+
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.backedenum')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='BackedEnum'])">
+     <xi:fallback/>
+    </xi:include>
+
+    <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.unitenum')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='UnitEnum'])">
+     <xi:fallback/>
+    </xi:include>
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &language.predefined.backedenum.from;
+ &language.predefined.backedenum.tryfrom;
+
+</phpdoc:classref>
+<!-- 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
+-->
diff --git a/language/predefined/backedenum/from.xml b/language/predefined/backedenum/from.xml
@@ -0,0 +1,110 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9c74079f12d67cabb52c124d761f48275417d7eb Maintainer: _ Status: ready --><!-- CREDITS: leonardolara -->
+<refentry xml:id="backedenum.from" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>BackedEnum::from</refname>
+  <refpurpose>Mapeia um escalar para uma instância de enumeração</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis role="BackedEnum">
+   <modifier>public</modifier> <modifier>static</modifier> <type>static</type><methodname>BackedEnum::from</methodname>
+   <methodparam><type class="union"><type>int</type><type>string</type></type><parameter>value</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   O método <methodname>from</methodname> traduz uma <type>string</type> ou um <type>int</type>
+   para o caso correspondente do Enum, se houver. Se não houver caso correspondente definido, ele irá emitir
+   um <classname>ValueError</classname>.
+  </para>
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>value</parameter></term>
+    <listitem>
+     <para>
+      O valor escalar a ser mapeado para um caso de enumeração.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Uma instância de caso para esta enumeração.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Uso Básico</title>
+   <para>
+    O exemplo a seguir ilustra como os casos de enumeração são retornados.
+   </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+enum Suit: string
+{
+    case Hearts = 'H';
+    case Diamonds = 'D';
+    case Clubs = 'C';
+    case Spades = 'S';
+}
+
+$h = Suit::from('H');
+
+var_dump($h);
+
+$b = Suit::from('B');
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+enum(Suit::Hearts)
+
+Fatal error: Uncaught ValueError: "B" is not a valid backing value for enum "Suit" in /file.php:15
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><methodname>UnitEnum::cases</methodname></member>
+    <member><methodname>BackedEnum::tryFrom</methodname></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
+</refentry>
+<!-- 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
+-->