This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.
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 "{aliases}" are defined (in section 5.3.3) to be a property of documents; however documents are not schema components. If the <document> 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.
http://www.w3.org/Bugs/Public/show_bug.cgi?id=5499 Added text describing {} and [] notation. Made suggested changes to existing braces to brackets.
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&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&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
Per 5/5 meeting: Change paragraph in section 2.1 in both core and IF specs using as a start the following text: "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]." The sense of the working group is that we want the text to be 'true' whether or not any such notations are present in the spec. Mark needsReview when done.
Changed text in both specs to: "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]. " 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.
+1
+1 with following editorial change: - removal of "For example, " in second sentence or replace it with "That is, "
+1 I agree with comment# 6
+1 Agree with comment #6
Resolution in 6/19 meeting: Fix per 2nd suggestion in comment #6 (use "That is"). No need to review.
Changed according to Comment #6