Skip to content

Commit

Permalink
Editorial pass on text steps
Browse files Browse the repository at this point in the history
  • Loading branch information
ndw committed Aug 1, 2024
1 parent e01a494 commit 47dc67e
Show file tree
Hide file tree
Showing 3 changed files with 1 addition and 29 deletions.
8 changes: 0 additions & 8 deletions step-text/src/main/xml/conformance.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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>
20 changes: 0 additions & 20 deletions step-text/src/main/xml/specification.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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">
Expand Down
2 changes: 1 addition & 1 deletion step-text/src/main/xml/steps/markdown-to-html.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down

0 comments on commit 47dc67e

Please sign in to comment.