sync with en rev

Author: leonardolara

appendices/migration84/new-features.xml

@@ -53,7 +53,7 @@ print $p->firstName; // Exibe "Pedro"
 $p->lastName = 'Pedroso';
 print $p->fullName; // Exibe "Pedro Pedroso"
 
-$p->fullName = "Pedro 'Pete' Pedroso"; // Lança Error: "Property Person::$fullName is read-only"
+$p->fullName = "Pedro 'Pedrão' Pedroso"; // Lança Error: "Property Person::$fullName is read-only"
 ]]>
     </programlisting>
    </informalexample>

appendices/migration85/other-changes.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 6b48f364497107ae46f926bfc99a4e3d9d546316 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: c7b445ec851969e669026cfa483b104ea2de5d95 Maintainer: leonardolara Status: ready -->
 <sect1 xml:id="migration85.other-changes">
  <title>Outras Alterações</title>
 
@@ -401,8 +401,9 @@
    <title>Núcleo</title>
 
    <simpara>
-    Adicionada a opção 'fatal_error_backtraces' para controlar se os erros fatais devem incluir
-    um rastreamento de pilha.
+    Adicionada a opção <link
+    linkend="ini.fatal-error-backtraces">fatal_error_backtraces</link> para
+    controlar se os erros fatais devem incluir um rastreamento de pilha.
     <!-- RFC: https://wiki.php.net/rfc/error_backtraces_v2 -->
    </simpara>
 

language-snippets.ent

@@ -852,6 +852,13 @@ para uma descrição dos <literal xmlns="http://docbook.org/ns/docbook">contexto
  </entry>
 </row>'>
 
+<!ENTITY return.type.true.84 '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.4.0</entry>
+ <entry>
+  O tipo do retorno agora é &true;; anteriormente, era <type>bool</type>.
+ </entry>
+</row>'>
+
 <!ENTITY return.type.true.85 '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.5.0</entry>
  <entry>

language/oop5/inheritance.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,mauricio,ABDALAZARD,ae -->
+<!-- EN-Revision: df78bd1d232f2cd8df673accf5ba0e280695639b Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,mauricio,ABDALAZARD,ae,leonardolara -->
  <sect1 xml:id="language.oop5.inheritance" xmlns="http://docbook.org/ns/docbook">
   <title>Herança de Objetos</title>
   <para>
@@ -57,7 +57,7 @@ class A {
     public int $prop;
 }
 class B extends A {
-    // Illegal: read-write -> readonly
+    // Ilegal: leitura-gravação -> somente-leitura
     public readonly int $prop;
 }
 ?>

language/predefined/attributes/returntypewillchange.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 77325b622f91355b118e8f3bc9ff940e8201f55d Maintainer: leonardolara Status: ready --><!-- CREDITS: adaiasmagdiel, leonardolara -->
+<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 0019a7e201442447fd746c2852d28ba839ed15ae Maintainer: leonardolara Status: ready --><!-- CREDITS: adaiasmagdiel, leonardolara -->
 <reference xml:id="class.returntypewillchange" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>O atributo ReturnTypeWillChange</title>
  <titleabbrev>ReturnTypeWillChange</titleabbrev>
@@ -7,15 +7,28 @@
 
   <section xml:id="returntypewillchange.intro">
    &reftitle.intro;
-   <para>
+   <simpara>
     A maioria dos métodos internos não finais agora requerem que os métodos substitutos declarem
     um tipo de retorno compatível, caso contrário, um aviso de descontinuação é emitido durante
-    a validação da herança.
+    a validação da herança. Isto introduz uma fase de tipo de retorno provisório:
+    o mecanismo emite uma nota de descontinuação em vez de um erro fatal quando os tipo de
+    retorno são incompatíveis, antes que sejam obrigatórios em uma versão futura.
     Caso o tipo de retorno não possa ser declarado para um método substituto devido
     a preocupação com compatibilidade entre versões do PHP,
     um atributo <code>#[\ReturnTypeWillChange]</code> pode ser adicionado para silenciar
     o aviso de descontinuação.
-   </para>
+   </simpara>
+
+   <warning>
+    <simpara>
+     O atributo <classname>ReturnTypeWillChange</classname> suprime
+     os avisos de descontinuação <emphasis>somente</emphasis> durante a fase de tipo de retorno provisório.
+     Ele não tem efeito ao substituir métodos definidos em classes definidas pelo usuário.
+     Assim que os métodos internos adotarem tipos estritos, a não correspondência em substituições de assinaturas
+     de métodos causará um erro fatal e este atributo não terá mais nenhum efeito.
+    </simpara>
+   </warning>
+
   </section>
 
   <section xml:id="returntypewillchange.synopsis">

language/types/boolean.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 4657c1173e6b3852cdc8db4fc64f380d10ebae0c Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, fabioluciano, geekcom, gilsonhenrique, marcosmarcolin, leonardolara -->
+<!-- EN-Revision: ee66d210fb1dd5799fbca9881c6ac2560a19579d Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, fabioluciano, geekcom, gilsonhenrique, marcosmarcolin, leonardolara -->
 <sect1 xml:id="language.types.boolean">
  <title>Booleanos</title>
 
@@ -19,7 +19,10 @@
    <programlisting role="php">
 <![CDATA[
 <?php
+
 $foo = True; // atribui o valor True para $foo
+
+var_dump($foo); // bool(true)
 ?>
 ]]>
    </programlisting>
@@ -35,6 +38,7 @@ $foo = True; // atribui o valor True para $foo
    <programlisting role="php">
 <![CDATA[
 <?php
+
 $acao = "mostrar_versao";
 $exibir_separadores = true;