Merge pull request #575 from ndw/iss-566-2

Make the agreed improvement to #566

steps/src/main/xml/steps/hash.xml

@@ -1,3 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
          xmlns:e="http://www.w3.org/1999/XSL/Spec/ElementSyntax"
          xmlns:p="http://www.w3.org/ns/xproc"
@@ -61,8 +62,7 @@ value of the attribute in the output.
 If the attribute is named “<tag class="attribute">xml:base</tag>”, the base URI
 of the element <rfc2119>must</rfc2119> also be amended accordingly.</para>
 
-<para>If the document node is matched, the result is a document node
-containing a single text node.</para>
+<para>If the document node is matched, the result is a text document.</para>
 
 <para>If the expression matches any
 other kind of node, the entire node (and <emphasis>not</emphasis> just

steps/src/main/xml/steps/replace.xml

@@ -28,8 +28,7 @@ of the <port>replacement</port> document. Only non-nested matches are
 replaced. That is, once a node is replaced, its descendants cannot
 be matched.</para>
 
-<para>If the document node is matched, the result is a document node
-containing the replacement.</para>
+<para>If the document node is matched, the result is a text document.</para>
 
 <simplesect>
 <title>Document properties</title>

steps/src/main/xml/steps/string-replace.xml

@@ -37,8 +37,7 @@ expression is used as the new value of the attribute in the output.
 If the attribute is named “<tag class="attribute">xml:base</tag>”, the base URI
 of the element <rfc2119>must</rfc2119> also be amended accordingly.</para>
 
-<para>If the document node is matched, the result is a document node
-containing a single text node.</para>
+<para>If the document node is matched, the result is a text document.</para>
 
 <para>If the expression matches any other kind of node, the entire
 node (and <emphasis>not</emphasis> just its contents) is replaced by

steps/src/main/xml/steps/uuid.xml

@@ -45,8 +45,7 @@ matches an <emphasis>attribute</emphasis>, the UUID is used as the new
 value of the attribute in the output. If the attribute is named “<tag class="attribute">xml:base</tag>”, the base URI of the element
 <rfc2119>must</rfc2119> also be amended accordingly.</para>
 
-<para>If the document node is matched, the result is a document node
-containing a single text node.</para>
+<para>If the document node is matched, the result is a text document.</para>
 
 <para>If the expression matches any
 other kind of node, the entire node (and <emphasis>not</emphasis> just