XInclude by xml:id

Author: André L F S Bacci

configure.php

@@ -774,7 +774,7 @@ function getFileModificationHistory(): array {
 }
 echo "done.\n";
 
-echo "Running XInclude... ";
+echo "Running XInclude/XPointer... ";
 
 $total  = xinclude_run_byid( $dom );
 $total += xinclude_run_xpointer( $dom );
@@ -905,7 +905,7 @@ function xinclude_residual( DOMDocument $dom )
 //              $fixup = "<varlistentry><term>></term><listitem><simpara></simpara></listitem></varlistentry>";
 //              break;
             default:
-                echo "Unknown parent element of failed XInclude: $tagName\n";
+                echo "Unknown parent of failed XInclude: $tagName\n";
                 $explain = true;
                 continue 2;
         }
@@ -932,8 +932,8 @@ function xinclude_residual( DOMDocument $dom )
     }
 
     // XInclude by xml:id never duplicates xml:id, horever, also using
-    // XInclude by XPath/XPointer may start causing duplications.
-    // Crude and ugly fixup ahead, beware!
+    // XInclude by XPath/XPointer may start causing duplications
+    // (see docs/structure.md). Crude and ugly fixup ahead, beware!
 
     $list = array();
     $nodes = $xpath->query( "//*[@xml:id]" );
@@ -1051,4 +1051,3 @@ function xinclude_residual( DOMDocument $dom )
 
     errors_are_bad(1); // Tell the shell that this script finished with an error.
 }
-?>