<?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>4818</bug_id>
          
          <creation_ts>2007-06-27 23:13:46 +0000</creation_ts>
          <short_desc>Reword the last sentence of 3.2 from \&quot;appears as a child of a document element \&quot; to more clearly cover the cases where the child element is not in an embedded document</short_desc>
          <delta_ts>2007-07-26 19:05:13 +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>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>FPWD</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Bassam Tabbara">bassamt</reporter>
          <assigned_to name="Virginia Smith">virginia.smith</assigned_to>
          
          
          <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>15699</commentid>
    <comment_count>0</comment_count>
    <who name="Bassam Tabbara">bassamt</who>
    <bug_when>2007-06-27 23:13:46 +0000</bug_when>
    <thetext> </thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>15911</commentid>
    <comment_count>1</comment_count>
    <who name="Virginia Smith">virginia.smith</who>
    <bug_when>2007-07-25 04:16:36 +0000</bug_when>
    <thetext>reworded section 3.3:

Each document in the interchange set MUST be represented in an SML-IF document by a separate document element as follows:

    *      Each definition document [Ed. note: insert link to definition] in the interchange set MUST appear as a child of a document element that is a child of the definitions element of the SML-IF document. The order of the document children is not significant.
    *      Each model instance document [Ed. note: insert link to definition] in the interchange set MUST appear as a child of a document element that is a child of the instances element of the SML-IF document. The order of the document children is not significant.

Documents may be included in the SML-IF document either as an embedded document (where the octet stream representing the SML model document to be included is physically embedded in the SML-IF document) or as a document reference.

3.3.1 Embedded Documents

If a document is to be physically embedded in the SML-IF document, the octet stream representing it MUST first be processed as follows:

    *      The XML declaration and document type declaration (DTD) are removed.
    *      The stream is converted to the encoding of the SML-IF document into which it will be packaged.

Note:

If the SML-IF document uses UTF-8 encoding, the octet-stream result of XML Canonicalization [Canonical XML] is more than sufficient to accomplish this processing.

The resulting octet stream MUST be embedded as the content of the data child of the corresponding document element in the SML-IF document.

3.3.2 Document References

If a document is to be referred to rather than embedded, a reference to it MUST placed in the locator child of the corresponding document element.

SML-IF specifies one way such references may be constructed, the documentURI element, however any representation the producer and consumer agree on may be used. [Ed. note: the previous statement is not very portable!]</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>15915</commentid>
    <comment_count>2</comment_count>
    <who name="Kirk Wilson">kirk.wilson</who>
    <bug_when>2007-07-25 14:53:53 +0000</bug_when>
    <thetext>The statement regarding the placement of the model instance document, &quot;Each model instance document...MUST appear as a child of a document element that is a child of the instances element...&quot;, appears to be garbled.  The model instance doc is a child of the &lt;instance&gt; element and not the child of a &lt;document&gt; element.  The final clause then seems to get everything into an infinite recursion.  (There might have been a copy/paste error from the preceding statement, and the wrong words were mistaken changed.  Note the &lt;instance&gt; is on the same level as the &lt;document&gt; element.  I believe the statement should read: Each model instance document...MUST appear as a child of a INSTANCE element that is a child of the DEFINITIONS element....) </thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>15937</commentid>
    <comment_count>3</comment_count>
    <who name="Kirk Wilson">kirk.wilson</who>
    <bug_when>2007-07-26 19:05:13 +0000</bug_when>
    <thetext>(In reply to comment #2)
&gt; The statement regarding the placement of the model instance document, &quot;Each
&gt; model instance document...MUST appear as a child of a document element that is
&gt; a child of the instances element...&quot;, appears to be garbled.  The model
&gt; instance doc is a child of the &lt;instance&gt; element and not the child of a
&gt; &lt;document&gt; element.  The final clause then seems to get everything into an
&gt; infinite recursion.  (There might have been a copy/paste error from the
&gt; preceding statement, and the wrong words were mistaken changed.  Note the
&gt; &lt;instance&gt; is on the same level as the &lt;document&gt; element.  I believe the
&gt; statement should read: Each model instance document...MUST appear as a child of
&gt; a INSTANCE element that is a child of the DEFINITIONS element....) 

I WAS SUFFERING FROM ANGLE BRACKET DYSLEXIA.  THE TEXT IS CORRECT AS PROPOSED.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>