From baacc08ead3427721a59990de19785f0fbba4a50 Mon Sep 17 00:00:00 2001
From: Fred Drake <fdrake@acm.org>
Date: Thu, 27 Sep 2001 15:49:23 +0000
Subject: [PATCH] Turn \input, \include, and \verbatiminput into XInclude
 elements instead of something ad-hoc.

---
 Doc/tools/sgmlconv/conversion.xml | 22 +++++++++++++---------
 Doc/tools/sgmlconv/docfixer.py    |  2 +-
 2 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/Doc/tools/sgmlconv/conversion.xml b/Doc/tools/sgmlconv/conversion.xml
index c2f9f0d9200e..20acdf36c145 100644
--- a/Doc/tools/sgmlconv/conversion.xml
+++ b/Doc/tools/sgmlconv/conversion.xml
@@ -184,7 +184,7 @@
 
   <!-- "See also:" sections. -->
   <macro name="seemodule">
-    <attribute name="ref" optional="yes"/>
+    <attribute name="" optional="yes"/>
     <attribute name="name"/>
     <child name="description"/>
     </macro>
@@ -279,11 +279,11 @@
     </macro>
 
   <!-- Entity management. -->
-  <macro name="include">
-    <attribute name="source"/>
+  <macro name="include" outputname="xi:include">
+    <attribute name="href"/>
     </macro>
-  <macro name="input">
-    <attribute name="source"/>
+  <macro name="input" outputname="xi:include">
+    <attribute name="href"/>
     </macro>
 
   <!-- Large-scale document structure. -->
@@ -300,7 +300,11 @@
                endcloses="chapter chapter* section section*
                           subsection subsection*
                           subsubsection subsubsection*
-                          paragraph paragraph* subparagraph subparagraph*"/>
+                          paragraph paragraph* subparagraph
+                          subparagraph*">
+    <attribute name="xmlns:xi"
+      >http://www.w3.org/2001/XInclude</attribute>
+    </environment>
 
   <macro name="chapter"
          closes="chapter chapter* section section* subsection subsection*
@@ -458,9 +462,9 @@
     <!-- not used anywhere, but it's a standard LaTeXism -->
     <attribute name="spaces">visible</attribute>
     </environment>
-  <macro name="verbatiminput" ouptutname="input">
-    <attribute name="verbatim">yes</attribute>
-    <attribute name="source"/>
+  <macro name="verbatiminput" ouptutname="xi:include">
+    <attribute name="parse">text</attribute>
+    <attribute name="href"/>
     </macro>
 
   <!-- Table markup. -->
diff --git a/Doc/tools/sgmlconv/docfixer.py b/Doc/tools/sgmlconv/docfixer.py
index 867ec5073a4c..c1ea9707742a 100755
--- a/Doc/tools/sgmlconv/docfixer.py
+++ b/Doc/tools/sgmlconv/docfixer.py
@@ -615,7 +615,7 @@ PARA_LEVEL_ELEMENTS = (
 
 PARA_LEVEL_PRECEEDERS = (
     "setindexsubitem", "author",
-    "stindex", "obindex", "COMMENT", "label", "input", "title",
+    "stindex", "obindex", "COMMENT", "label", "xi:include", "title",
     "versionadded", "versionchanged", "declaremodule", "modulesynopsis",
     "moduleauthor", "indexterm", "leader",
     )
-- 
2.47.3