[Bug 5119] consolidate defs of uri and epr schemes in sml spec

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

           Summary: consolidate defs of uri and epr schemes in sml spec
           Product: SML
           Version: unspecified
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Core+Interchange Format
        AssignedTo: cmsmcq@w3.org
        ReportedBy: johnarwe@us.ibm.com
         QAContact: public-sml@w3.org


SML already has formal sections defining these to ref schemes.  We do need to
update them to ensure they cover everything mandated in the recently accepted
reference proposal as being needed in a "complete" ref scheme definition.  As
part of doing so, 3.4.2 Definition of inter-document references in SML-IF can
be put on a diet - where it is partially defining these two schemes, move that
text to SML spec.

3.4.2 Definition of inter-document references in SML-IF changes:
(1) following text marked non-normative (free if 5091 is done, since it already
says "example")
"For example, an xsi:schemaLocation attribute is defined to be of type list of
xs:anyURI. These come in pairs, one for the namespace name, and one for a hint
as to the location of a schema document defining names for that namespace name.
This makes the "hint" URIs in xsi:schemaLocation attributes inter-document
references in the context of SML-IF."

(2) update "Similarly, an sml:uri element contained in an element marked with
sml:ref="true" is an inter-document reference because its content is of type
xs:anyURI and the definition of sml:uri is that the referred-to document can be
obtained by dereferencing the URI using the default retrieval action."
--- to either delete it entirely or reword as follows
"An instance of the SML URI scheme is an inter-document reference because its
reference scheme definition asserts this."

(3) add to SML spec's def of the URI ref scheme the content from "Similarly, an
sml:uri element contained in an element marked with sml:ref="true" is an
inter-document reference because its content is of type xs:anyURI and the
definition of sml:uri is that the referred-to document can be obtained by
dereferencing the URI using the default retrieval action." if it is not already
there.

(4) in the paragraph starting "In contrast, the wsa:address..."
from "...endpoint reference is         not an inter-document reference..."
to   "...endpoint reference is usually not an inter-document reference..."
(there is at least one case possible where it would be, read on...)

(5) to the paragraph starting "In contrast, the wsa:address..." append
"A sufficiently constraining reference scheme definition, e.g. one that
determined the protocol binding used to interact with the endpoint, MAY assert
that instances of the reference scheme are inter-document references."

(6) change the paragraph starting "SML-IF Consumers MUST interpret ..."
- add full stop after hints
- remove sml:uri assertion (this belongs in the ref scheme definition ie in
SML)
- remove wsa:address assertion (due to (5) above)

Received on Monday, 1 October 2007 16:20:23 UTC