W3C home > Mailing lists > Public > xproc-dev@w3.org > September 2008

Re: step must contain only a signature

From: James Garriss <james@garriss.org>
Date: Thu, 18 Sep 2008 15:49:04 -0400
To: XProc Dev <xproc-dev@w3.org>
Message-ID: <C4F828F0.84C%james@garriss.org>
> 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
Received on Thursday, 18 September 2008 19:49:46 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 18 September 2008 19:49:47 GMT