[Bug 4818] Reword the last sentence of 3.2 from \"appears as a child of a document element \" to more clearly cover the cases where the child element is not in an embedded document

http://www.w3.org/Bugs/Public/show_bug.cgi?id=4818


virginia.smith@hp.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|                            |FIXED




------- Comment #1 from virginia.smith@hp.com  2007-07-25 04:16 -------
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!]

Received on Wednesday, 25 July 2007 04:16:43 UTC