[Bug 3070] How does "embedded simplified" work?

http://www.w3.org/Bugs/Public/show_bug.cgi?id=3070





------- Comment #4 from mike@saxonica.com  2006-04-27 21:16 -------
I was asked to propose clarifying text. Here are my suggestions.

(1) In the note at the start of section 3, replace the sentence "Except in the
case of a simplified stylesheet module, this will be an xsl:stylesheet or
xsl:transform element. " by "In the case of a standard stylesheet module, this
will be an xsl:stylesheet or xsl:transform element. In the case of a simplified
stylesheet module, it can be any element (not in the XSLT namespace) that has
an xsl:version attribute."

(2) In the sentence:

Both forms of stylesheet module (standard and simplified) can exist either as
an entire XML document, or embedded as part of another XML document, typically
a source document that is to be processed using the stylesheet.

after "typically" add "but not necessarily".

(5) In 3.7, mention that because a simplified stylesheet cannot contain a named
template, it must always be invoked by supplying an initial context node that
is matched against the implicit match="/" template rule; and that in practice
it only makes sense for the initial context node to be a document node (because
otherwise the transformation will be performed entirely by built-in rules).

(6) Change the introduction to 3.11 (Embedded stylesheet modules) as follows:

An embedded stylesheet module is a stylesheet module whose containing element
is not the outermost element of the containing XML document. Both [standard
stylesheet modules] and [simplified stylesheet modules] may be embedded in this
way.

Two situations where embedded stylesheets may be useful are:

* The stylesheet may be embedded in the source document to be transformed

* The stylesheet may be embedded in an XML document that describes a sequence
of processing of which the XSLT transformation forms just one part.

The xsl:stylesheet element may have an <code>id</code> attribute to facilitate
reference to the stylesheet module within the containing document. 

... then the Note and the rest of the section follows.

In the final Note, after "Support for the xml-stylesheet processing instruction
is not required for conformance with this Recommendation." add "Implementations
are not constrained in the mechanisms they use to identify a stylesheet when a
transformation is initiated: see 2.3 Initiating a Transformation.

Received on Thursday, 27 April 2006 21:16:48 UTC