From 47dc67e60513ff0bdedcb8ead0d1e0b473007737 Mon Sep 17 00:00:00 2001
From: Norman Walsh <ndw@nwalsh.com>
Date: Thu, 1 Aug 2024 08:58:10 +0100
Subject: [PATCH] Editorial pass on text steps

---
 step-text/src/main/xml/conformance.xml        |  8 --------
 step-text/src/main/xml/specification.xml      | 20 -------------------
 .../src/main/xml/steps/markdown-to-html.xml   |  2 +-
 3 files changed, 1 insertion(+), 29 deletions(-)

diff --git a/step-text/src/main/xml/conformance.xml b/step-text/src/main/xml/conformance.xml
index 01035c8d..337ce4ab 100644
--- a/step-text/src/main/xml/conformance.xml
+++ b/step-text/src/main/xml/conformance.xml
@@ -31,12 +31,4 @@ how <glossterm role='unwrapped'>implementation-defined</glossterm> features are
 
 <?implementation-defined-features?>
 </section>
-
-<section xml:id="implementation-dependent">
-<title>Implementation-dependent features</title>
-
-<para>The following features are implementation-dependent:</para>
-
-<?implementation-dependent-features?>
-</section>
 </appendix>
diff --git a/step-text/src/main/xml/specification.xml b/step-text/src/main/xml/specification.xml
index 9b648ae8..e0c19ea6 100644
--- a/step-text/src/main/xml/specification.xml
+++ b/step-text/src/main/xml/specification.xml
@@ -69,26 +69,6 @@ specifications</holder>
   <!-- Include step descriptions: -->
   <xi:include href="steps/markdown-to-html.xml"/>
 
-  <section xmlns="http://docbook.org/ns/docbook" xml:id="errors">
-    <title>Step Errors</title>
-
-    <para>These steps can raise <glossterm baseform="dynamic-error">dynamic errors</glossterm>. </para>
-
-    <para><termdef xml:id="dt-dynamic-error">A <firstterm>dynamic error</firstterm> is one which occurs while a pipeline
-        is being evaluated.</termdef> Examples of dynamic errors include references to URIs that cannot be resolved,
-      steps which fail, and pipelines that exhaust the capacity of an implementation (such as memory or disk space). For
-      a more complete discussion of dynamic errors, see <xspecref spec="xproc" xref="dynamic-errors"/>. </para>
-
-    <para>If a step fails due to a dynamic error, failure propagates upwards until either a <tag>p:try</tag> is
-      encountered or the entire pipeline fails. In other words, outside of a <tag>p:try</tag>, step failure causes the
-      entire pipeline to fail.</para>
-
-    <para>The following errors can be raised by this step:</para>
-
-    <?step-error-list level="none"?>
-
-  </section>
-
   <xi:include href="conformance.xml"/>
 
   <appendix xml:id="references">
diff --git a/step-text/src/main/xml/steps/markdown-to-html.xml b/step-text/src/main/xml/steps/markdown-to-html.xml
index bc6da2e8..4aa28f22 100644
--- a/step-text/src/main/xml/steps/markdown-to-html.xml
+++ b/step-text/src/main/xml/steps/markdown-to-html.xml
@@ -16,7 +16,7 @@
 <para>The <tag>p:markdown-to-html</tag> step transforms a text document containing
 Markdown, for example <biblioref linkend="commonmark"/>, into HTML.
 <impl>The flavor(s) of Markdown supported and the parameters allowed are
-<glossterm>implementation-defined</glossterm>.</impl>.</para>
+<glossterm>implementation-defined</glossterm>.</impl></para>
 
 <simplesect>
   <title>Document properties</title>