sync with en rev

Author: leonardolara

language-snippets.ent

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c6fb604f39a0fa7bf1ae872064b2a3a24f23d855 Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
+<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 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: '>
 
@@ -31,6 +31,19 @@ fortemente desencorajado.</simpara></warning>'>
  </para>
 </caution>'>
 
+<!ENTITY caution.mt19937-global-state '<caution xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+  Esta função usa a instância global do Mt19937 (“Mersenne Twister”) como a fonte de aleatoriedade a por isso compartilha seu estado com todas as outras funções que usam o Mt19937 global.
+  Usar qualquer uma destas funções avança a sequência para <emphasis>todas</emphasis> as outras funções, independentemente do escopo.
+ </simpara>
+ <simpara>
+  Gerar sequências repetíveis ao semear <function>mt_srand</function> ou <function>srand</function> com um valor conhecido também gerará saída repetível desta função.
+ </simpara>
+ <simpara>
+  Prefira usar métodos de <classname>Random\Randomizer</classname> em todo código novo.
+ </simpara>
+</caution>'>
+
 <!ENTITY caution.mt19937-tiny-seed '<caution xmlns="http://docbook.org/ns/docbook">
  <para>
   Como o mecanismo Mt19937 (“Mersenne Twister”) aceita apenas um único inteiro de 32 bits como

reference/array/functions/array-rand.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 4a1dedc24b1e085f298ab1d5dadefe306373691b Maintainer: ae Status: ready --><!-- CREDITS: narigone,lucasr,felipe,ae,marquesdanielb,leonardolara -->
+<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 Maintainer: leonardolara Status: ready --><!-- CREDITS: narigone,lucasr,felipe,ae,marquesdanielb,leonardolara -->
 <refentry xml:id="function.array-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>array_rand</refname>
@@ -17,6 +17,7 @@
    chave (ou chaves) do itens selecionados.
   </para>
   &caution.cryptographically-insecure;
+  &caution.mt19937-global-state;
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;

reference/array/functions/shuffle.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f781803449007bb0e3a96c693e0eee067f7eb466 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,lucasr,leonardolara -->
+<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,lucasr,leonardolara -->
 <refentry xml:id="function.shuffle" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>shuffle</refname>
@@ -15,6 +15,7 @@
    Essa função embaralha (mistura de forma aleatória os elementos de) um array.
   </para>
   &caution.cryptographically-insecure;
+  &caution.mt19937-global-state;
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;

reference/random/functions/mt-rand.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0a5e7b12546b62a611a0cbc7105e617ab96fbcbd Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
+<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
 <refentry xml:id="function.mt-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>mt_rand</refname>
@@ -35,6 +35,7 @@
    15)</literal>.
   </simpara>
   &caution.cryptographically-insecure;
+  &caution.mt19937-global-state;
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;

reference/random/functions/rand.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a2a3f3525979535f7f8c81b79315391f2fdc285b Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
+<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
 <refentry xml:id="function.rand" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>rand</refname>
@@ -25,6 +25,7 @@
    15)</literal>.
   </simpara>
   &caution.cryptographically-insecure;
+  &caution.mt19937-global-state;
   <note>
    <simpara>
     Anteriormente ao PHP 7.1.0, <function>getrandmax</function> resultava em apenas 32767 em algumas

reference/strings/functions/str-shuffle.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 52c495140bdb84f45f186bfb1cccf09788b0121e Maintainer: leonardolara Status: ready --><!-- CREDITS: surfmax,felipe,leonardolara -->
+<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 Maintainer: leonardolara Status: ready --><!-- CREDITS: surfmax,felipe,leonardolara -->
 <refentry xml:id="function.str-shuffle" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>str_shuffle</refname>
@@ -17,6 +17,7 @@
    de todas as possíveis é criada.
   </simpara>
   &caution.cryptographically-insecure;
+  &caution.mt19937-global-state;
  </refsect1>
 
  <refsect1 role="parameters">