This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 2779 - value-of description (editorial)
Summary: value-of description (editorial)
Status: CLOSED FIXED
Alias: None
Product: XPath / XQuery / XSLT
Classification: Unclassified
Component: XSLT 2.0 (show other bugs)
Version: Candidate Recommendation
Hardware: PC Windows XP
: P2 normal
Target Milestone: ---
Assignee: Michael Kay
QA Contact: Mailing list for public feedback on specs from XSL and XML Query WGs
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-01-30 10:35 UTC by David Carlisle
Modified: 2006-01-31 17:19 UTC (History)
0 users

See Also:


Attachments

Description David Carlisle 2006-01-30 10:35:43 UTC
11.4.3, The initial description before the syntax box says

Within a sequence constructor, the xsl:value-of instruction can be used to
compute generated text. The xsl:value-of instruction computes this text using an
expression that is specified as the value of the select attribute. This might,
for example, extract text from a source tree or by inserting the value of a
variable.



This doesn't mention the new possibility of using content rather than a select
attribute. (It's debatable whether this makes the second sentence false, or just
less true than it could have been) Also (although I wouldn't have reported this
one as a problem if not commenting on the first point) it doesn't clarify that 
"text" means text node here (rather than string). 

The paragraphs immediately after the syntax box do have the full details, so
"correcting" the first paragraph might end up just duplicating the text and it
might be better to say less, eg just

Within a sequence constructor, the xsl:value-of instruction can be used to
compute generated text nodes.

Whatever. This is purely editorial and feel free to close this report without
needing to ask me (even if your decision is no change)

David
Comment 1 Michael Kay 2006-01-31 17:14:00 UTC
I have fixed this editorially by changing the paragraph to read

<p>Within a <termref def="dt-sequence-constructor">sequence
constructor</termref>, the <elcode>xsl:value-of</elcode> instruction can be
used to generate computed text nodes. The
<elcode>xsl:value-of</elcode> instruction computes the text using an <termref
def="dt-expression">expression</termref> that is specified as the value of the
<code>select</code> attribute, or by means of contained instructions</phrase>.
This might, for example, extract text from a <termref
def="dt-source-tree">source tree</termref> or insert the value of a variable.</p>
Comment 2 David Carlisle 2006-01-31 17:19:08 UTC
Thanks, closing this.