Description:
------------
The example for the "Returning References" page <http://us3.php.net/manual/en/language.references.return.php> handwaves the fact that $found_var needs to be set to either a reference or concrete value within the /* ...code... */ block, which is a potential source of confusion for newer programmers, judging by the conversation I just had on ##php. The following may be a clearer and more complete example for users to demonstrate the concept:

<?php
class C {
        public $value = 42;

        public function &getValue() {
                return $this->value;
        }
}

$c = new C;
$myValue = &$c->getValue();   // $myValue is a reference to $c->value, which is 42.
$c->value = 2;
echo $myValue;                // prints the new value of $c->value, ie 2.
?>