Enable runnable (WASM) examples for language.references section

Author: AllenJB

language/references.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
- <chapter xml:id="language.references" xmlns="http://docbook.org/ns/docbook">
+ <chapter xml:id="language.references" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
   <title>References Explained</title>
 
   <sect1 xml:id="language.references.whatare">
@@ -38,13 +38,10 @@
      In the first of these, PHP references allow you to make two
      variables refer to the same content. Meaning, when you do:
      <informalexample>
-      <programlisting role="php">
+      <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
-
 $a =& $b;
-
-?>
 ]]>
       </programlisting>
      </informalexample>
@@ -81,8 +78,6 @@ var_dump(array_key_exists('b', $b)); // bool(true)
 $c = new stdClass();
 foo($c->d);
 var_dump(property_exists($c, 'd')); // bool(true)
-
-?>
 ]]>
        </programlisting>
       </example>
@@ -92,13 +87,10 @@ var_dump(property_exists($c, 'd')); // bool(true)
      The same syntax can be used with functions that return
      references:
      <informalexample>
-      <programlisting role="php">
+      <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
-
 $foo =& find_var($bar);
-
-?>
 ]]>
       </programlisting>
      </informalexample>
@@ -120,7 +112,6 @@ $foo =& find_var($bar);
        <programlisting role="php">
 <![CDATA[
 <?php
-
 $var1 = "Example variable";
 $var2 = "";
 
@@ -140,8 +131,6 @@ echo "var2 is set to '$var2'\n"; // var2 is set to ''
 
 global_references(true);
 echo "var2 is set to '$var2'\n"; // var2 is set to 'Example variable'
-
-?>
 ]]>
        </programlisting>
       </example>
@@ -159,7 +148,6 @@ echo "var2 is set to '$var2'\n"; // var2 is set to 'Example variable'
        <programlisting role="php">
 <![CDATA[
 <?php
-
 $ref = 0;
 $row =& $ref;
 
@@ -168,8 +156,6 @@ foreach (array(1, 2, 3) as $row) {
 }
 
 echo $ref; // 3 - last element of the iterated array
-
-?>
 ]]>
        </programlisting>
       </example>
@@ -185,7 +171,6 @@ echo $ref; // 3 - last element of the iterated array
       <programlisting role="php">
 <![CDATA[
 <?php
-
 $a = 1;
 $b = array(2, 3);
 
@@ -194,8 +179,8 @@ $arr[0]++;
 $arr[1]++;
 $arr[2]++;
 /* $a == 2, $b == array(3, 4); */
-
-?>
+var_dump($a);
+var_dump($b);
 ]]>
       </programlisting>
      </informalexample>
@@ -216,6 +201,7 @@ $a = 1;
 $b =& $a;
 $c = $b;
 $c = 7; // $c is not a reference; no change to $a or $b
+print "a = {$a}; b = {$b}; c = {$c}\n\n";
 
 /* Assignment of array variables */
 $arr = array(1);
@@ -224,8 +210,9 @@ $arr2 = $arr; // Not an assignment-by-reference!
 $arr2[0]++;
 /* $a == 2, $arr == array(2) */
 /* The contents of $arr are changed even though it's not a reference! */
-
-?>
+print "a = {$a}\n";
+var_dump($arr);
+var_dump($arr2);
 ]]>
       </programlisting>
      </informalexample>
@@ -245,16 +232,14 @@ $arr2[0]++;
       <programlisting role="php">
 <![CDATA[
 <?php
-
 function foo(&$var)
 {
     $var++;
 }
 
-$a=5;
+$a = 5;
 foo($a);
-
-?>
+print $a;
 ]]>
       </programlisting>
      </informalexample>
@@ -281,18 +266,15 @@ foo($a);
     As said before, references are not pointers. That means, the
     following construct won't do what you expect:
     <informalexample>
-     <programlisting role="php">
+     <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
-
 function foo(&$var)
 {
     $var =& $GLOBALS["baz"];
 }
 
 foo($bar);
-
-?>
 ]]>
      </programlisting>
     </informalexample>
@@ -322,18 +304,14 @@ foo($bar);
      <programlisting role="php">
 <![CDATA[
 <?php
-
 function foo(&$var)
 {
     $var++;
 }
 
-$a=5;
-
+$a = 5;
 foo($a);
-// $a is 6 here
-
-?>
+print $a; // $a is 6 here
 ]]>
      </programlisting>
     </informalexample>
@@ -364,6 +342,7 @@ foo($a);
 function foo(&$var)
 {
     $var++;
+    print $var;
 }
 
 function &bar()
@@ -373,8 +352,6 @@ function &bar()
 }
 
 foo(bar());
-
-?>
 ]]>
      </programlisting>
     </informalexample>
@@ -389,7 +366,7 @@ foo(bar());
   result is undefined. For example, the following examples of passing
   by reference are invalid:
     <informalexample>
-     <programlisting role="php">
+     <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 
@@ -413,8 +390,6 @@ class Foobar {}
 
 foo(new Foobar()) // Produces a notice as of PHP 7.0.7
                   // Notice: Only variables should be passed by reference
-
-?>
 ]]>
      </programlisting>
     </informalexample>
@@ -449,8 +424,6 @@ $obj = new Foo();
 $myValue = &$obj->getValue(); // $myValue is a reference to $obj->value, which is 42
 $obj->value = 2;
 echo $myValue;                // Prints the new value of $obj->value, i.e. 2
-
-?> 
 ]]>
      </programlisting>
     </informalexample>
@@ -495,14 +468,17 @@ $collection = &collector();
 $collection[] = 'foo';
 
 print_r(collector());
-// Array
-// (
-//    [0] => foo
-// )
-
-?> 
 ]]>
      </programlisting>
+     &example.outputs;
+     <screen>
+<![CDATA[
+Array
+(
+   [0] => foo
+)
+]]>
+     </screen>
     </informalexample>
    <note>
     <simpara>
@@ -513,7 +489,7 @@ print_r(collector());
    To pass the returned reference to another function expecting a reference
    you can use this syntax:
     <informalexample>
-     <programlisting role="php">
+     <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 
@@ -524,8 +500,6 @@ function &collector()
 }
 
 array_push(collector(), 'foo');
-
-?> 
 ]]>
      </programlisting>
     </informalexample>
@@ -552,8 +526,8 @@ array_push(collector(), 'foo');
 $a = 1;
 $b =& $a;
 unset($a); 
-
-?>
+var_dump($a);
+var_dump($b);
 ]]>
      </programlisting>
     </informalexample>
@@ -582,13 +556,10 @@ unset($a);
      are in fact creating reference to a global variable. That means,
      this is the same as:
      <informalexample>
-      <programlisting role="php">
+      <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
-
 $var =& $GLOBALS["var"];
-
-?>
 ]]>
       </programlisting>
      </informalexample>