Mark oop5 and xml* categories as 'interactive' (with exceptions) and use 'examples/' dir for XML example files so they (will) work with WASM

Author: derickr

language/oop5.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
- <chapter xml:id="language.oop5" xmlns="http://docbook.org/ns/docbook">
+ <chapter xml:id="language.oop5" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
   <title>Classes and Objects</title>
 
   <sect1  xml:id="oop5.intro">

language/oop5/abstract.xml

@@ -194,8 +194,8 @@ class C extends A
    but must have either <literal>get</literal> or <literal>set</literal> declared but not defined (as in the example above).
   </simpara>
   <example>
-   <title>Abstract property example</title>
-   <programlisting role="php">
+   <title>Abstract property with hooks example</title>
+   <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 

language/oop5/autoload.xml

@@ -44,7 +44,7 @@
      and <literal>MyClass2</literal> from the files <filename>MyClass1.php</filename>
      and <filename>MyClass2.php</filename> respectively.
     </para>
-    <programlisting role="php">
+    <programlisting role="php" annotations="interactive">
 <![CDATA[
 <?php
 spl_autoload_register(function ($class_name) {
@@ -90,7 +90,7 @@ Fatal error: Interface 'ITest' not found in ...
      by Composer. By including this file, those packages can be used without
      any additional work.
     </simpara>
-    <programlisting role="php">
+    <programlisting role="php" annotations="interactive">
 <![CDATA[
 <?php
 require __DIR__ . '/vendor/autoload.php';

language/oop5/basic.xml

@@ -807,7 +807,7 @@ NS\ClassName
   <para>
    <example>
     <title>Nullsafe Operator</title>
-    <programlisting role="php">
+    <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 

language/oop5/decon.xml

@@ -193,7 +193,7 @@ class Point {
     </note>
     <example>
      <title>Using new in initializers</title>
-     <programlisting role="php">
+     <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 

language/oop5/properties.xml

@@ -45,7 +45,7 @@
   <para>
    <example>
     <title>Property declarations</title>
-    <programlisting role="php">
+    <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 class SimpleClass
@@ -201,7 +201,7 @@ Fatal error: Uncaught Error: Typed property Shape::$numberOfSides must not be ac
     explicitly if desired.
     <example>
      <title>Example of readonly properties</title>
-     <programlisting role="php">
+     <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 
@@ -241,7 +241,7 @@ $test->prop = "foobar";
     A readonly property can only be initialized once, and only from the scope where it has been declared. Any other assignment or modification of the property will result in an <classname>Error</classname> exception.
     <example>
      <title>Illegal initialization of readonly properties</title>
-     <programlisting role="php">
+     <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 class Test1 {
@@ -261,7 +261,7 @@ $test1->prop = "foobar";
     <para>
      Specifying an explicit default value on readonly properties is not allowed, because a readonly property with a default value is essentially the same as a constant, and thus not particularly useful.
      <informalexample>
-      <programlisting role="php">
+      <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 
@@ -283,7 +283,7 @@ class Test {
    <para>
     Modifications are not necessarily plain assignments, all of the following will also result in an <classname>Error</classname> exception:
     <informalexample>
-     <programlisting role="php">
+     <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 
@@ -312,7 +312,7 @@ foreach ($test as &$prop);
    <para>
     However, readonly properties do not preclude interior mutability. Objects (or resources) stored in readonly properties may still be modified internally:
     <informalexample>
-     <programlisting role="php">
+     <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 

language/oop5/traits.xml

@@ -220,7 +220,7 @@ Hello World!
       to be able to use B's bigTalk implementation under an additional alias
       <literal>talk</literal>.
     </para>
-    <programlisting role="php">
+    <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 trait A {
@@ -269,7 +269,7 @@ class Aliased_Talker {
    </para>
    <example xml:id="language.oop5.traits.visibility.ex1">
     <title>Changing Method Visibility</title>
-    <programlisting role="php">
+    <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 trait HelloWorld {

language/oop5/visibility.xml

@@ -22,7 +22,7 @@
    </para>
    <example>
     <title>Property declaration</title>
-    <programlisting role="php">
+    <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 /**
@@ -88,7 +88,7 @@ $obj2->printHello(); // Shows Public2, Protected2, Undefined
     </simpara>
     <example>
      <title>Asymmetric Property visibility</title>
-     <programlisting role="php">
+     <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 class Book
@@ -182,7 +182,7 @@ $b->pubYear = 2023; // Fatal Error
     </simpara>
     <example>
      <title>Asymmetric Property inheritance</title>
-     <programlisting role="php">
+     <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 class Book
@@ -214,7 +214,7 @@ class SpecialBook extends Book
    </para>
    <example>
     <title>Method Declaration</title>
-    <programlisting role="php">
+    <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 /**
@@ -313,7 +313,7 @@ $myFoo->test(); // Bar::testPrivate
    </para>
    <example>
     <title>Constant Declaration as of PHP 7.1.0</title>
-    <programlisting role="php">
+    <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 /**
@@ -378,7 +378,7 @@ $myclass2->foo2(); // Public and Protected work, not Private
    </para>
    <example>
     <title>Accessing private members of the same object type</title>
-    <programlisting role="php">
+    <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 class Test

reference/dom/book.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
 
-<book xml:id="book.dom" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<book xml:id="book.dom" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="interactive">
  <?phpdoc extension-membership="bundledexternal" ?>
  <title>Document Object Model</title>
  <titleabbrev>DOM</titleabbrev>

reference/dom/dom/attr/isid.xml

@@ -40,7 +40,7 @@
 <?php
 
 // We need to validate our document before referring to the id
-$doc = Dom\XMLDocument::createFromFile('book.xml', LIBXML_DTDVALID);
+$doc = Dom\XMLDocument::createFromFile('examples/book-docbook.xml', LIBXML_DTDVALID);
 
 // We retrieve the attribute named id of the chapter element
 $attr = $doc->getElementsByTagName('chapter')->item(0)->getAttributeNode('id');