<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>19839</bug_id>
          
          <creation_ts>2012-11-03 14:50:40 +0000</creation_ts>
          <short_desc>[XSLT30] suggestion for an improved text for definition</short_desc>
          <delta_ts>2013-02-15 13:50:08 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>XPath / XQuery / XSLT</product>
          <component>XSLT 3.0</component>
          <version>Working drafts</version>
          <rep_platform>All</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Mukul Gandhi">gandhi.mukul</reporter>
          <assigned_to name="Michael Kay">mike</assigned_to>
          
          
          <qa_contact name="Mailing list for public feedback on specs from XSL and XML Query WGs">public-qt-comments</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>77789</commentid>
    <comment_count>0</comment_count>
    <who name="Mukul Gandhi">gandhi.mukul</who>
    <bug_when>2012-11-03 14:50:40 +0000</bug_when>
    <thetext>I&apos;m reading the &quot;XSLT 3.0 draft spec, dated 18 October 2012&quot;, and I&apos;ve following suggestions.

In the section &quot;2.1 Terminology&quot;, the following definition is specified:

&quot;The term typed value is defined in Section 5.15 typed-value Accessor. Every node except an element defined in the schema with element-only content has a typed value.&quot;

I think, it would be better if the following phrase within the above definition,
&apos;element defined in the schema&apos;

is changed to,

(1)
&apos;element declared in the schema&apos;

OR

(2)
&apos;element specified in the schema&apos;

It seems (1) is better than (2), because its consistent with the terminology used in XSD specification.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>77792</commentid>
    <comment_count>1</comment_count>
    <who name="Michael Kay">mike</who>
    <bug_when>2012-11-03 17:47:55 +0000</bug_when>
    <thetext>Oh dear, once you look at these things it always gets more difficult, and the danger is that in the interests of precision, you make the text less readable...

Actually, &quot;element&quot; here means in individual node, and it&apos;s not the fact that there is an element declaration in the schema that&apos;s relevant. It&apos;s the &quot;type annotation&quot; of the element that matters; the type annotation is a reference to a type defined in the schema, and the discussion is about whether that type has element-only content. 

I&apos;ve never really understood why elements are declared and types are defined, but the correct phrase should probably be &quot;except an element whose type annotation identifies a type defined in the schema to have element-only content&quot; - I don&apos;t want to go as far as using SCM property names like {variety} in curly braces, since this text is only really a precis of what XDM has to say on the matter.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>77819</commentid>
    <comment_count>2</comment_count>
    <who name="Mukul Gandhi">gandhi.mukul</who>
    <bug_when>2012-11-04 05:05:05 +0000</bug_when>
    <thetext>the modification, &quot;except an element whose type annotation identifies a type defined in the schema to have element-only content&quot; looks nice to me.

&gt; I&apos;ve never really understood why elements are declared and types are defined

What I&apos;ve understood, that this is conceptually similar to variable declarations in quite a number of programming languages. For e.g, when we write &quot;int x;&quot; in a programming language we say that a variable &quot;x&quot; is declared while a type &quot;int&quot; was defined.

In an XSD document if we write,

&lt;xs:element name=&quot;x&quot; type=&quot;int&quot;/&gt;  and then if we compare this with an example &quot;int x;&quot;, we can say with XSD that an element is declared and a type is defined.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>82978</commentid>
    <comment_count>3</comment_count>
    <who name="Michael Kay">mike</who>
    <bug_when>2013-02-12 11:00:16 +0000</bug_when>
    <thetext>Agreed that we should use a phrase along the lines of:

&quot;except an element whose type annotation identifies a type defined in the schema to have element-only content&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83193</commentid>
    <comment_count>4</comment_count>
    <who name="Michael Kay">mike</who>
    <bug_when>2013-02-15 13:50:08 +0000</bug_when>
    <thetext>The phrase I decided to use is:

Every node, other than an element whose type annotation identifies it as having element-only content, has a typed value.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>