sync with en rev

appendices/filters.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: ae Status: ready --><!-- CREDITS: narigone,diegopires,adiel,fibbarth,ae,leonardolara -->
+<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: leonardolara Status: ready --><!-- CREDITS: narigone,diegopires,adiel,fibbarth,ae,leonardolara -->
 <appendix xml:id="filters" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Lista de Filtros Disponíveis</title>
  <para>

appendices/ini.core.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 90787fda14dcb0976a9738423e6c6013c037d048 Maintainer: leonardolara Status: ready --><!-- CREDITS: ae,fibbarth,fabioluciano,rogeriopradoj,adiel,geekcom,rafaelbernard,leonardolara -->
+<!-- EN-Revision: a1ab750f296de54d79fe3749d5c9164b0593d803 Maintainer: leonardolara Status: ready --><!-- CREDITS: ae,fibbarth,fabioluciano,rogeriopradoj,adiel,geekcom,rafaelbernard,leonardolara -->
 
  <section xml:id="ini.core" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Descrição das principais diretivas do &php.ini;</title>
@@ -203,11 +203,12 @@
       </term>
       <listitem>
        <simpara>
-        Esta diretiva permite desabilitar certas funções.
+        Esta diretiva permite que certas funções sejam desabilitadas.
         Ela recebe uma lista de nomes de funções separadas por vírgula.
-        A partir do PHP 8.0.0, desabilitar uma função remove sua definição
+        A partir do PHP 8.0.0, desabilitar uma função remove sua definição,
         permitindo sua redefinição no nível do usuário.
-        Antes do PHP 8.0.0, desabilitar uma função apenas evitava que a função fosse chamada.
+        Antes do PHP 8.0.0, desabilitar uma função apenas evitava que
+        a função fosse chamada.
        </simpara>
        <simpara>
         Apenas <link linkend="functions.internal">funções internas</link> podem
@@ -229,7 +230,7 @@
       </term>
       <listitem>
        <para>
-        Esta diretiva permite desabilitar certas classes.
+        Esta diretiva permite que certas classes sejam desabilitadas.
         Ela recebe uma lista de nomes de classes separadas por vírgula.
         Desabilitar uma classe apenas impede que ela seja instanciada.
        </para>

appendices/migration70/incompatible/error-handling.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 44b298ee5daf7c79a8e63c7e80ffe65232822838 Maintainer: fabioluciano Status: ready --><!-- CREDITS: fabioluciano -->
+<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,leonardolara -->
 
 <sect2 xml:id="migration70.incompatible.error-handling">
   <title>Modificações na manipulação de erros e exceções</title>
@@ -38,9 +38,9 @@
   </para>
 
   <para>
-   Se o manipulador precisa trabalhar com o PHP 5 e 7, você deve remover a
-   declaração de tipo do manipulador, enquanto que o código a migrar
-   para funcionar exclusivamente no PHP 7, pode simplesmente trocar a declaração de tipo
+   Se o manipulador precisa funcionar com PHP 5 e 7, a declaração de
+   tipo do manipulador deve ser removida, enquanto que o código que está sendo migrado
+   para funcionar exclusivamente no PHP 7 pode simplesmente substituir a declaração de tipo
    <classname>Exception</classname> por
    <classname>Throwable</classname>.
   </para>
@@ -50,14 +50,14 @@
 <![CDATA[
 <?php
 // Código da era PHP 5 que não irá funcionar.
-function handler(Exception $e) { ... }
+function handler(Exception $e) { /* ... */ }
 set_exception_handler('handler');
 
 // Compatível com PHP 5 e 7.
-function handler($e) { ... }
+function handler($e) { /* ... */ }
 
 // Somente PHP 7.
-function handler(Throwable $e) { ... }
+function handler(Throwable $e) { /* ... */ }
 ?>
 ]]>
    </programlisting>

appendices/migration74/new-features.xml

@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8d1a5d2d15df15cc5cbc7f96cdc083b8fe49366e Maintainer: geekcom Status: ready --><!-- CREDITS: geekcom -->
+<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: leonardolara Status: ready --><!-- CREDITS: geekcom,leonardolara -->
 
 <sect1 xml:id="migration74.new-features" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Novos Recursos</title>
 
  <sect2 xml:id="migration74.new-features.core">
-  <title>PHP Core</title>
+  <title>Núcleo do PHP</title>
 
   <sect3 xml:id="migration74.new-features.core.typed-properties">
    <title>Propriedades tipadas</title>
@@ -314,10 +314,14 @@ $fruits = ['banana', 'orange', ...$parts, 'watermelon'];
 <![CDATA[
 <?php
 // Retorna um array contendo todo o estado necessário do objeto.
-public function __serialize(): array;
+public function __serialize(): array
+{
+}
 
 // Restaura o estado do objeto a partir do array de dados fornecido.
-public function __unserialize(array $data): void;
+public function __unserialize(array $data): void
+{
+}
 ?>
 ]]>
      </programlisting>

appendices/migration84/new-features.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 4edd2166e1121cd17ae942458baa532edf4d70e1 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: leonardolara Status: ready -->
 <sect1 xml:id="migration84.new-features">
  <title>Novos Recursos</title>
 
@@ -108,7 +108,7 @@ class Example
 
 $initializer = static function (Example $ghost): void {
     // Busca dados ou dependências
-    $data = ...;
+    $data = getData();
     // Inicializa
     $ghost->__construct($data);
 };

language/control-structures/alternative-syntax.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a41057cbdf053fd8c3a3bec6f1bbf113ffec8e42 Maintainer: ae Status: ready --><!-- CREDITS: diegopires,fabioluciano,ae -->
+<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: leonardolara Status: ready --><!-- CREDITS: diegopires,fabioluciano,ae,leonardolara -->
 
 <sect1 xml:id="control-structures.alternative-syntax"  xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Sintaxe Alternativa para estruturas de controle</title>
@@ -68,7 +68,7 @@ endif;
 <![CDATA[
 <?php switch ($foo): ?>
     <?php case 1: ?>
-    ...
+    // ...
 <?php endswitch; ?>
 ]]>
    </programlisting>

language/control-structures/elseif.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: bbaf4fea6946bf6d0b67573d5f2f96c5a2c5d678 Maintainer: lhsazevedo Status: ready --><!-- CREDITS: diegopires,fabioluciano,geekcom,lhsazevedo -->
+<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: leonardolara Status: ready --><!-- CREDITS: diegopires,fabioluciano,geekcom,lhsazevedo,leonardolara -->
 
 <sect1 xml:id="control-structures.elseif" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>elseif/else if</title>
@@ -74,8 +74,14 @@ if ($a > $b):
 else if ($a == $b): // Não irá compilar.
     echo "A linha acima causa um erro de análise.";
 endif;
+]]>
+   </programlisting>
+  </informalexample>
 
-
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php
 /* Método Correto: */
 if ($a > $b):
     echo $a." é maior que ".$b;

language/control-structures/match.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e50047b76fc0be5a2345a0b7c34979e3077e8580 Maintainer: leonardolara Status: ready --><!-- CREDITS: lhsazevedo, leonardolara -->
+<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: leonardolara Status: ready --><!-- CREDITS: lhsazevedo, leonardolara -->
 
 <sect1 xml:id="control-structures.match" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>match</title>
@@ -127,19 +127,20 @@ string(11) "Adolescente"
 
  <para>
   Assim como as declarações <literal>switch</literal>, expressões
-  <literal>match</literal> são executadas braço de correspondência por braço de correspondência.
+  <literal>match</literal> são executadas a cada ramo de correspondência.
   No início, nenhum código é executado.
   A expressões condicionais só são avaliadas se todas as expressões condicionais
   anteriores não corresponderem à expressão sujeito.
   Apenas a expressão de retorno pertencente à expressão condicional
   de correspondência será avaliada.
+  Por exemplo:
   <informalexample>
    <programlisting role="php">
 <![CDATA[
 <?php
 $resultado = match ($x) {
-    foo() => ...,
-    $this->bar() => ..., // $this->bar() não é chamado se foo() === $x
+    foo() => 'value',
+    $this->bar() => 'value', // $this->bar() não é chamado se foo() === $x
     $this->baz => beep(), // beep() não é chamado a não ser que $x === $this->baz
     // etc.
 };

language/enumerations.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: f4f96ef8b2a95283c92ea2183fe1dedf06f3ad22 Maintainer: leonardolara Status: ready --><!-- CREDITS: lhsazevedo,ae,ABDALAZARD,leonardolara -->
+<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 7541512acf899391b68c3b6bae66a4fcc65e6c4e Maintainer: leonardolara Status: ready --><!-- CREDITS: lhsazevedo,ae,ABDALAZARD,leonardolara -->
  <chapter xml:id="language.enumerations" xmlns="http://docbook.org/ns/docbook">
   <title>Enumerações</title>
   <sect1 xml:id="language.enumerations.overview">
@@ -822,7 +822,7 @@ function quux(ErrorCode $errorCode)
     // Nesse primeiro momento, esse código prevê todos os casos
     match ($errorCode) {
         ErrorCode::SOMETHING_BROKE => true,
-    }
+    };
 }
 
 ?>

language/oop5/autoload.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 7befd9af043386158ef9080723eb18e03f0625c7 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, amandavale, machado, fabioluciano, lhsazevedo, leonardolara -->
+<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, amandavale, machado, fabioluciano, lhsazevedo, leonardolara -->
  <sect1 xml:id="language.oop5.autoload" xmlns="http://docbook.org/ns/docbook">
   <title>Autocarregamento de Classes</title>
   <para>
@@ -95,7 +95,7 @@ Fatal error: Interface 'ITest' not found in ...
 <?php
 require __DIR__ . '/vendor/autoload.php';
 
-$uuid = new Ramsey\Uuid\Uuid::uuid7();
+$uuid = Ramsey\Uuid\Uuid::uuid7();
 
 echo "Gerado novo UUID -> ", $uuid->toString(), "\n";
 ?>