<?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>5499</bug_id>
          
          <creation_ts>2008-02-21 20:52:32 +0000</creation_ts>
          <short_desc>Explanation of notation for { } and [ ]</short_desc>
          <delta_ts>2008-06-19 18:22:21 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>SML</product>
          <component>Core+Interchange Format</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows XP</op_sys>
          <bug_status>RESOLVED</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>CR</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Kirk Wilson">kirk.wilson</reporter>
          <assigned_to name="James Lynn">james.lynn</assigned_to>
          <cc>johnarwe</cc>
    
    <cc>virginia.smith</cc>
          
          <qa_contact name="SML Working Group discussion list">public-sml</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>19178</commentid>
    <comment_count>0</comment_count>
    <who name="Kirk Wilson">kirk.wilson</who>
    <bug_when>2008-02-21 20:52:32 +0000</bug_when>
    <thetext>Add text in the Notation section of both documents explaining use of curly brackets, {}, and square brackets, [].  Usage MUST be consistent with the usage of this notation in XML Schema: i.e., {} designate properties of schema components, [] designate properties of information item.

No further changes are required in the Core spec.  However, usage of this notation should be reviewed in SML-IF.  In particular, in SML-IF &quot;{aliases}&quot; are defined (in section 5.3.3) to be a property of documents; however documents are not schema components.  If the &lt;document&gt; element is intended, then this property should be in square brackets.

Also, in Appendix B of SML-IF, are the following phrases:
  the {namespace name} URI information of the sml:locid attribute. . ., and
  The {local part} information of the sml:locid attribute. . .

Since sml:locid is an information element, the square brackets should be used.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>20224</commentid>
    <comment_count>1</comment_count>
    <who name="James Lynn">james.lynn</who>
    <bug_when>2008-05-22 14:28:47 +0000</bug_when>
    <thetext>http://www.w3.org/Bugs/Public/show_bug.cgi?id=5499
Added text describing {} and [] notation.
Made suggested changes to existing braces to brackets.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>20239</commentid>
    <comment_count>2</comment_count>
    <who name="Virginia Smith">virginia.smith</who>
    <bug_when>2008-05-22 19:08:21 +0000</bug_when>
    <thetext>Diffs are at:

http://www.w3.org/2007/10/htmldiff?doc1=http%3A%2F%2Fdev.w3.org%2Fcvsweb%2F%7Echeckout%7E%2F2007%2Fxml%2Fsml%2Fbuild%2Fsml.html%3Frev%3D1.207%26content-type%3Dtext%2Fhtml%3B%2520charset%3Diso-8859-1&amp;doc2=http%3A%2F%2Fdev.w3.org%2Fcvsweb%2F%7Echeckout%7E%2F2007%2Fxml%2Fsml%2Fbuild%2Fsml.html%3Frev%3D1.208%26content-type%3Dtext%2Fhtml%3B%2520charset%3Diso-8859-1

http://www.w3.org/2007/10/htmldiff?doc1=http%3A%2F%2Fdev.w3.org%2Fcvsweb%2F%7Echeckout%7E%2F2007%2Fxml%2Fsml%2Fbuild%2Fsml-if.html%3Frev%3D1.153%26content-type%3Dtext%2Fhtml%3B%2520charset%3Diso-8859-1&amp;doc2=http%3A%2F%2Fdev.w3.org%2Fcvsweb%2F%7Echeckout%7E%2F2007%2Fxml%2Fsml%2Fbuild%2Fsml-if.html%3Frev%3D1.154%26content-type%3Dtext%2Fhtml%3B%2520charset%3Diso-8859-1</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>20388</commentid>
    <comment_count>3</comment_count>
    <who name="Virginia Smith">virginia.smith</who>
    <bug_when>2008-06-05 19:32:51 +0000</bug_when>
    <thetext>Per 5/5 meeting: Change paragraph in section 2.1 in both core and IF specs using as a start the following text:
&quot;Proposal: References to properties of schema components are links to the relevant definition, set off with curly braces, for instance {example property}. This is the same convention as that used in the XML schema specification [ XML Schema Structures ]. References to properties of information items as defined in [ XML Information Set ] are notated as links to the relevant section thereof, set off with square brackets, for example [children].&quot;
The sense of the working group is that we want the text to be &apos;true&apos; whether or not any such notations are present in the spec.

Mark needsReview when done.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>20575</commentid>
    <comment_count>4</comment_count>
    <who name="James Lynn">james.lynn</who>
    <bug_when>2008-06-18 01:47:48 +0000</bug_when>
    <thetext>Changed text in both specs to:

&quot;This specification follows the same conventions for schema components as those used in the XML schema specification [XML Schema Structures]. For example, references to properties of schema components are links to the relevant definition, set off with curly braces, for instance {example property}. References to properties of information items as defined in [XML Information Set] are notated as links to the relevant section thereof, set off with square brackets, for example [children]. &quot;

After reviewing the original wording, I came up with the above wording to reflect what I believe was the a more general intention about following the conventions of the XML Schema spec, of which these are two specific examples. This requires review and agreement by the WG.
</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>20578</commentid>
    <comment_count>5</comment_count>
    <who name="John Arwe">johnarwe</who>
    <bug_when>2008-06-18 13:31:00 +0000</bug_when>
    <thetext>+1</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>20580</commentid>
    <comment_count>6</comment_count>
    <who name="Virginia Smith">virginia.smith</who>
    <bug_when>2008-06-18 16:01:26 +0000</bug_when>
    <thetext>+1 with following editorial change:
- removal of &quot;For example, &quot; in second sentence or replace it with &quot;That is, &quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>20591</commentid>
    <comment_count>7</comment_count>
    <who name="Kumar Pandit">kumarp</who>
    <bug_when>2008-06-19 06:14:01 +0000</bug_when>
    <thetext>+1
I agree with comment# 6
</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>20597</commentid>
    <comment_count>8</comment_count>
    <who name="Kirk Wilson">kirk.wilson</who>
    <bug_when>2008-06-19 15:04:34 +0000</bug_when>
    <thetext>+1
Agree with comment #6</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>20598</commentid>
    <comment_count>9</comment_count>
    <who name="Virginia Smith">virginia.smith</who>
    <bug_when>2008-06-19 18:17:05 +0000</bug_when>
    <thetext>Resolution in 6/19 meeting: Fix per 2nd suggestion in comment #6 (use &quot;That is&quot;). No need to review.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>20602</commentid>
    <comment_count>10</comment_count>
    <who name="James Lynn">james.lynn</who>
    <bug_when>2008-06-19 18:22:21 +0000</bug_when>
    <thetext>Changed according to Comment #6</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>