This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 5119 - consolidate defs of uri and epr schemes in sml spec
Summary: consolidate defs of uri and epr schemes in sml spec
Status: RESOLVED FIXED
Alias: None
Product: SML
Classification: Unclassified
Component: Core+Interchange Format (show other bugs)
Version: unspecified
Hardware: PC Windows XP
: P2 normal
Target Milestone: LC
Assignee: Valentina Popescu
QA Contact: SML Working Group discussion list
URL:
Whiteboard:
Keywords: editorial
Depends on:
Blocks:
 
Reported: 2007-10-01 16:20 UTC by John Arwe
Modified: 2007-11-20 22:30 UTC (History)
0 users

See Also:


Attachments

Description John Arwe 2007-10-01 16:20:11 UTC
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)
Comment 1 Pratul Dublish 2007-11-08 20:10:28 UTC
As per editors, some of these changes have been made. Editors to review the bug and verify if some parts of this bug have not been fixed as yet
Comment 2 Kirk Wilson 2007-11-12 20:09:06 UTC
I would suggest that item (5) belongs in the SML definition of the epr scheme.  While I would agree that a sufficiently constrained reference scheme definition, one that defined the protocol binding used to interact with the service providing the document, would constitute a candidate for an interdocument reference, I don't believe we have determined how such a binding is to be provided.  I would go further: the epr scheme MUST provide a means to indicate the protocol binding (so that the message over the wire can be constructed from the scheme), and thus any epr reference could be specified as an interdocument reference!
Comment 3 Valentina Popescu 2007-11-20 22:30:21 UTC
fixed by previous changes as well as updates based on Sandy's inter-document reference proposal, checked in under defect 4777
http://lists.w3.org/Archives/Public/public-sml/2007Nov/att-0204/sml-if-idr-V1.html