Index: en/language-snippets.ent
===================================================================
RCS file: /repository/phpdoc/en/language-snippets.ent,v
retrieving revision 1.263
diff -u -p -r1.263 language-snippets.ent
--- en/language-snippets.ent	2 May 2009 10:20:44 -0000	1.263
+++ en/language-snippets.ent	10 May 2009 17:49:33 -0000
@@ -2,6 +2,8 @@
 <!-- $Revision: 1.263 $ -->
 <!-- Keep 'em sorted -->
 
+<!ENTITY changelog.randomseed '<row><entry>4.2.0</entry><entry>The random
+number generator is seeded automatically.</entry></row>'>
 
 <!-- Notes -->
 
Index: en/reference/math/functions/mt-rand.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/math/functions/mt-rand.xml,v
retrieving revision 1.18
diff -u -p -r1.18 mt-rand.xml
--- en/reference/math/functions/mt-rand.xml	16 Jan 2009 15:28:43 -0000	1.18
+++ en/reference/math/functions/mt-rand.xml	10 May 2009 17:49:33 -0000
@@ -34,8 +34,6 @@
    between 5 and 15 (inclusive), for example, use <literal>mt_rand(5,
    15)</literal>.
   </simpara>
-  &note.randomseed;
-
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
@@ -67,6 +65,24 @@
    and <parameter>max</parameter> (or <function>mt_getrandmax</function>, inclusive)
   </para>
  </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      &changelog.randomseed;
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
Index: en/reference/math/functions/rand.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/math/functions/rand.xml,v
retrieving revision 1.22
diff -u -p -r1.22 rand.xml
--- en/reference/math/functions/rand.xml	16 Jan 2009 15:28:43 -0000	1.22
+++ en/reference/math/functions/rand.xml	10 May 2009 17:49:33 -0000
@@ -33,9 +33,6 @@
     <function>mt_rand</function> instead.
    </simpara>
   </note>
-
-  &note.randomseed;
-
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
@@ -67,6 +64,24 @@
    (or 0) and <parameter>max</parameter> (or <function>getrandmax</function>, inclusive).
   </para>
  </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      &changelog.randomseed;
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
Index: en/reference/array/functions/array-rand.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/array/functions/array-rand.xml,v
retrieving revision 1.13
diff -u -p -r1.13 array-rand.xml
--- en/reference/array/functions/array-rand.xml	16 Jan 2009 16:14:24 -0000	1.13
+++ en/reference/array/functions/array-rand.xml	10 May 2009 17:49:33 -0000
@@ -50,6 +50,30 @@
    random keys as well as values out of the array.
   </para>
  </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>5.2.10</entry>
+       <entry>
+        The resulting array of keys is no longer shuffled.
+       </entry>
+      </row>
+      &changelog.randomseed;
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -58,7 +82,6 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-srand((float) microtime() * 10000000);
 $input = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
 $rand_keys = array_rand($input, 2);
 echo $input[$rand_keys[0]] . "\n";
@@ -69,10 +92,6 @@ echo $input[$rand_keys[1]] . "\n";
    </example>
   </para>
  </refsect1>
- <refsect1 role="notes">
-  &reftitle.notes;
-  &note.randomseed;
- </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
Index: en/reference/array/functions/shuffle.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/array/functions/shuffle.xml,v
retrieving revision 1.18
diff -u -p -r1.18 shuffle.xml
--- en/reference/array/functions/shuffle.xml	20 Mar 2009 20:38:30 -0000	1.18
+++ en/reference/array/functions/shuffle.xml	10 May 2009 17:49:33 -0000
@@ -56,10 +56,27 @@ foreach ($numbers as $number) {
    </example>
   </para>
  </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      &changelog.randomseed;
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
  <refsect1 role="notes">
   &reftitle.notes;
   &note.no-key-association;
-  &note.randomseed;
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;