Re: step must contain only a signature

> Is there something we could do that would have made things clearer?

Maybe.  What if you translated the declaration syntax for us newbies by
using examples to show the different ways it can be expressed, then put it
in an appendix?  Maybe something like this:

This declaration:

<p:declare-step type="p:delete">
     <p:input port="source"/>
     <p:output port="result"/>
     <p:option name="match" required="true"/>                      <!--
XSLTMatchPattern -->
</p:declare-step>

can be instantiated like this (if you want to be verbose):

<p:delete>
  <p:input port=²source²/>
  <p:output port=²result²/>
  <p:option name="match" select="'BookStore/Book/Title'"/>
</p:delete>

(of course, this begs the question of where the attribute ³select² came
from)

or like this (if you want to be less verbose):

<p:delete match=³BookStore/Book/Title²>
  <p:input port=²source²/>
  <p:output port=²result²/>
</p:delete>

or even like this (if you want to be really succinct):

<p:delete match=³BookStore/Book/Title²/>

And I wouldn¹t mind seeing good definitions/explanations/examples for things
like XSLTMatchPattern, IRI, QName, and XPathExpression in the glossary.

Thanks for asking,

James Garriss
http://garriss.blogspot.com