p:error
-The p:error step generates a dynamic error using the input provided
-to the step.
+The p:error step generates a
+dynamic error using the input provided to the
+step.
@@ -13,18 +14,21 @@ to the step.
-This step uses the document provided on its input as the content
-of the error raised. An instance of the
-c:errors element will be produced on the error output port, as is
-always the case for dynamic errors.
-The error generated can be caught by a p:try just like any
-other dynamic error.
+The p:error step always fails. It generates the error specified
+in the option. It also produces a c:errors document that
+will be visible on the error port inside a p:catch.
+(The error vocabulary is described in .)
+
-For authoring convenience, the p:error step is
-declared with a single, primary output port. With respect to connections,
-this port behaves like
-any other output port even though nothing can ever
-appear on it since the step always fails.
+This step should include the content of the document
+that appears on the source port in the error. If more than one
+document appears on the source port of the p:error step, what
+is produced in the error document is implementation-defined.
+
+For authoring convenience, the p:error step is declared with a
+single, primary output port. With respect to connections, this port behaves like
+any other output port even though nothing can ever appear on it since the step
+always fails.For example, given the following invocation:<p:error xmlns:my="http://www.example.org/error"
@@ -34,8 +38,8 @@ appear on it since the step always fails.
</p:with-input>
</p:error>
-The error vocabulary element (and document) generated on the
-error output port would be:
+The errors document generated on the error output port might be:
+
<c:errors xmlns:c="http://www.w3.org/ns/xproc-step"
xmlns:p="http://www.w3.org/ns/xproc"
xmlns:my="http://www.example.org/error">