Description:
------------
The following text in a note on http://php.net/manual/en/control-structures.foreach.php is, I believe, inaccurate:

"Unless the array is referenced, foreach operates on a copy of the specified array and not the array itself."

This implies that the snippet seen below will never work on the original array;  however, everybody knows that it does!

This passage was quoted by teaching material, causing -- if my analysis is correct -- students being taught to use alternative loop constructs that are not best suited for the task at hand.

This passage should just be removed.

Test script:
---------------
<?php
$someArray = Array(1, 2, 3);

//       +---> array not referenced
//       |
//       |             +---> value referenced
//       |             |     for demonstration
//       |             |
foreach ($someArray as &$value) {
   $value = 3;
}

var_export($someArray);
?>

Expected result:
----------------
array (
  0 => 3,
  1 => 3,
  2 => 3,
)

Actual result:
--------------
// Actual result:
array (
  0 => 3,
  1 => 3,
  2 => 3,
)

// Result implied by documentation:
array (
  0 => 1,
  1 => 2,
  2 => 3,
)