| Linking WG | XML
Task list to complete before bringing XPointer and XLink to Proposed Recommendation status, c.f. the mail from Tim Bray on the subject. Items must be discussed in the XML Linking interest Group mailing list, with the proper issue tag [XLxx] or [XPxx] indicating then in the subject of the mail message.
Created Tue Jul 27, maintainer Daniel.Veillard@imag.fr, current version:
By unanimous decision from the XML Linking Working Group on 14th December 2000, this document status has been changed from W3C Member only access to publicly available.
Daniel Veillard, co-chair and maintainer of the Issue List.
Id: LinkingIssueList.html,v 1.208 2000/12/15 10:09:43 veillard Exp
Table of Content:
Color codes:
[XL1] Evaluate the level of HTML support and give feedback to the XHTML WGLloyd message reporting the problem Steven Pemberton's first Note on the subject Lloyd took the ACTION to work out this Liaison issue with Steve Pemberton http://lists.w3.org/Archives/Member/w3c-xml-linking-wg/1999Jul/0026.html This is urgent since XHTML is stuck in last call until this is solved Options:
Resolution: |
[XL2] Evaluate SMIL requirementsSMIL Requirements for XLink/XPointer http://www.w3.org/AudioVideo/Group/Linking/requirements-19990409.html This will affect the linking part of the SMIL v2 Working Draft They want: SMIL1. non-XLink attributes allowed on XLinks Decision: Yes/No SMIL2. add the "pause" attribute value to show= Decision: Yes, No, or it's moot because we lose show= SMIL3. Try to minimize the number of attributes required on the XLink constructs, even in the case where you can't default attributes Decision: Yes/No SMIL4. multiple locator attributes on one element Decision: Yes/No SMIL5. locator *attributes* and *elements* on same xlink Decision: Yes/No Resolution: 1/ yes 2/ no 3/ not changed 4/ no 5/ no See [XL78] |
[XL3] Evaluate SVG requirementsChris Lilley wrote to the CG: ------------- I really, really do not want to drop XLink and make up our own SVG-specific linking syntax but some of the SVG WG are pressing for this and are now making concrete proposals ("just the same as HTML 4.0 - href and src") so I would like some good news to report back to them, preferably of the form "XLink was published yesterday". To clarify, SVG is only using simple links, not compound links; and does not have a requirement to have multiple links per element. We are also using XPointer, and thus by implication (parts of) XPath. We use XLink for the following three cases:
--------------- One important point of the dependancy is that when SVG will go to PR it must have a stable (PR or PR ready) XLink draft to reference. This put a serious time constaint on XLink schedule. Options:
Tim Bray: Not an issue here; I think SVG is happy with us the way we are, take this point away Resolution: XLink fullfill SVG requirements, this was checked at the f2f in Sophia, item closed |
[XL4] Type and Role should be defined as primary web objectshttp://lists.w3.org/Archives/Public/www-xml-linking-comments/1999JulSep/0003.html Feedback from W3C staff and especially Tim BL Having URIs to describes type and roles is needed to avoid ambiguities, It's easy to find multiple meaning for our example role="essay" Using URI do disambiguate can be achieved by the way of a namespace added to the type/role or forcing type/role to be an URI. Options:
Resolution: This was actually extended later c.f. [XL75] |
[XL5] Relationship with RDFIt's in our requirements A simple example on how XLink constructs can be mapped onto RDF assertion is sufficient to fullfill this requirement. This can be kept as a internal WG document, promoted a Note or added as an appendix to Xlink WD Options:
Resolution: The Working Group will provide a mapping of XLink constructs using RDF. This will be non-normative and may be published as a separate NOTE. c.g. mails crossposted to rdf-interest list and IG. |
[XL6] Extending/Consolidating Extended Link groups in the draftThis is the part which was rewritten last, and it need some refinement, multiple complete example wouldn't hurt either this is new to most web authors. http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/1999Jul/0107.html Option:
Resolution: Consensus on 1/ with a subgroup refining the description |
[XL7] Clarify the Xlink/Xpointer processing model[discussed first but still open] [postponed by 3 weeks until SNIP proposal and understanding matures] This is a generic topic raised in a number of more specific context:
Resolution: on SNIP to be published as a WG NOTE after cleanup, this is pushed to the CG. Work on SNIP is postponed until XLink and XPointer are finished. Though some update in case of basic flaw may be done with WG consensus The Working Group got consensus on dropping the specification of the processing model |
[XL8] Survey the feedback on the comment lists (suppressed) reference |
[XL9] show="parse" underspecifiedIs show="parse" adequate to indicate an inclusion in an interoperable way? What are the infoset ramifications of such an inclusion? What is the interaction between show="parse" and the actuate attribute values? Should inclusion processing be left to the application, or should we define the processing model for inclusion? Should the syntax more clearly differentiate inclusion from other types of links? Options:
Resolution: consensus on show="parse" to be dropped |
[XL10] Relationship to the InfosetShould the presence of XLinks in a document affect the infoset for that document? http://www.w3.org/TR/xml-infoset Specifically, should the "arc expansion" currently listed in the conformance section be reflected in the creation of new infoset items? Under what circumstances are such arc expansions NOT performed (e.g. do we need a switch)? Options:
Resolution: |
[XL11] Leveraging refinementShould we define a "base class" of link from which other links can be derived? Do we need the global-attribute variation of XLink? Can we leverage a datatype mechanism such as that expected from the Schema WG for link recognition? Currently addresses (URI Reference) can be recognized by datatype, why can't "handles"? Can an extended link be derived from a simple link? Options for leveraging a datatype mechansim:
Resolution: 4/ deferred to Schema availability Options for the global attribute variation:
Resolution: 3/ done Options for the base link class:
Resolution: 3/ done |
[XL12] "Show" and "Actuate" controversy[Working group voted and decided to keep them] These are causing a lot of controversy. Possible decisions:
No consensus was achieved but a majority of the WG members expressed preference to keep those attributes. One more week is allowed for debates on this topic, but it's scheduled for closure next week. Resolution: show and actuate are kept |
[XL13] Hyperlinking versus linkingThe scope covered by the current WG charter is obviously a tiny subset of the class of interesting structured information relationships that can be modeled on the web in a way involving the use of URIs. What should this WG do about this problem? Possible decisions:
Group has general consensus on continuing work as chartered. It will keep the Working Drafts in the form they currently are. It is noted that Oracle and Microsoft have abstained to the strawpoll. |
[XL14] What is the final XLink namespace URIassuming we become a REC Possible decisions:
- consensus on http://www.w3.org/namespace/xlink/1999/ and http://www.w3.org/namespace/xpointer/1999/ Note that this is suject to final approval from W3C Web team who manages the URL space Update: This has been changed upon W3C webmaster request to: http://www.w3.org/1999/xlink The XPointer CR draft don't list any namespace |
[XL15] Arc linkage[XL15.1] arcs to be linked to locators how? Possible decisions:
[XL15.2] arcs to be linked to inline resources how? Possible decisions:
Resolution: |
[XL16] Arc/locator orderingShould we specify the order in which arcs & locators appear in a linking element? Possible decisions:
Resolution: We don't care about the order |
[XL17] TITLE attribute impoverishmentThe title is supposed to convey human-readable information. How do we deal with the fact that humans don't all speak the same language, or the case where the human-readable information isn't textual? Possible decisions:
there will be a <xlink:title> element for extended links, and simple links would use an xlink:title attribute. |
[XL18] ELG stepsShould there be a default, and what should it be? Possible decisions:
Resolution: No more step attribute and removing the non-indirecting version of extended link, and we are adding a note that user-agent may constraint the steps on the user's behalf. |
[XL19] Close up the remaining points for the XPath<->XPointer convergenceIssue closed:
If there is any left. I don't have that list handy could someone (Ron ?) forward it for inclusion ? My recollection is that there is no major issue left. Possible decisions:
Resolution: XPath is a REC |
[XL20] Evaluate the WAI requirementsThe initial issues raisedby the WAI Working Group in April: http://www.w3.org/WAI/PF/Group/xlink.htm The latest mail sent by Daniel Dardailler in June: http://lists.w3.org/Archives/Member/w3c-xml-linking-wg/1999Jun/0045.html They want [WAI1] If XLink is supposed to be used in all XHTML contexts where URI appears, special constructs for accessibility must be preserved like SRC and LONGDESC on IMG. Decision: Closed by WAI [WAI2] Expressivity of the ROLE attribute: Xlink should not result in a loss of functionality compated to HTML4 specific attributes, especially the MEDIA attribute Decision: Closed by WAI [WAI3] The need to develop an extensible repertoire of ROLE types, with common semantics, like PREV NEXT, TOC, etc. on HTML LINKs Decision: Closed by WAI [WAI4] Structured titles and the ability to include markup in the title Decision: already in XLink own issue list. [WAI5] link behaviour must be described in the XLink specification, in an appropriately device/medium-independent manner. Decision: It is expected that we have removed any device/media dependant parts, except maybe in examples. We should continue to check against that. [WAI6] Link activation mechanisms: lack of an equivalent in XLink to the HTML 4.0 ACCESSKEY attribute. Decision: Closed by WAI [WAI7] the XLink specification provides no counterpart to the HTML 4.0 attributes which permit script events to be attached to links. Decision: Closed by WAI [WAI8] Some combinations of Show and Actuate introduce new ways of implementing existing functionality, like OBJECT (embed, auto) or HTTP Refresh/Redirect. It should be clear what is the overall W3C strategy in all cases. Decision: Closed, one need more clarification. Showing how XLink could be used in an accessible way. WAI should provide guidelines on how to use those constructs in an accessible way. [WAI9] Adding in the conformance section: user configuration should have highter priority than default behaviour. Decision: Look at what SVG has done. Side note: the support for specific HTML constructs just piles up in various requirements. Wouldn't allowing the HTML attributes on XLink element, but associated to an HTML namespace solve the problem. If the XML processor happen to understand the HTML semantic, it will be able to make use of it, if not, well. At least it allows to borrow extra pieces, while avoiding to reference external specifications (HTMLx/XHTML) by copy inside XLink. Resolution: Was discussed at the f2f in Sophia, and the list points have been examined with a WAI representative. All issues are closed. |
[XL21] Dealing with relative URIs in XLinksXLinks specify resources using URIs. It would be best if relative URIs were allowed as well as absolute ones. Currently the XLink specification does not provide the equivalent of the HTML BASE element. Section 5.1 of RFC 2396[1] says: The term "relative URI" implies that there exists some absolute "base URI" against which the relative reference is applied. Indeed, the base URI is necessary to define the semantics of any relative URI reference; without it, a relative reference is meaningless. In order for relative URI to be usable within a document, the base URI of that document must be known to the parser. The base URI of a document can be established in one of four ways, listed below in order of precedence. [...] First in the order of precedence is: 5.1.1. Base URI within Document Content Within certain document media types, the base URI of the document can be embedded within the content itself such that it can be readily obtained by a parser. [...] Then other methods are given (Base URI from encapsulating entity, from the retrieval URI, and finally, provided as an application default). Options:
Resolution: Ron to update the proposal, send it to the CG, and try to get it as a more general framework. The XLink group would propose a base element with a propagation mechanism similar to the xml:lang one. Update: XML Base is now a separate specification handled in parallel to XLink |
[XL22] Implicit arcsDescription @@ Choices
Resolution: Consensus on removing all mention of implicit arcs |
[XL23] hub-view role Description @@ Resolution: @@ Dropped by lack of a clear description of the problem |
[XL24] HTML Support RequirementShould we change this text from 'must' to 'should', considering that we don't explicitly support HTML 4.0 linking constructs? Options for resolving the issue:
Resolution: Leave it |
[XL25] Simple Link RecursionShould simple links exclude xlinks as conforming content? The XHTML PR is an example of a simple link vocabulary that prohibits multi-leveled simple link content in the A element, see the XHTML draft. Proposal: The editors propose that a simple link conformance test be stated that a simple link can not contain any xlink linking elements, specifically simple and extended links. Ben Trafford notes that this might exclude some applications, where the actuation is automatic, allowing for the reification of multiple levels of links. However, perhaps that level of functionality is best left out of simple links? Options for resolving the issue:
Allow nested links, add non-normative examples to make sure implementors don't miss the point. Update: there is currently prose but no example @@ |
[XL26] Extended Link ValidationWe can't validate XLinks with a mandatory locator and optional arcs + locators. What does the DTD look like? Options for resolving the issue:
This is a limitation of current DTD syntax, can't ensure role usage. Problem in showing XLink DTD. arc*, loc, (arc | loc)* Eve to try to build that DTD, WG trust her on deciding on the quality of that DtD Update: Check Schemas support [XL79] |
[XL27] Conformance TestsThe set of conformance tests appears incomplete. Only 2 conformance tests are listed, along with an issue on simple link conformance. Options for resolving the issue:
Having a complete set described onto a single section seems hard, editors will try to keep a list (if needed by reference). Update: Will probably be needed to exit CR anyway (separately). |
[XL28] OBJECT fallback.The mapping of HTML to XLink raises some questions. What about the
HTML Options for resolving the issue:
Dropped. |
[XL29] Resource Media Specification.It's important that XLink does not result in a loss of functionality compared to HTML4 specific attributes. Particularly with regard to specifying the media type of the linked resource (as in the MEDIA attribute in HTML 4.0). There is a need to develop an extensible repertoire of role types, with common semantics so that they can be recognized and acted upon appropriately by a variety of user agents. HTML 4.0 LINK for instance suggests a simple set of pre-defined names for PREV NEXT, TOC, etc. XLink could go beyond these simple conventions and provide a more formal set and mechanism. Options for resolving the issue:
Resolution: not say anything on this subject Update: c.f. [XL60] |
[XL30] Event Association.Association of events with links: the XLink specification provides no counterpart to the HTML 4.0 attributes which permit script events to be attached to links. This issue is also related to the DOM work and the desire to provide a device-independent means of specifying and activating events. Options for resolving the issue:
Resolution: Event association can be done by adding attributes on XLinks, make sure that the fact that attributes not with xlink namespace can be added to XLink constructs is clearly stated in the WD, with example(s). Update: |
[XL32] Dealink with XLinks without xlink:hrefShall we have xlink:href being #REQUIRED or #IMPLIED ? on xlink:href being #IMPLIED and XLink WD to be edited to express that XLink processing should be stopped in the absence of xlink:href |
[XL33] link-events:Should XLink provide a counterpart to the HTML attributes that permit script events to be attached to links? This issue is also related to the DOM work and the desire to provide a device-independent means of specifying and activating events. We are inclined to let this be part of the application semantics of a language at a higher layer than XLink. Resolution: |
[XL34] arc-semantics:There are no Resolution: Update: c.f. [XL75] Add an xlink:arcrole attribute |
[XL35] require-xls-to-be-xml:Is it possible, given the expectations of Web architecture, for us to make a conformance constraint requiring that resources identified as external linksets be of Internet media type */xml or some derivative? Resolution: it's an error if a resource which is asserted to be an external linkset is not an XML 1.0 document |
[XL36] step-control:From Ben: Should control over accessing nested external linksets be brought up a level, so that the "XLink processor" (whether that's a UA or a server-side application, or perhaps has no interaction with the end user at all) rather than the application is the place where steps may be limited? In what sense is the "processor" different from the "application"? Resolution: not saying anything about this and make wording consistent using "application" |
[XL37] not-an-xlink:Would it be good practice to dictate an explicit value to use to indicate that the element is not an XLink element, e.g., "none" or something? Resolution: we'll add the value "none" to the reserved set of xlink:type attribute values |
[XL38] resource-media-specification:Should XLink develop its own an extensible repertoire of role types, with common semantics so that they can be recognized and acted upon appropriately by a variety of user agents? HTML 4.0 LINK, for instance, suggests a simple set of pre-defined names for PREV NEXT, TOC, etc. XLink could go beyond these simple conventions and provide a more formal set and mechanism. We are inclined, in general, to leave this to higher-level languages based on XLink. Resolution: |
[XL39] role-ns:Does the Namespaces specification allow our creation of roles as a new "symbol space"? At the very least, does it not disallow it? This issue is declared poorly framed and will be bypassed unless clarified with options. |
[XL40] display-centric:The behavior attributes are clearly quite display-centric, despite our attempts to them as being more generic. Can we motivate them in a less display-centric way? There is a point here, but it is relatively low-priority. If improvements can be made without delaying publication of the spec, they should be. |
[XL41] embed-where:From Steve: The instructions for where to embed a resource are not perfectly accurate -- there may be no next content; more important, there may be element and other boundaries in between, and this definition leaves it ambiguous on which side of them embed happens. We should explain that the scope of the source anchor matters: if you linked to a SEC, the embed happens at the Point (as defined now in XPointer) immediately following the SEC; if you linked to the range consisting of all the children of the SEC, you'd get the embed just inside the end of the SEC after the last child (you could also get that by XPointing [a new verb!] to that point explicitly). This would matter, for example, if elements were generating text before or after themselves for display, or leading/trailing vertical space, or if the user is supposed to follow the link and then be able to edit, or.... How can this description be made unambiguous? Intent: embedding occurs after the resource participating in the link. In the case of XML, the effect is clear [examples, maybe stolen from issue text]. If the resource is not XML, "after" has to be interpreted in light of the type of the resource. |
[XL42] what-to-replace:From Steve: A real issue we never resolved is the distinction in embed/new/replace semantics; we've left the intermediate case unnamed, where you want the destination anchor to replace the source *anchor*, not the source *document*; this makes a smooth sequence of 'what to replace': nothing (embed), the anchor (currently unnamed), the subresource (replace), or the window (new). Some might want to add something for panes, but that seems overkill (and hard to define consistently). Should the intermediate case be named and defined? Good idea, doesn't need to be in XLink 1.0 |
[XL43] behavior-ns:The final example in Appendix B implies that we have to leave the value space for show/actuate open, and that they have to be QNames just as role is! Is this acceptable? If so, the specification will require a bit of surgery to reflect this. Resolved by previous decisions. QNames are OK Update: QName use for role was removed, [XL75] xlink:arcrole |
[XL44] Inferred Link TypesSource: IG - http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Jan/0048.html Also see referal back to the IG - http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Jan/0059.html . Possible decisions: [http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Jan/0074.html ]
Resolution: Consensus on
The problem of handling naked href attributes (like in XHTML) is a separate issue [XL70] |
[XL45] Conformance clarification: mandate legal prefixes in attribute valuesSource: IG - http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Jan/0039.html Summary: Suppose I have an implementation that only recognizes unqualified values for "show", and it encounters an XLink with the attribute show="badprefix:foo", where the badprefix does not correspond to a namespace declaration in the document. According to bullet #3 of the conformance statement, it looks like I have to check for this error even though my implementation will treat it as undefined anyway. This type of error does not enhance the user experience of certain applications like browsers. Should we create an exception for this type of error? Possible decisions:
We got no clear consensus so the result is to keep the current state of the drafts i.e. 2/ Update: QNames are not used anymore for roles c.f [XL75] |
[XL46] Don't imply self-referential linksSource: IG - http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Jan/0044.html Summary: Implicit arcs exist from each resource to itself. This produces noise that prevents self-referential arcs from being used intentionally. Possible decisions:
In the case that a "to" is missing, there are explicit arcs from that resource to all others. Hence, the referenced paragraph is unnecessary and confusing and should be removed with appropriate editorial surgery. Update: Implicit arcs were dropped [XL22] |
[XL47] Ineraction between xlink:external-linkset and xlink:showSource: IG - http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Jan/0047.html Summary: What is the interaction between xlink:role="xlink:external-linkset" and show="embed" or show="new" or show="replace"? Possible decisions:
Option 1; "show" is ignored on external linksets. Actuate is ignored and treated as if "auto". |
[XL48] Remove simple linksSource: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0047.html Summary: Simple links should be removed from XLink. Users who require simple syntax have the options:
Possible decisions:
This is a previous decision of the WG; no dramatic new info or arguments. Keep them for now. |
[XL49] Split show into two attributesSource: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0028.html Summary: Suggests splitting show attribute into 2 attributes, the operation and the target. Also possibly add an html:show which is syntactic sugar for these new attributes. Possible decisions:
No support in the WG for adding this capability at this time. Good candidate for future enhancement, no architectural barriers to doing this in future. |
[XL50] actuate inadequateSource: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0028.html Summary: Actuate values are very display specific, which doesn't support multiple tiers of processing. Possible decisions:
No support in the WG for adding this capability at this time. Good candidate for future enhancement, no architectural barriers to doing this in future. |
[XL51] add functionality similar to XInclude's "parse"Source: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0028.html Summary: add "parse" functionality, or an even more powerful capability of indicating what processor to use to load the resource (which might be implied by type), as well as processor directives and/or a processor stylesheet url (which might be done some how as a complex xlink?). Possible decisions:
For the case of XML, this capability has explicitly been removed from XLink and placed in the XInclude work item now before the Core WG. Note that the show value is a QName, so you can introduce your own values from your own namespace to achieve media-type-specific semantics. Furthermore, you can add your own attributes to XLinks. |
[XL52] request for events to be attached to xlinksSource: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0031.html Summary: add scriptable event hooks to XLink Possible decisions:
Already considered and rejected for this release. [XL33] |
[XL53] request for Xlink to use SchemaSource: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0004.html Summary: Xlink to use Schema Possible decisions:
Schema not yet sufficiently mature. Update: see Schemas support [XL79] |
[XL54] Clarifications of "embed" of an XPointer.Source: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0017.html Summary: (Possibly XPointer issue?) Suggests that XPointers should operate differently when show="embed"? I (Jonathan) think this is more about what the meaning of an XLink with show="embed" of a nodes returned from an XML resource by XPointer. This type of thing is specified in XInclude. Possible decisions:
This is addressed in XPointer; some functionality with relation to the former "parsed" value now falls into XInclude. |
[XL55] Request to move ranges to XLinkSource: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0046.html Summary: Ranges belong in XLink, simplifies XPointer implementations. Possible decisions:
Considered fully by the WG and rejected for reasons that are on the record. |
[XL56] Use of QNames in Role isn't sufficientSource: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0020.html QName attributes are not sufficient for roles, roles should be a standalone element. Dave Orchard does not fully understand rationale for the counter proposal. I think that the author of XL56 has missed the point of the role, that it's for applications to use with arcs. In particular, I think the author gets confused about the use of role in a simple link. Possible decisions:
Issue superceeded by subsequent development see [XL75] |
[XL57] Editorial commentsSource: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0021.html, http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0005.html, http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0008.html Summary: 3.1.3 says the title element is called "locator". Possible decisions:
Addressed in the recent draft |
[XL58] Rename LocatorSource: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0006.html Summary: Locator become Remote and Resource become Local. Possible decisions:
no change, doesn't dramatiquely improve it and people are used to existing terminology |
[XL59] Make role nmtokensSource: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0008.html Summary: Make role nmtokens so that a resource could be used by multiple Arcs. Possible decisions:
good idea but too late for 1.0 see also [XL84] |
[XL60] Drop element syntaxSource: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0008.html Summary: Drop element syntax. Possible decisions:
done, accepted |
[XL61] Arc clarificationSource: comments list - http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0008.html Summary: The text in section 3.1.4 be revised from "locator-type element" to "locator- or resource-type element". Possible decisions:
Fixed, done. |
[XL62] Underdefined LinksetsSummary: In section 3.1.5 and other areas, the concept of an "external linkset" is underdefined. Specifically, the interaction of the external linkset with other behaviour-based information (such as show="", etc.) is undefined. Possible decisions:
substancially adressed in recent draft |
[XL70] Attribute recognition in XLinkSummary: Right at the moment, Xlink provides only one way to recognize its attributes: place them in the xlink namespace. So a simple link looks like <someTag xlink:type="simple" xlink:href="whereToGo"> One problem with this is that it makes it difficult [impossible?] to grandfather HTML links, because in <html:a href="whereToGo"> the href is not in any namespace, and cannot be in any namespace while still conforming to HTML rules. So... we could assert that if it says "xlink:type", then all other xlink attributes are recognized if they're in either the xlink namespace or not in any namespace; so <a xlink:type="simple" href="whereToGo"> is an xlink; and if you default the xlink:type value in the internal subset, you're left with <a href="whereToGo"> and HTML links are now Xlinks, hurray! hurray! On the other hand, if Xlink is going to recognize "naked" href attributes, what about naked "role" "show" and "title" and so on; this severely gets in the way of language designers who can't turn something into an xlink without having it grab a bunch of attributes. Another suggestion is due to Steve DeRose; it is an intermediate position, whereby xlink can signal whether or not it should process non-namespaced attributes. This could either be done with another value of the "xlink:type" attribute or with another attribute. <a xlink:type="simpleAndHungry" href="whereToGo"> or <a xlink:type="simple" xlink:eatNakedAttributes="true" href="whereToGo> and with attribute defaulting, either could be the HTML we know and love. The XLink WG has already rejected the "always eat naked attributes" proposition a couple of times, and I doubt it would be fruitful to re-open this. However, the intermediate position described just above did gather quite a bit of WG-member support. It seems like a pretty straight cost-benefit tradeoff. Grandfathering HTML is good, and arguably in our requirements. Adding new syntax has a cost. Possible decisions:
Not effective consensus on adding naked attribute support on XLink => The WG is not meeting requirement on this issue (HTML and SMIL) c.f. [XL78] and [XL83] Followup: this generated a CR exit criteria constraints of showing how this could be achieved using XML Schemas. The criteria was met by publishing a NOTE XLink Markup Name Control showing an example of Schemas fragment using types to carry the XLink semantic and how to import it when defining a Schemas for a new vocabulary, allowing in effect to associate XLink semantic to any attribute. |
[XL71] embedding when resources are sets of locationsSource: Erik Wilde feedback http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0054 Summary: the problem of embedding when the starting and/or ending resources are sets of locations. Actually, the problem isn't strictly limited to embedding behavior; there are questions no matter what the traversal behavior is. We need to decide what to do about this... Possible decisions:
Resolution: Here is a rationale for handling set of locations:
The draft will be updated with a precise description |
[XL72] legal-implicationsSummary: I just wanted to record this, so we don't lose it for V2.0. In my class we spent a little time talking about the legal implications of "embedding" someone else's stuff. (This isn't a problem unique to XLink, since HTML IMG has it too, but because XLink lets you embed XML content, the issue rises in importance.) Two years ago, Steve DeRose and I batted around an idea for how to protect document authors from unauthorized transclusion, based (I believe) on an idea that originally came from Ted Nelson. The idea is to add an attribute that contains the URI of a permission-granting authority, with a default that presumes you have obtained permission if necessary. I'll let Steve chime in with the details Possible decisions:
Resolution: 3/ it is not really one of our requirements, not for V1. However this is an important issue Suggestion: Add a PI, similar to the robots PI, that says "Don't transclude me" (that is, don't embed any of my content) |
[XL73] multiple-onLoads-with-show-replaceSummary: If you have a document with more than one onLoad arcs starting from it, and show="replace", how do you handle this? It's easy to see what to do with show="new" (open a bunch of windows) and show="embed" (augment the content in a bunch of places), but if show="replace", our processing model is underspecified with regard to what "loading" means. Possible decisions:
Resolution: A minimalist definition of the behaviour in that specific case will be added to the specification. DavidD to provide it, done. Is this really closed @@ ? |
[XL74] external-linkset-spellingSummary: To be consistent, the role value "<prefix>external-linkset" should be spelled "<prefix>externalLinkset". Possible decisions:
Resolution: 2/ we should use camel case spelling. So change it to externalLinkset |
[XL75] Add an xlink:arcrole attributeSummary: an xlink like the following: ...as discussed in [<a xlink:type="simple" xlink:href="...some URI...">Smith95</a>]... Cannot be mapped to RDF we need a role. But if we just add xlink:role to the link above, the role is describing the ending resource, not the relation between the start and end of the link. There seem to be a couple of arguments for it. It reduces the number of ways we are overloading "role", and it lets simple links provide roles on arcs as well as roles that provide type information about the resource at the destination of a link. The example might become: ...as discussed in [<a xlink:type="simple" xlink:href="...some URI..." xlink:arcrole="arg:rebuttedBy" xlink:role="doctoralThesis">Smith95</a>]... There are also at least a couple of arguments against it. One is quite simply that its late in the game and maybe we really don't need this. If people want to map to RDF they will be happier with extended links anyway. Second, and more serious, is that it is going to take some real concentration to develop a good mapping to RDF, and what we do in haste now we can regret in leisure in the future. For example, what is the starting resource in the example above? The string "Smith95"? But in RDF, properties don't originate from strings, they originate from resources. So do we use an XPointer that addresses the occurrence of "Smith95"? Or do we say the entire starting document is rebutted by Smith95. Possible decisions:
Resolution: 3/ adding xlink:arcrole to simple links |
[XL76] Add a robot PIThis issue was raised by Walter Underwood on the 21st of March: http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0087.html He wants: A "robots PI", as described at http://homepages.go.com/~wunder0/robots-pi.html. Options:
Decision: 3/ not added. This a separate mechanism. This should however be sent to W3C as a Note and companies from WG members are ready to support this submission to W3C. Reply sent. |
[XL77] DOM WG CommentsLauren Wood, of the DOM WG, raised the following issues: http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0087.html 1) DOM doesn't handle qualified names in attributes. They are concerned that this is problematic. 2) In 3.1.3, XLink uses a URI/local name pair, without specifying the syntax, and there is a possibility that the prefix was meant, rather than a namespace URI/local name pair. This should be clarified. Given the way the DOM models namespaces, using URI and local name actually makes more sense (where possible) than using a prefix. 3) 3.1.5 - it appears the entire (potentially large) document must be searched to resolve XLinks (although DTD declarations could help). This could be expensive in a large document, no matter how efficiently implemented. We suggest some guidance to users for large documents, such as encouragement to declare XLink as early in the document as possible. This applies to both external linksets and out-of-line links. Resolution: This is really based on a particular type of XLink implementation and discussing non normative behaviour. 4) 3.6.1 - Prefix-in-attribute-value; the "show" attribute contains a QName, whose prefix must be declared but must not reference XLink's namespace. This is a specific instance of our concerns with prefixes and namespace. There also seems to be a descriptive conflict here when it says that other values "must" be interpreted as "undefined". 5) 3.6.1. embed: - there is no way in the DOM currently to go from the document to the embedded document. This would be left to the XLink implementation. Resolution: Currently there is no XLink specific DOM API. Until such an API get defined there won't be a way to get access to the embedded object instance. Decision: 1) 2) and 4) are about the use of QNames in some attributes. This is currently being discussed in the IG. Resolution on 1) 2) and 4): QName use in attributes is removed, this was done in two steps:
|
[XL78] SYMM WG CommentsAaron Cohen, of the SYMM WG, raised the following issue: http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0082.html Basically, the SYMM WG feels that the XLink WG didn't meet its requirement to produce a syntax that would allow for recognition of XLink-style semantics on foreign elements, such as SYMM and HTML. Options:
Resolution: Add wording to the DoC. This issue relates to [XL70] and we provide the same answer |
[XL79] Schema WG CommentsC. M. Sperberg-McQueen, of the Schema WG, raised the following issue: http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0081.html The Schema WG believes that the specification would be stronger and XLink applications would be more interoperable if a XML Schema for Linking were included in the specification. Since this would not change the XML document syntax nor the processing implementations they request that this be done during the Candidate Recommendation period. Options:
Resolution: 2/ This was already decided previously [XL53]. The WG noted it was not needed right now, but it's a good idea we will try to build it during CR stage. |
[XL80] I18N WG CommentsMartin Dürst, of the I18N WG, raised the following issue: http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0079.html 1) The definition of "URI reference" should be changed to make sure that the provisions of http://www.w3.org/TR/charmod/#URIs are taken into account. This applies to the definition just before Section 2, and to Section 3.4. [as already discussed in another forum, the provisions should be included in the XLink spec rather than being referred to] 2) 3.1.4: 'multiple titles are necessary for internationalization purposes': This sounds good, but it should be clearly defined how these are supposed to be selected (e.g. say something like: If multiple title elements are present, and they have different values of the xml:lang attribute, then for display,... the language variant that is most suited for the user should be choosen). (for further details, a pointer to the HTTP spec or the SMIL 1.0 spec would also help). Options for XL80:1:
Cover the Character Model URI provisions. Eve's recommendation: Based on what we've done for XPointer and further conversation with Martin, it's best to restate the Character Model draft's description of proper URI encoding; however, don't define the parts of a URI reference, but rather rely on the reference to RDF 2396 for this. Provisional status of the spec: Section 5.4, Locator Attribute (href), goes into detail only about the tricky character encoding stuff a la XPointer, but does not define URI reference internal structure. Resolution: Follow the editor suggestion: charmod being just a WD, the prose should be added to the XLink WD, like we did for XPointer Options for XL80:2:
Give guidance on how to select different titles based on language or locale. Ben's recommendation: Add the suggested text, because Martin has a good point. Provisional wording in the spec (5.1.4 Titles for...), which motivates title elements better but does not do what was asked for: "One common motivation for using the title-type element is to account for internationalization and localization. For example, title markup might be necessary for bidirectional contexts or in East Asian languages, and multiple titles might be necessary for different natural-language versions of a title." I have neglected to add Martin's recommended wording in the 20000418 version, but plan to in the next one. Resolution: Follow Eve suggestion and reuse Martin wording : "If multiple title elements are present, and they have different values of the xml:lang attribute, then for display,... the language variant that is most suited for the user should be chosen). (for further details, a pointer to the HTTP spec or the SMIL 1.0 spec would also help)." |
[XL81] Martin Dürst CommentsMartin Dürst raised the following issue: http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0080.html 1) Only RFC 2396 should be cited, or RFC 2396 should be clearly identified as normative, whereas the other URI-related RFCs should be clearly identified as obsolate. 2) In 2.3, Attribute defaulting is introduced. However, because the DTD fragments with the defaults appear only some pages later, the rest of section 2, and the first part of section 3, is rather difficult to read or understand. Reorganizing the spec on a large scale would solve that problem. In 2.3, at least one example with all the relevant DTD fragments should be given. A similar problem happens in the Note before the example before 3.1.1: the meaning of the note is very unclear until much later. 3) 'CompSci' as a title value should be expanded to 'Computer Science'. Otherwise, it may be difficult to guess for people without English mother tongue. 4) In 3.1.3, 4. paragraph, there is a spurious space that is part of the link after (show and actuate). 5) The use of 'cname's for roles is frightening. Using URIs directly would simplify things a lot. Options for XL81:1:
Remove references to RFC 1738 and 1808; leave only 2396. Eve's recommendation: Do this because the two are out of date. Provisional status of the spec: All references to the bibliography entries for 1738 and 1808, along with the entries themselves, have been removed. Resolution: agreed with recommendation Options for XL81:2:
Attribute defaulting is confusing. Eve's recommendation: Take this entire suggestion. Provisional status of the spec: In Section 5.1, the Note before the example has been removed, and the example is now a complete version, with bits of it being excerpted in all the sections that follow. Resolution: agreed, with the comment and Eve suggestion. The WG trust Eve to clarify the example. Options for XL81:3:
Expand "CompSci" to "Computer Science." Eve's recommendation: Do this. Status of the spec: I neglected to do this in the 20000418 version, but plan to do it in the next one. Resolution: agreed Options for XL81:4:
Can no longer find the example where the spurious space appears. (The section numbers and examples were both heavily reorganized.) Resolution: dropped due to reorganization of the specification, the problem don't show up anymore Options for XL81:5:
Don't use QNames for roles. This was decided and implemented last week. Resolution: agreed, already done in the last draft |
[XL83] HTML WG Comments, Part 1Steven Pemberton, of the HTML WG, raised the following issue: http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0073.html Xlink does not meet the basic requirements it set itself, nor of its 'customers', and as such is insufficient for the needs of the future web. Any linking proposal that requires documents to be changed in order to use linking is not suitable. The proposal in Steven's mail could leverage the current Xlink proposal to create a description language that does meet the original requirements, without needing too much extra work or time. The proposal is detailed in Steven's mail. Options:
Resolution: Add wording to the DoC. This issue relates to [XL70] and we provide the same answer |
[XL84] Multiple RolesPhilippe Le Hegaret raised the following issue: http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0070.html He would to know if the issue of having multiples roles on the role attribute (and from/to attributes) has been considered by the linking WG. He notes that this is only a syntactic issue and it doesn't change anything in the semantic of XLink. Options:
Resolution: Not for version 1.0, schema may help do this in the future. This issue was already decided [XL59] |
[XL85] Editorial NitsDan Connolly made the following suggestions: http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0068.html 1) Move section 4. "Processing and Conformance" before section 3. As it is, while reading thru the spec, until he got to section 4, he didn't know the focal point of the spec, and he wasn't really sure which end was up. 2) Also, move the may/must RFC2119 para under the conformance heading, and move 1.3 Terminology under there too. This will make the separation between the "fluffy" stuff in section 1 and 2 and the more formal stuff that's now in sections 3 and 4 more clear. 3) Dan suggests that we review to be sure that we are actually using the may/must/should terminology consistently. I suggest you do that, and mark up such occurences ala may in the generated HTML...maybe use CSS smallcaps in the stylesheet. Currently, there are several occurences of "can" that seem like they are intended in the RFC2119 sense of "may"; e.g. in 2.3 Attribute Value defaulting: "attribute defaults (fixed or not) can be added to a DTD..." . 4) Continuing down that list, Dan suggests moving [Definition: ] arc into the context of section 3.1.3 "Traversal rules ...". If we want to collect the terms and definitions into a glossary, very well, but Dan thinks that we ought to make that glossary refer to the definitions in context, rather than trying to make it stand on its own. Dan prefers such a glossary to go at the end, ala an index, but putting it up front is OK as long as the forward references are clear. Options for XL85:1:
Options for XL85:2:
Options for XL85:3:
Options for XL85:4:
All of Dan's suggestions have been provisionally done; basically, the reordering of chapters was undertaken to put Conformance stuff before the substantive XLink markup stuff, the glossary was turned into a Concepts section, and syntactic terms are defined when used. Eve really likes it. :-) Resolution: the WG agreed with Dan's comments. Eve already implemented the changes. |
[XL86] Henry Thompson's Technical ConcernsHenry Thompson had the following technical concerns: http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0067.html 1) Although 'must' etc. are used as per IETF whatever, no discussion of error behaviour is provided, i.e. in section 4.3 point 2, nothing is said as to what "observing the mandatory conditions" means -- complain, halt and catch fire, what? Henry is asking what applications should do when they don't "observe the mandatory conditions." This is a statement of what an application must do to be considered conforming, so there is no prescribed behavior when an application doesn't conform. There are few mentions of "must" application behavior anyway (allowing the suspension of linkbase list processing, ignoring behavior attributes on linkbase lists). Recommendation: No change. If Henry is, rather, asking what the prescribed behavior is when an application performs "markup testing" (think of it as XLink-specific validation), we don't say. Should we? Ben's recommendation: "Don't define error conditions, as it would require huge amounts of text and has been the source of contentious disagreement in the WG." 2) The definition of 'application' in the (presumably normative) terminology section (1.3) implies that a conformant processor of _any_ document with linked-from resources must recognise that fact. This is clearly too strong a requirement in the case where the document in question contains no linkset information. Ben's recommendation: "Modify the definition of 'application' to exclude 'linked-from' documents. Such a definition could be: 'An XLink application is any software module that interprets XML documents containing XLink links. This specification defines conformance requirements for XLink applications.' Provisional wording in the latest spec (3.3, Application Conformance): "An XLink application is any software module that interprets well-formed XML documents containing XLink elements and attributes ..." 3) Henry saw nowhere which made clear whether the term 'element' throughout, and particularly in section 4.2, refers to an Element Information Item as defined in the Infoset PWD, or to a character sequence in an otherwise non-well-formed non-XML document, or what. Ben's recommendation: "Reference the Infoset definition of an Element Information Item." Provisional wording in the latest spec (3.3, Application Conformance, continuing from the ellipsis in the above paragraph): "..., or XML information sets [XIS] containing information items and properties corresponding to XLink elements and attributes. (This document refers to elements and attributes, but all specifications herein apply to their information set equivalents as well.)" 4) Henry thinks that if you're going to describe the 'show' attribute as having QNames as values, then ignoring the default namespace declaration is a serious mistake. If it's a QName, then its qualification is determined by XML Namespace REC rules. If its qualification is _not_ determinied by those rules, it's not a QName. He thinks we have several options:
5) Henry notes that the concerns raised in section 2.5, and in particular the issue of legacy 'naked' href, can probably be addressed by XML Schema. Henry hopes the timing is such that we can include an XML Schema for XLink in the REC. 6) In 3.1.5, I'm not sure that requiring sensitivity to role=xlink:external-linkset _anywhere_ in a document is coherent -- at the very least it seriously disadvantages streaming processors. Options for XL86:1:
Options for XL86:2:
Options for XL86:3:
Options for XL86:4:
Options for XL86:5:
Options for XL86.6:
1) rejected ... however We should keep the word "must" and add a clarifying note of what it We should keep the word "must" and add a clarifying note of what it means to not meet a "must" in XLink specification. 2) Accepted, the definition in section 3.3 has been changed to avoid that problem 3) Accepted, the definition in section 3.3 has been changed to make reference to XML Information Set, and the fact that the XML document is well formed. 4) Accepted, the definition of these attributes have been changed. The original role attribute has been split into two attributes, role and arcrole containing URI references. The show and actuate attributes must pertain to a reserved set of predefined values. The Working Draft 18 April 2000 (members only) @@ reflect those changes 5) Dropped for the moment. XML Schemas is not likely to go to REC before XLink, so providing a normative XLink schemas definition would be a problem. However some members of the Working Group have provided a first schemas for XLink constructs (members only). We expect this to be developped more during Candidate Recommendation phase, hoping that support of attribute remapping will be possible. 6) Drop, external linksets are extended links, XLink conforming applications must handle extended links anywhere in the document, including the case of external linksets. However add the following sentence to 5.1.5 Locating Linkbases at the end of the 4th paragraph: "To ease XLink processing, document creators may wish to define linkbase arcs near the beginning of a document." |
[XL87] Henry Thompson's Editorial ConcernsHenry Thompson had the following editorial concerns: http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0067.html 1) All the contributing systems mentioned in 1.1, including HyTime and TEI as well as Dexter etc., should have references. Make bibliography references to HyTime, Dexter, etc. Done. 2) Please clarify the interaction of xlink:href and XBase. In
particular, Henry can't tell whether Clarify the interaction of xlink:href and XML Base, especially when xlink:href="". Eve's recommendation: No action needed, because "" is not a relative URI; rather, it always means the resource in which the "" value appears. Provisional status of the spec: No change. 3) The second figure in 3.1.5 has xlink:extended-linkset where it should have xlink:external-linkset. Misspelling of external-linkset. Obsoleted by naming changes. 4) 3.4: "The URI-reference must be receive" -> "The URI-reference must receive" "be receive". Famous typo, fixed long ago. 5) last line in 3.6 intro above 3.6.1: "actuated=" -> "actuate=" "actuated" typo. Fixed. Options:
Resolution: Accepted all points have been corrected. The handling of xlink:href="" is defined in RFC2396, some prose was added to section 5.4 to clarify its meaning. |
[XL88] Terminology IssuesBob DuCharme had the following terminology concerns: http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0058.html1) Since we allow for XML links to exist that are not defined as XLinks, then when we refer to HTML links in section 1.1 we ought to say: "automated translation of HTML links to XLink links." 2) "Document creators can use the XLink global attributes to make the elements in their own namespace." What does we mean by "make"? Isn't there a more appropriate verb to use here? 3) Bob believes that we should reinforce the idea of simple links as being subsets of extended links, rather than different links altogether. Options for XL88:1:
Options for XL88:2:
Options for XL88:3:
Resolution: Accepted, though the comment was targetted at an older version. New version of the spec implement the changes, which were accepted c.f. http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0060.html |
[XL89] HTML WG Comments, Part 2Source: HTML WGhttp://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0006.html Summary: 8 technical and editorial issues
1) Accepted replace "structures that can describe the simple unidirectional hyperlinks of today's HTML" with "structures that describes links similar to the simple unidirectional hyperlinks of today's HTML, ...." 2) Dropped: the definition of the title attribute and elements have been refined in accordance with the I18N working group. They are optional, if another title construct get normalized it will be easy to use it on XLink construct. In the meantime XLink will provide it's own optional construct. 3) fixed 4) fixed example was rewritten, and there is only one course element at most 5) Dropped: definition in 2.3 is here to define the terminology precisely 6) Fixed |
[XL90] Linkbase lists as first-class citizensSource: Eve Malerhttp://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Apr/0060.html Summary: The topic of whether linkbase lists (previously called external linksets) should have their own element type is (re)opened Once upon a time, this had its own element. Last year, it was folded into the extended link element, and was given a special role value so that the two could be told apart. In March, fresh from XTech where I got a related suggestion, I promised/threatened to put forth a proposal for making it separate again. Here it is, finally. Sample declarations: <!-- Has only the type attribute; contains locators --> <!ELEMENT lbl (linkbase*)> <!ATTLIST lbl xlink:type (linkbaseList) #FIXED "linkbaseList"> <!-- Same attribute list as for all locator-type elements --> <!ELEMENT linkbase EMPTY> <!ATTLIST linkbase xlink:type (locator) #FIXED "locator" xlink:href CDATA #REQUIRED xlink:role CDATA #IMPLIED xlink:title CDATA #IMPLIED xlink:label NMTOKEN #IMPLIED> Sample instance using these declarations: <lbl> <linkbase xlink:href="linkbase1.xml" /> <linkbase xlink:href="linkbase2.xml" /> <linkbase xlink:href="linkbase3.xml" /> </lbl> Pro:
Con:
Check the thread called Linkbase list as first-class citizen: a proposal Possible decisions:
- We should not say that the linkbase is loaded automatically but be processed depending on the value of the value of the xlink:actuate - we should add an example |
[XL91] XML infoset enhancementsSource: Eve Maler http://lists.w3.org/Archives/Member/w3c-xml-linking-wg/2000Apr/0085.html Summary: An XLink infoset could be a WD or Note separate from the XLink spec, and on a different schedule, so it's not impossible to imagine our tackling this. Until we could sync them up somehow in a later version, the infoset could be an important advisory adjunct to XLink, much as the XML Infoset spec is. I've seen some of the havoc that lack of an infoset has caused XML, and it would be great to avoid it here. Also, the IG doesn't seem overwhelmed at the moment, now that the bulk of the design work is done, so I would argue they have the cycles. I don't advocate turning XLink into a "transformational technology"; it shouldn't affect the infoset property values of any source XML document that contains a link or a starting resource. Rather, I want us to consider creating a data model that describes the information items and properties that XLink applications produce. My main reason is that the exigencies of XML force us into a certain expression of links, but conforming XLink applications actually need to translate this into "native" linking terms in order to implement whatever behavior is called for, or at least pass the info on to a downstream app that does the real work. This should increase interoperability, so that you could more easily plug different basic XLink implementations into an application framework. As an example of how XML and XLink "native models" differ, a starting resource for a third-party (out-of-line) link may be invisible to an XLink application unless it has been fed the appropriate linkbase. The XLink model of a document containing the starting resources will report nothing in one case, and something very significant in the other. This is markedly different from the raw XML infoset for a document that you would get out of a parser. Some counter-arguments: I realize that even though XLink isn't a huge language, this isn't a trivial piece of work. If we *had* developed an infoset simultaneously with XML 1.0, it never would have been delivered on time. Also, if we do want to include it in XLink itself, it's useful to remember that coverage of infosets can seriously bulk up a spec (witness XML Schema Part 1). Check the thread XLink infoset: worth discussing? Possible decisions:
Resolution: Wait after REC, not in 1.0 |
[XL92] providing checksum on locatorsSource: [XPR4] Checking the resource content Summary: by adding a mechanism to provide a checksum on a locator we would fullfill our requirement from XPR4 This was discussed on the IG list. Possible decisions:
Resolution: not in XLink 1.0. Current developements in XML Dsig may provide the mechanism for us. |
[XL93] "Multiple nodes" problemsSource: James Clark http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0186.html Summary: language is unclear language is unclear why the behavior is supposed to be different for starting vs. ending resources how ranges and points are to be handled At first the WG believed it was linked to XL98, but James provided a more elaborated request: I also don't think XL93 is the same as XL98. The parts of my message covered by XL93 were about starting resources, but XL98 is about ending resources. I think the decision in XL98 should be generalized to say that the treatment of multiple node starting resources is application dependent as is the treatment of multiple node ending resources. Possible decisions:
Decision: 2/ update the specification to say that the treatment of multiple node starting resources is application dependent |
[XL94] Presentation of ending subresources is unclearSource: James Clark http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0186.html Summary: Presentation of ending subresources is unclear In general, I was unable to understand from the description of the show attribute what the intended behaviour was when the ending resource was a fragment of a complete document. Should it extract the fragment and display just that or should it display a window on the complete document with the document scrolled so that the start of the fragment is in the window? At first the WG believed it was linked to XL95, but James provided a more elaborated request: I don't think XL94 is the same as XL95. My point in XL94 was that I couldn't understand what the spec requires. For example, for "embed" the spec says "An application traversing to the ending resource should load it in place of the starting resource". Suppose I have an XPointer that points to a paragraph within a document. What does it mean to "load" that paragraph in place of the starting resource? It is not at all clear from the spec. Specifically, the distinction between XInclude embedding and XLink embedding which is very helpfully explained in the Linking and Style document doesn't come through. Merely saying that "embedding affects only the presentation of the relevant resources; it does not dictate permanent transformation of the starting resource" isn't enough: that doesn't effectively exclude the XInclude approach. >From the decision on XL95, I gather that the intent is that the presentation context is application-dependent. If you don't say this explicitly, people won't figure this out. For example, the difference between "replace" and "embed" is naturally understood as saying something about the difference in presentational context of the ending resource. If it's really just constraining how traversal affects the presentation of the starting resource, then that needs to be spelled out. Possible decisions:
Decision: 2/ update the specification to say that the presentation of embedded resources is application dependant. |
[XL95] Presenting an Ending Resource in a Larger ContextSource: XSL/XML Linking Task Forcehttp://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0170.html Summary: adding link metadata that will let link authors specify their desired values for Processing and Presentation Context as necessary The Linking WG has occasionally discussed (without resolution) the problem of controlling the presentation of an ending resource such that some larger scope surrounding it can be displayed along with it, to provide context for understanding the resource. The task force came up with two new concepts to describe how to achieve this control: Processing Context and Presentation Context.[3] We were able to interpret the current XLink state of the art as "defaults" for "settings" of these two contexts, but it would be ideal to offer link authors real control over them. We ask the WG to consider, in a future version of XLink, adding link metadata that will let link authors specify their desired values for Processing and Presentation Context as necessary. [3] http://www.w3.org/XML/Group/2000/08/NOTE-xml-link-style.html#sec-link-traversal-concepts Possible decisions:
Decision: Deferred, adding this at CR is not reasonable, not in v1.0, TODO list for next version of XML Linking |
[XL96] Choosing a Stylesheet to Use for Presenting an Ending ResourceSource: XSL/XML Linking Task Forcehttp://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0170.html Summary: adding link metadata that will let link authors specify their desired stylesheets There is a question about what stylesheet to use to present an ending resource to a user.[4] There are some reasonable defaults that a processor to take advantage of; for example, the embedded material may come from an XML document that has a suitable stylesheet PI in it. However, in the case of embedding, a different default may suit. In any case, it would be useful to provide a way for link authors to override this and choose their own stylesheet. We ask the WG to consider, in a future version of XLink, adding link metadata that will let link authors specify their desired stylesheets for presentation of ending resources. [4] http://www.w3.org/XML/Group/2000/08/NOTE-xml-link-style.html#sec-link-traversal-concepts Possible decisions:
Decision: this was already raised in the past, deferred, adding this at CR is not reasonable, not in v1.0 |
[XL97] Behavior of Multiple onLoad/replace Links in a DocumentSource: XSL/XML Linking Task Forcehttp://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0170.html Summary: recommend that the first onLoad/replace link encountered by an XLink application in the course of presentation be processed. Currently, the XLink specification says that the first occurrence (in document order) of such a link is the one that should be processed, and provides other guidelines as well.[5] In the specific case of XSLT, source document order is not necessarily used for processing of that document; it is under the stylesheet author's control. And in the general case, source document order cannot be guaranteed to be used by every styling technology. In addition, an onLoad/replace starting resource may be transformed in such a fashion that it disappears from the displayed output. Therefore, we suggest[6] that the specification be changed to recommend that the first onLoad/replace link encountered by an XLink application in the course of presentation be processed. This is naturally application-dependent, but more importantly it is also stylesheet- (and stylesheet technology-) dependent, which we think puts the control in the right hands. [5] http://www.w3.org/TR/xlink/#actuate-att [6] http://www.w3.org/XML/Group/2000/08/NOTE-xml-link-style.html#b2ab5b5b7b9 Possible decisions:
Decision: change the Multiple onLoad/replace Links in a Document are handled in application dependant way |
[XL98] Non-Well-Balanced and Discontiguous Ending ResourcesSource: XSL/XML Linking Task Forcehttp://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0170.html Summary: only requiring that if some ending resources are presented, then all must be made accessible to the user Currently, the XLink specification says that ending resources that consist of other than a single node should be presented as a "unified concatenation" of all the content in the location set.[7] We believe that this description is underspecified. There are two main cases of arbitrary location sets that need special consideration: "non-well-balanced" ranges and discontiguous series of ending resources. Concatention seems to apply to treatment of the latter case; however, we suspect that something like "aggregation" would be a more useful concept than true concatenation. In addition, aggregation is only one of a variety of possibly useful presentations (for example, providing a menu that allows for easy navigation to each location, presenting an entire document but putting the individual locations into reverse video and positioning the document view at the first location, and so on).[8] Therefore, we recommend that the specification be changed to allow for such a variety of presentations, possibly only requiring that if some ending resources are presented, then all must be made accessible to the user (that is, none should be deliberately suppressed). Possible decisions:
Decision: Accpted modifiy the description of the problem stating that it is application dependant, remove "concatenation" |
[XL99] Editorial: Missing textSource: David Olson http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0010.html Summary: Text is missing from the intro. It seems that between "A simple case of a hyperlink is an HTML A element, which has these characteristics:" and "This set of characteristics is powerful, but the model that underlies them limits the range of possible hyperlink functionality." there was intended to be some list of characteristics of the HTMl a tag. Possible decisions:
Decision: 1/ fix it |
[XL100] Editorial: VariousSource: Susan Lesch http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0012.html Summary: Various copy edits. After clause 1 par. 3, "these characteristics:", the characteristics seem to be missing. In 2.3 par. 2, "the the" -> "then the" In the illustrations extended-ool.gif, extended-inl.gif, extended-arcs.gif, and simple.gif (in clauses 5.1, 5.1.3, and 5.2), it might help if "loc" and "rsrc" were spelled out. Also, the GIFs are black on transparent which in rare cases can be invisible. Black on a white background would match the W3C style sheet and still be legible for people who have a user style sheet set to light text on a dark background. In the example in 5.1, unless they are acronyms understood internationally, I would spell out "teaching assistants", and spell out "Grade Point Average" near the first time GPA is used. In 5.1.5, in the paragraph between the example tables, "that serve as starting resource" -> "that serve as starting resources" or, "that serve as a starting resource" In 5.4 par. 3, "crosshatch (#) and percent sign (%) characters." -> "number sign (#) and percent sign (%)." (See http://charts.unicode.org/PDF/U0000.pdf. Thanks to Martin Duerst for pointing this out in XML Base.) In A.1., the RFC 2396 URI could be IETF's at http://www.ietf.org/rfc/rfc2396.txt Possible decisions:
|
[XL102] Editorial: Fix example in Section 5.2Source: David Olson http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0018.html Summary: looks like an omission In Section 5.2, there is some sample XML to show how the functionality of a smiple link could be approximated by the use of an extended link. The empty content tag for the locator element is closed up too soon because it does not contain the xlink:title="..." attribute. Possible decisions:
Decision: 1/ fix it |
[XL103] Editorial: Use "crosshatch"Source: Jonathan Marsh http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0028.html Summary: minor I18N comment to change 'crosshatch' to 'number sign' (the official name of #). Martin wrote: > There is a very minor I18N comment to change 'crosshatch' > to 'number sign' (the official name of #). Per the WG resolution to accept this comment, I have changed this in XML Base. I stole the wording directly from XLink and XPointer, so I assume they should to be changed before PR as well. Possible decisions:
Decision: 1/ fix it |
[XL104] Fold arcrole attribute into role attributeSource: Elliotte Rusty Harold http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0030.html Summary: making XLink simpler by deleting arcrole and allowing role attributes on arc elements. .... I propose making XLink simpler by deleting arcrole and allowing role attributes on arc elements. A suggestion as to what the role of an arc element should be can still be provided, but I see no justification for two separate attributes here. Eve provided the rationale and we're unlikely to change, but he did make a proposal and so we should respond formally. Possible decisions:
Decision: 2/ Keep as is, with the already-stated rationale by Eve. |
[XL105] Lose the title-type elementsSource: Elliotte Rusty Harold http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0031.html Summary: really not sure they're necessary or useful in practice I'm really not sure they're necessary or useful in practice, and I'd like to propose simplifying XLink by deleting all reference to title type attributes. .... Possible decisions:
Decision: 4/ to keep the status quo. No consensus for #1 or #2. We discussed #3. Some would be interested in getting more specific, but others didn't want to limit to I18N purposes. This is just another providing link metadata; we don't tell people how to use roles either. |
[XL106] Change the name of the resource-type elementSource: Elliotte Rusty Harold http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0051.html Summary: rename the type of the local resource from resource to something else such as "local" .... What I'm proposing is to rename the type of the local resource from resource to something else such as "local". The reason is that a resource element doesn't really represent all kinds of resources, just local ones. I'm not wedded to the name "local". I just don't want it to be "resource". Another possibility is to rename the resource type to local and the locator type to remote, though I suppose that might be a little confusing when the locator locates an element in the same document. Or we could rename locator "uri" and resource "here". That more clearly indicates what's expected in the attribute value. See also David Orchard's and John Simpson's responses. Possible decisions:
Decision: 5/ keep as is. No consensus to reopen; it's too late and the changes didn't garner a lot of support. This is something of a taste issue. |
[XL107] Editorial: arcrole is allowed on simple links tooSource: Toivo Lainevool http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0113.html Summary: 5.5 misses the fact that the simple-type elements may also have an arcrole attribute. Section 5.5 of the XLink spec states: "The role and title attributes may be used on extended-, simple-, locator-, and resource-type elements. The arcrole and title attributes may be used on arc-type elements." This misses the fact that the simple-type elements may also have an arcrole attribute. Possible decisions:
Decision: 1/ fix it |
[XL108] Editorial: RFC 2732 referenceSource: Martin J. Duerst Summary: xLink misses an RFC 2732 reference. At 06:31 PM 10/20/00 +0900, Martin J. Duerst wrote: Eve - I just found that XML SE includes RFC 2732, but XLink CR doesn't. If that's not already on your list, please add it. Can you also check XPointer on this point? XPointer does indeed already contain a reference. Possible decisions:
Decision: 1/ fix it |
[XL109] Editorial: arcrole and title allowed on arcs tooSource: Christopher Ferris by way of Eve Maler Summary: The arcrole and title attributes may be used on arc-type elements. The attributes that describe the meaning of resources within the context of a link are role, arcrole, and title. The role and title attributes may be used on extended-, simple-, locator-, and resource-type elements. The arcrole and title attributes may be used on arc-type elements. Possible decisions:
Decision: 1/ fix it |
[XL110] Container locations vs. container nodesSource: Matthew Wilson http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000OctDec/0029.html Summary: "container location" vs. "container nodes" wording. In 5.4.3, in the definition of the range-inside function, there is: "If x is not a range location, then x is used as the container location of the start and end points of the range location to be added; the index of the start point of the range is zero; if the end point is a character point then its index is the length of the string-value of x, and otherwise is the number of location children of x." This refers to the "container location" of points; however points are defined in terms of "container nodes", and the term "container location" is not used elsewhere. This seems odd. (Specifically, what is added to the result location-set when the input location set contains a point? Presumably, a collapsed range containing the point, but can this be deduced from the spec?) Eve says: I believe that we just want to change "container location" to “container node" here, but I wanted to confirm this. If x is not a range location, then does this always imply that x has to be a node? Options:
Decision: 1/ Change container location to container node in 5.4.3 |
[XL111] Request for non-normative DTD with "XLink semantics"Source: Murray Altheim http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000OctDec/0047.html Summary: asking for a DTD defining XLink I guess I would want an XLink DTD that stated "these are the defined structures and meanings associated with XLink 1.0, if you get validation errors they mean that the linking constructs you've used aren't defined by the XLink specification but may be valid in your application." It's just hard sometimes to know what is and what isn't actually an XLink-defined structure, and having only prose text and examples to go on is somewhat difficult. Eve says: Several people have asked for "a DTD," but this description finally makes me realize how such a DTD could be provided with some useful level of precision. I'd be in favor of this, and in fact have created a draft DTD for discussion. Note in particular the assumptions that accompany the DTD. Options:
Decision: 1/ adding a non-normative DTD based on Eve's one with simple links added |
[XL112] Do links with multiple arcs need their own name?Source: Hartmut Obendorf In section 2.3 inline, outline and third-party links are defined as linky with only one arc. Links with more than one arc (let's call them complex links here) aren't given a name. This doesn't make sense to me as I thought one of the great things about XLink was exactly that you wouldn't have to live with a single arc per link. Even a two-way link has two arcs and doesn't have a designated name (like 'complex link') according to the standard. I would argue that _most_ XLinks will use more than one arc and therefore most XLinks are not taken care of by this definition. See also his second posting on the topic. Options:
Decision: 2/ Seems there is no real need for just adding a new name |
[XL113] Editorial: Give an example of a title-type elementSource: Hartmut Obendorf In section 5.1 in the example you define a "tooltip" element. This is not used again. What's the point? Options:
Decision: 1/ Add an example to Section 5.2.7, using "tooltip" as an example |
[XL114] Editorial: Clarify the "origin" of all the attributes on simple linksSource: Hartmut Obendorf In the same section [5.2] you state the following as a "missing feature": * associating a title withe the single hardwired arc * associating a role or title with the link as a whole I understand the first as follows: The title attribute of the simple link corresponds to the title attribute of the external locator. Maybe this should be made a little more explicit. Options:
Decision: 1/ Clarify that the role and title attributes on simple-type elements refer to the ending resource |
[XPR1] Accessing the XML declarationSource: XPointer Requirements document Summary: section A.2 says:
We do not provide any special access to the XML declaration (I think the stylesheet PI can be accessed via the usual XPath PI mechanisms). I believe this is because DOM and/or the InfoSet don't either. XPath provides no way to get this node, since it does not count properly as a processing instruction We can delete the requirement, or add a special function to access this node. The ugly part is that since it is not formally a PI, it does not fit any of the existing node types, so we'd have to add a new node type for it, which is non-trivial. I think our best response is to add a note indicating that it cannot be accessed at this time, and delete the requirement or reduce it to 'should' or 'may'. Possible decisions:
Resolution: Change the requirement to "should" |
[XPR2] Testing datatype-specific conditionsSource: XPointer Requirements document Summary: section B.7 says:
This one we simply haven't touched. XPath has a non-interoperable way to do this, namely extension functions; but we don't allow them (which has the advantage of greater interoperability....). This one is already a 'should' rather than a 'must' in the requirements; I think we knew it was a stretch from the beginning. At most, I recommend we add a note indicating that there is no way to do type-specific tests on datatypes other than those already defined, and that future versions of XPointer may provide this based on the ongoing XML Schema work. Possible decisions:
Resolution: Keep as is (acting as a reminder to examine selecting on types once XML Schemas is a REC) |
[XPR3] Specifying the version of a target resourceSource: XPointer Requirements document Summary: section B.8 says:
We basically decided this is the main URI's problem, not the fragment identifier's. So we should delete this requirement. We may wish to also add a note to the spec referring to WebDAV for work on version management, and add them as a non-normative reference. Possible decisions:
Resolution: Keeping it (and done as a property of the URI), add a non-normative reference to WebDAV |
[XPR4] Checking the resource contentSource: XPointer Requirements document Summary: section C.1 says:
The final [ ] saves us here, since we decided this belongs in XLink rather than XPointer. Sadly, we failed to address it there. This seems to have fallen between the cracks between XPointer and XLink. I think we really should fix this, in XLink. The easiest way is to provide an optional attribute on locators, that takes a scheme prefix that identifies the checksum or signature method in use (we could predefine at least one, MD5 being the obvious candidate based on earlier reviews), and then gives the value. This is easy, optional for users, and I think it's worth doing. The Canonical XML effort is aimed to provide precisely the string one wants to checksum, so we can reference that, although still non-normatively since it isn't a REC. Possible decisions:
Resolution: it's an XLink requirement, move it in XLink requirement |
From editorial notes in 6-24-99 version of spec:
[XP1] TumblersDraft currently posits that tumblers may be added to XPath. That seems very unlikely now. Options:
Resolution: Keeep it as if! |
[XP2] URI escapingNeed to describe escaping rules for when %encoding is needed and when it is not. This issue is believed settled, and we merely need to craft the prose for it. Resolution: @@ |
[XP3] Multiple location specs - necessity and processing modelResolution: Keep multiple location as explained in the current version of the specification Keep the processing model as explained in the current version of the specification [XP3.1] Multiple location specs - necessityThe Xpointer syntax provides a scheme and scheme-specific-string model in its top-level production. The WG had not reached consensus on the need for this functionality, nor on the use of an explicit termination character (i.e. ')'). On the other hand, we have had feedback from Philipp Hoschka that this is important functionality for SMIL. Options:
[XP3.2] Multiple location specs - processing modelThe XPointer spec currently evaluates multiple pointers using a 'short-circuit OR' semantic. In other words, try the first, second, ... Location specs until one of them succeeds. Don't report any errors unless all of the fail. It has been pointed out that there may be other useful ways of combining the location terms. Boolean combinations are one possibility. Options:
|
[XP4] checksums made XLink issue, not XPointer issueBelieve this is not really an issue, and all we have to do is decide if the XPointer spec says "we used to think XPointer would provide this but now we think it is a problem for XLink". Resolution: @@ |
[XP5] problems with use of '//' in URLsMembers of the WG have reported that some HTTP servers do bad things when they are given URLs which contain '//' in the fragement. However, that syntax is used in XPath. The subgroup considered this and decided to go ahead with using the '//' as we heard from an employee of the company making one of the offending servers that it was OK to do so. Options:
Resolution: consensus:1/ This is a bug on the server. |
[XP6] use of 'parent' to denote element containing an attributeThe question is - given an attribute node, how to get to the
element bearing that attribute? The XSL WG debated this and decided
that the Options:
Resolution: consensus on 1/, we already discussed (voted ?) that issue, This may be revisited when reviewing DOM feedback. |
[XP7] namespace initializationThe namespace context must be initialized before comparisions on qualified element types can be made. The spec is currently inadequate in this area. Resolution: Dropped, we can do it, already, the syntax will be provided in the Xpointer specification |
[XP8] will XPath take up the string() axis/function?One part of this issue is covered under XP12, deciding if the string and range axes should be functions instead. A second part is to see if:
Resolution: Consensus: it's impossible to add string() to XPath now Consensus: on keeping string() functionnality Pending: rewording of that part, to be discussed Consensus: closing it, the draft defines string-range(), it's not in XPath that's an extension (James proposal) |
[XP9] case-insensitive string comparisonThe I18N WG has urged us to say that string comparisons are peformed on the binary content of the string. At the same time, case insensitive searching is a useful feature for users of languages that have the notion of case.Options:
Resolution: 1) reuse the XPath translate() |
[XP10] access to internal structure of DTD, XML declarationRight now we can't locate content in DTDs, nor can we access the pseudo-attributes in the XML declaration. Options:
Resolution: Consensus: In version 1.0 there won't be a mechanism to point into DTDs or Schemas |
[XP11] membership lists and affiliationsThis is an editorial point - getting the current lists correct, dealing with former members, etc. Options:
These issue have been raised on the mailing list: Consensus: Everybody part of the WG at release time is entlitled to be listed, check back with the editor |
[XP12] Should string and range axes be functions?Right now, these are considered 'axes', but they have differences from the other axes defined in XPath. At the same time, Resolution: Same as [XP8] |
[XP13] Addressing an XSLT result treeShould we provide a fragment scheme or a result() function to address nodes in an XSLT result tree? If not, how are generated elements addressed? Options:
Resolution: dropped, to be added in future versions |
[XP13.1] What is the URL of a result tree?Related to XP13 is the question of identifying a result tree so that XPointers can be used to address into them. Options:
Resolution: dropped, to be added in future versions |
[XP14] unique() returns booleanCurrently unique() returns a boolean, meaning that it can only appear within a predicate in an XPointer. For instance, it appears that #xptr(unique(a/b/c)) is invalid. Options:
Resolution: |
[XP15] Provision for XML Schema datatypesRequirement B7 in the updated XPointer requirements draft says: The XPointer specification should make clear a way that it can
be extended to support testing datatype-specific conditions when XML
Datatypes are later available through the work of the XML Schemas
Working Group.
This requirement is believed not to be met. Options:
Resolution: XPointer can be extended, we don't have a specific syntax right now. Consensus on not handling it in V1.0, we can't meet it because Schema is not ready yet, suggestion to postpone it to a later version. |
[XP16] Reuse of XPointers in other XPointersRequirement D2 in the updated XPointer requirements draft says: The XPointer specification must provide for re-use of XPointers
by other XPointers. [There is not consensus that this is a short-term
requirement, though there is consensus on its desirability in
principle.]
This requirement is believed not to be met. Options:
Resolution: Consensus that this requirement will not be met for the 1.0 release |
[XP17] Grammar of StringWithBalancedParenthesesMay need to change the grammar of StringWithBalancedParentheses to make the use of the circumflex appear in the grammar rather than only in the prose. Options:
Resolution: |
[XP18] Update of XPath SummaryXpath summary info has not been updated to match the current XPath document. Doing so is mandatory if the document is to have such a summary. Resolution: |
[XP19] Use of 'range node' terminologyThere is concern over confusion between the use of 'node' as in the members of an XPath node-set, 'node' as in the items specified by the Infoset, and ranges - which are not nodes in the sense of the infoset but must be nodes in the sense of XPath node-set members. Options:
Resolution: We should keep XPointer in sync with XPath, there is still possibility to change XPath, if needed |
[XP20] Restriction of RangeExpr to top-levelIdeally, RangeExpr would not be restricted to the top-level. This would require using a new operator (which could be a named operator, such as 'to') instead of ','. However, this would either mean that ranges had to be integrated into XPath, or that XPointer and XPath would no longer have the same grammar. Options:
Resolution: Closed unless one of the person not present at the f2f really want to reopen it. |
[XP 21] Restrict eval context only to defined functionsProblem of interoperability, can we restrict to existing defined functions, basically refusing extension of XPointer and (current) XPath core function: Consensus: Agreed, by leaving as-is the XPointer draft refusing function extensions |
[XP22] Position data type vs. use of collapsed rangesJames' original suggestion did not have a position data type. Instead, when a single position was needed a 'collapsed range' was used. The disadvantage of the new datatype is that more types means more possibility for type errors. The advantage of it is that conceptually distinct things have distinct types, so type errors serve as diagnostics for logic errors. Options:
Resolution: use a position datatype |
[XP23] New term for positionDraft uses 'position' when talking about range end-points. This is in conflict with XPath use of the term for position within a node-set result. (Note that the DOM uses position, so whatever we decide we should suggest they adopt as well.) Options:
Resolution: use the single term "point". |
[XP24] return type of starting-position() and ending-position()James Clark notes that the return types should be location-set, not single positions, for better integration with XPath. (Editors' recommendation is to make this change). Resolution: editors to do the change |
[XP25] Overlap of starting-position() and ending-position with range-before() and range-after()If the return type of starting-position() and ending-position is changed, they are equivalent to the range-before() and range-after() functions. (Editors suggest that the names of the functions should be chosen based on earlier decisions about position vs. range data type, and name for position datatype.) Resolution: editors to do the change |
[XP26] container-node() overlaps with ..James Clark notes that XPath provides the ".." construct, which is the general purpose equivalent of the special-purpose container-node() function. (Editors suggest we scrap the container-node) function and describe XPointer extensions to "..", namely, that we define the parent of positions and ranges. This will also have the benefit of clarifying how one manages the point at the end of a range. Currently, for example, the ancestor axis when applied to a range, has the same results as ancestor for the first node *in* the range; which while often good enough, is not the same thing. This makes it awkward or worse to address relative to the end of a range. The point immediately preceding a chapter is not, properly speaking, the same as the start of the chapter, and the range/node/point distinction reflects this distinction transparently. ) Resolution: editors are directed to proceeed with suggested changes, i.e. removing container-node() . |
[XP28]Relational operators for positions and rangesIssue here is that XPath already defines the relational operators to operate on the string value of locations. Changing those to operate on the document order would be difficult, if not impossible, and would surprise many users of XPointers if it were possible. Options:
(Editors recommend defining the new function. This provides additional incentive for keeping points distinct from ranges, since the meaning of order comparison for the two is not identical. by keeping them separate, we can avoid complex comparison semantics.) Resolution: |
[XP29]
|
[XP30] Assorted definitions about positionsThe position data type does not have definitions for its string-value, expanded-name, etc. Those should be defined. James Clark has provided suggested definitions. They update the last three paragraphs before 4.3.1. The suggestions are: In the paragraph about the string-value of a range location, say that the string-value of the position location is empty. In the paragraph about the expanded-name of a range location, say that a position location does not have an expanded name. In the paragraph about axes, change it to this: The axes of a position location are defined as follows. A position location has no children. If the position is a character-position, then the position location has no preceding siblings and no following siblings. If the position location is a node-position, the preceding or following siblings are the children of the container node that are before or after the node-position. The axes of a range location are the axes of its starting position. Options:
(Editors recommend that the suggestions be tweaked. In particular, we think the distinction between node-position and character-position should be (re)considered by the WG.) Resolution: adopt James Clark suggestion |
[XP31] Tumblers start from document element, XPaths start from document rootCopying from Jonathan's email... The XPointer WD states: "Second, a shorthand that locates an element by stepwise navigation from the document element, using a sequence of '/'-delimited integers. Each integer locates the Nth child element of the previously located element, where N is the value of the integer." There is potential confusion between the notation of tumblers and that of XPath, in that "/" in XPath represents the document root, while in tumblers, "/1" represents not the first child of the document root (the document element), but the first child of the document element. In short the tumbler "/1" and the XPath "/*" are not equivalent. For instance: Conversely, this means that there is no tumbler that can be used to
access the document element, namely: It occurs to me that it might be useful to combine tumblers and
bare names, to allow: Options:
(The editors don't have a consensus recommendation, although both like option 2. Opinion is divided on option 6. ) Resolution: |
[XP32] Syntax errors in examplesSyntax errors have been noted in the examples from section 3.2. (Editors apologize. The suggested corrections have been made.) |
[XP33] No ^-escaping in BNFCopying from Jonathan's email... While not a native BNF speaker, the BNF in section 3 doesn't seem to handle the "^" escaping mechanism for the xptr scheme. Is this because it is not possible with BNF notation? If so, does this need to be called out with an explicit "validity constraint"? Right now, the explicit validity constraint is: "Validity Constraint: When the Scheme is 'xptr', the SchemeSpecificExpr must match the production for XPointerExpr." Isn't this redundant with the BNF? Options:
(The editors would like to reassure Jonathan that this is not nonsense :-). However, escaping rules like the use of ^ are difficult to express in BNF. We can certainly attempt to clarify the two validity constraints.) Resolution: Editors are allowed to "tweak" the EBNF |
[XP34] No tumbler errors definedNo errors, such as raising a sub-resource error if a tumbler locates a non-existent element, are defined for tumblers. Options:
(Editors agree that these errors need specification in some manner. These appear to be precisely the same as the already defined errors for full-form XPointers, so tweaking the language to clarify that those error definitions apply to xpointers, bare names, and tumblers should suffice.) Resolution: tweak definition to apply XPath standard errors to tumblers and bare names |
[XP35] escaping unclearSource: I18N feedback http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0036.html, Summary: Lack of detail of what, whan and where part of XPointer expressions have to be escaped. This affects section 2.2 and section 2.1. the I18N mail is fairly detailed Possible decisions:
2/ the editors are asked to clarify this section, possibly by reusing some wording from the original mail |
[XP36] ^escaping is not needed () escapingSource: I18N feedback http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0036.html Summary: The URI spec all (), so they don't need to be escaped it is then possible to use %28 and %29 for ( and ) escaping within XPointer expressions, however there might be possible drawback Possible decisions:
Resolution: (with better statement from Ron) The WG was not able to convince itself that the ^ escaping was not necessary, and at a minimum we would have to specify the rules around escaping of parentheses in more detail. Therefore the group decided to leave the spec as-is. |
[XP37] XPointer/DOM differences in char countingSource: I18N feedback http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0036.html Summary: Points and Ranges correspond, to DOM's "position" and "range". However, DOM's position and range are based on UTF-16 units while XPointer on the other hand works on UCS characters Possible decisions:
Resolution: |
[XP38] child sequences are unstableSource: I18N feedback http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0036.html Summary: addressing by child sequences as described in 2.1.3 is especially unstable in case of editing or translation Possible decisions:
Resolution: 2/ keep as is. All XPointer constructs are potentially unstables w.r.t. editing |
[XP39] matching and normalizationSource: I18N feedback http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0036.html Summary: There should be some comment about matching and normalization in 3.5. The review suggest some wording. Possible decisions:
Resolution: |
[XP40] Whitespace handling in 'string-range'Source: I18N feedback http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0036.html Summary: This is defined so that multiple spaces in the source match with multiple spaces in the XPointer. In as far as this is used to deal with 'pretty printing' in the source or in XPointers (as opposed to catching spurious double spaces,...), this is inappropriate because it does not cover languages that are written without spaces, such as Thai, Chinese, and Japanese. This has to be improved. Possible decisions:
Resolution: Paul grosso sent a very clear mail on the subject and suggesting 4 possible actions. The editors are instructed to remove the section on normalization, add note how XML processors have to normalize end of line characters. |
[XP41] [ and ] are used for IPv6 adressesSource: Larry Masinter http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0000.html Summary: What's raised the issue is a proposal (as a result of work in representing IPv6 addresses in URLs) to move the characters "[]" into the reserved set. Possible decisions:
keep use of [] they are actually used in XPath. if this need to be escaped leave it to W3C and IETF to decide. |
[XP42] subset XPointer?Source: SYMM WG review http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0029.html Summary: Is it legal to subset XPointer? At what level of granularity? Should we do it with a subset without ranges ? Possible decisions:
All conformant XPointer processors must process the entire spec 1/ |
[XP43] drop rangesSource: XSL WGhttp://lists.w3.org/Archives/Member/w3c-xml-linking-wg/1999Dec/0074.html, Paul Grosso http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0010.html, Oracle http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0044.html, Rick JELLIFFEhttp://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0046.html, Jonathan Marshhttp://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0041.html Summary: Various point of view
Possible decisions:
Resolution: effective consensus on keeping them, a minority opinion report was drafted by Paul Grosso |
[XP44] interaction with XSLTSource: XSL WGhttp://lists.w3.org/Archives/Member/w3c-xml-linking-wg/1999Dec/0074.html, Oracle http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0044.html Summary: mapping back an XPointer (or a selection) to the source document when the rendering has been generated by an XSL(T) transformation Possible decisions:
XPointer addresses within a given Infoset. XPointer has no notion of input or result set. This issue is out of scope for the XPointer specification. |
[XP45] Range and character definitionSource: Oracle http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0044.html Summary: Ranges implies defining what is a selection and the resulting character set, DOM opted to 16bits chars, this is not defined in XPointer. Related to [XP37] Possible decisions:
1/ this is defined in XPath (c.f XPath REC Introduction "string (a sequence of UCS characters)") and we are using UCS and already voted on this |
[XP46] Multiple Ranges/Node/PointsSource: TimBL, private discussion with staff contact, Paul Grossohttp://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0010.html Summary: XPath allow returning multiple values, and XPointer don't constraint it allowing to return multiple (non consecutive) nodes, or multiple points/ranges. This complicate handling and may be hard to get implemented and linked to UI. Note that the I18N WG considered that a good feature. Possible decisions:
Resolution: this was discussed already the WG considered that a feature, keeping it. @@@pointer |
[XP47] how schemes are managed?Source: Martin Duersthttp://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0037.html Summary: who allocate scheme names to avoid conflicts ? This is a repository and W3C is not inclined maintaining repositories. This is a serious problem. Possible decisions:
The WG recognize the risk of collision, the WG cannot provide the mechanism to prevent this. Checking the errata in the future is the place where to look for a possible solution. |
[XP48] Whitespace between schemesSource: Jonathan Marsh http://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0008.html Summary: we should allow "#xpointer(...) xpointer(...)" as whitespaces are allowed between the parens Possible decisions:
1/ allow them and note that this will have to be escaped when embedded in an URI |
[XP49] Integration of namespaceSource: Martin Duersthttp://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0037.html Summary: The scheme is too complicated, suggest uri-name()='http://www.foo.com/bar:y' Possible decisions:
Those functions are herited from XPath, if this need to be fixed, then XPath is the right place to change this. |
[XP50] XPointer need null()Source: Jonathan Marshhttp://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0040.html Summary: Many database constructs leverage the concept of a null pointer. XPointer does not have this capability. Possible decisions:
1/ The WG don't really see a need right now and could be added later as a new fragment scheme |
[XP51] character-point/node-point definitionSource: Robert Hanson by way of Eve Malerhttp://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0003.html Summary: if a node-point is "When the container node of a point is of a node type that can have child nodes", and a character-point is "When the container node of a point is of a node type that cannot have child nodes", then what about characters in a node that CAN have child nodes? It seems that by definition that this is not defined. Possible decisions:
In the disposition of comment explain that nodes are not elements (text nodes vs. element nodes) hence that case cannot happen |
[XP52] does root() still existSource: Elliotte Rusty http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0004.html Summary: Does the root() function still exists as the Dec. 6 working draft of XPointer? It's mentioned twice in the draft but only in passing, and it's not mentioned at all in the XPath 1.0 spec. Possible decisions:
Good catch. root() doesn't exist anymore, editors are directed to replace root() by reference to "/" construct |
[XP53] erratasSource: Martin Duersthttp://lists.w3.org/Archives/Public/www-xml-linking-comments/1999OctDec/0037.html Summary: Please make sure the final Recommendation will have a pointer to errata. Possible decisions:
yes will be done when going to REC |
[XP54] Range syntaxSource: DV http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Jan/0011.html Summary: the current range syntax based on " to " need modification to the XPath parser, thsi need to be changed. Steven proposed a function based syntax and checked with James Clark. Possible decisions:
Use rangeto function instead of the ... to .. construct |
[XP55] "character sets" vs. "character encodings"Source: Martin Duërst on behalf of the Internationalization Working Group, raised the following issue about character sets and escaping, in section 2.2 of the XPointer Working Draft. Summary: The title should be changed from "character sets" to "character encodings" Possible decisions:
Resolution: 1/ Change it accordingly to Martin comment |
[XP56] UTF-8 encoding is not necessary for URI-referencesSource: Martin Duërst on behalf of the Internationalization Working Group, raised the following issue about character sets and escaping, in section 2.2 of the XPointer Working Draft. Summary: Martin believes that we should clarify that the UTF-8 encoding is not necessary for URI-references, but rather, for XPointer itself. Possible decisions:
Resolution: 1/ Change it accordingly to Martin comment but substitute URI references by XPointer |
[XP57] clarify certain distinctions about illegal characters in URI-referencesSource: Martin Duërst on behalf of the Internationalization Working Group, raised the following issue about character sets and escaping, in section 2.2 of the XPointer Working Draft. Summary: Martin believes that the specification should clarify certain distinctions about illegal characters in URI-references Possible decisions:
Resolution: Removing that note. Eve will write a rationale about illegal URI char support and send to group for inclusion in DOC |
[XP58] validity constraint about not all legal XPath expressions may be used when escaping.Source: Martin Duërst on behalf of the Internationalization Working Group, raised the following issue about character sets and escaping, in section 2.2 of the XPointer Working Draft. Summary: Martin believes that the second validity constraint in this section is unnecessary. This validity constraint declares that not all legal XPath expressions may be used when escaping. Possible decisions:
Resolution: Editors to do the changes requested |
[XP59] directly reference the Unicode and UTF-8 specificationsSource: Martin Duërst on behalf of the Internationalization Working Group, raised the following issue about character sets and escaping, in section 2.2 of the XPointer Working Draft. Summary: Martin believes that this section must directly reference the Unicode and UTF-8 specifications. Resolution: The editors should add the references to Unicode 3.0 and RFC 2379, respectively. Possible decisions:
Resolution: 1/ The editors should add the references to Unicode and RFC 2379, respectively. However XML-1.0 uses Unicode 2.0 while future version may use 3.0. Martin will be contacted to find how to handle this. |
[XP60] I18N be a requirement in implementing XPointer.Source: Martin Duërst on behalf of the Internationalization Working Group raised the following issue about the introduction of the XPointer Working Draft: Summary: In regards to robustness requirements 'must attempt to be internationalized' apparently isn't strong enough for the Internationalization Working Group. They would like the Working Group to state that internationalization is a requirement in implementing XPointer. Possible decisions:
Resolution: This is an (unecessary) rewrite of the requirement, just remove it since we reference it. This section will be removed |
[XP61] preceding relative axes errorSource: Michael Dyck raises the issue that, in section B.3 : Summary: we declare that the Possible decisions:
Resolution: Yes this is an error drop that subpart of the sentence and keep the compatibility with XPath |
[XP62] the definition of a node is in conflict with the InfosetSource: Martin Duërst notes that, in the definition of a node: Summary: we are in conflict with the Infoset, which does not include the concept of text nodes. The DOM does define text nodes, however. Possible decisions:
Resolution: we are really basing our work on xpath view. We use text nodes as defined in XPath. |
[XP63] Axis usage errorSource: Martin Duërst notes that, in section B.6, Summary: the following text is inaccurate: Possible decisions:
Resolution: Instead of mentionning the parenthesis, mention the axis identifier and reference the XPath axis production specifically. |
[XP64]Source: The following was an ednote from sjd, at the end of the Evaluation Context Initialization section: Summary: While the idiom mentioned above alleviates the need for additional namespace initialization mechanisms, XPointers using it can become quite long - potentially exceeding the practical limits on URI length established by many applications. An alternative proposal is to augment the XPointer grammar to allow namespace prefixes to be initialized then used in the XPointer. The proposed grammar would change GeneralFragmentPart to: GeneralFragmentPart ::= 'xpointer' '(' NSInit* XPointerExpr ')' NSInit ::= 'xmlns:' prefix '="' URI '";' It would also require occurrences of the semicolon character ';' to be escaped by the circumflex '^' character. Note that this is only an issue for occurances of XPointers in non-XML documents. However, there are use cases such as copying an XPointer from an XML document and pasting it into an email message where such an initialization mechanism would be useful. Feedback on the desirability of this addition to the specification is requested. Possible decisions:
Resolution: referenced in issue list but not added to draft. |
[XP65] XPointer to resources without InfosetSource: Paul Grosso for the XML Core WG http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0049.html Summary: Some documents may be delivered as XML but not have Infosets
Those documents may be considered of Mime Type XML, but since they don't have Infoset (or rather an XPath "data model") it seems one cannot use XPointer for those resources. The mail present 2 well formed external parsed entities but without a single root element, and ask for clarification about using XPointer if this is allowed. Possible decisions:
Resolution: 1/ XPointer applies only to document for which an Infoset or an XPath data model can be built |
[XP66] ChildSeq and Well balanced XML chunks supportSource: Michael Kay http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0039.html about the XPointer CR version Summary: The syntax of ChildSeq suggests that XPointer is constrained to operate on well-formed XML documents (those with a single top-level element), in contrast to XPath which also operates on well-balanced XML fragments. It might be worth stating this explicitly. Possible decisions:
Resolution: The working group is tempted to follow XSLT and allow the document to have multiple roots, the core WG is defining Infoset defined for external parsed entities. Adding support for those. |
[XP67] more flexible context initializationSource: Michael Kay http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0039.html about the XPointer CR version Summary: Application (for example XSLT) reuse of XPointer will be made difficult due to our strict definition of the context initialization 4) Section 5.2, bullets 4 and 5. This appears to ban applications from defining a way of binding variables and functions and using them in an XPointer, which seems unnecessarily heavy-handed, for example it would make it difficult to extend XSLT to use XPointer. Wouldn't it be better to say that the set of variable bindings is determined by the application, and is empty by default? 5) Section 5.2, bullet 6. This probably ought to say something about the default namespace, rather than leaving it implicit. Again, it seems heavy-handed to prevent namespaces being bound in some application-defined way, for example in an API that uses XPointer syntax this would make it very difficult to refer to namespace-qualified names. Possible decisions:
Resolution: 1/ rejectcted on ground of interoperability. The problem of addressing namespace-qualified names is well know and should be addressed at the XPath level. |
[XP68] Missing definitions for PointsSource: Michael Kay http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0039.html about the XPointer CR version Summary: Points object definition lacks a couple of informations 6) The definition of the axes of a point location should include a definition of the parent and self axes. (It perhaps needs to be stated that the concept of an axis is *not* being generalized to return any location, it still always returns a node-set). 8) Section 5.3.2, second paragraph. The concept of two points being "equal" has not been defined. (It needs to be distinguished from the XPath "=" operator). Possible decisions:
Resolution: generated a long discussion, especially for point equality when one of the nodes may be at the origin or end of a text string. So there was no consensus to disallow case where points may be differents but undistinguishable at the rendering level. The editors are however instructed to make the distincion clear in the specification. |
[XP69] problems with range-to()Source: Michael Kay http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0039.html about the XPointer CR version Summary: clarification on the impact of range-to() on XPath syntax is needed, and suggest a different syntax 9) Section 5.4.1, Note. This extension to XPath syntax needs much more formal treatment. Exactly how is the BNF modified? Which functions are allowed after a "/"? What are the semantics? I'm worried that this extension is "jumping the gun" in terms of how XPath evolves. I think that this kind of requirement, along with many others, would be much better met by allowing a function to take an expression (or function) as an argument, so it could be written say range-to(id("chap1"), function: following::REVEND(1]). (This concept is needed to do things such as universal and existential quantifiers, summing an arbitrary expression, etc). Possible decisions:
Resolution: after discussion between DV and Michael Kay a modification to production 4 of XPath is provided and the change is to be made to the specification |
[XP70] Error detection and handlingSource: Michael Kay http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0039.html about the XPointer CR version Summary: seems there is a bit of confusion in the description of error handling 12) Section 5.4.3 fourth paragraph. "the expression fails" - is this concept defined? 13) Section 5.4.3, function start-point(), fourth bullet. Suggesting this is a syntax error implies that it can be detected statically. This is not the case, for example start-point((*|@*)[5]): the argument may be an element or an attribute node. Same comment applies to end-point(). Possible decisions:
Resolution: agreed to change the errors to be sub-resource ones. |
[XP71] Non-nodeset reults handlingSource: Michael Kay http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0046.html about the XPointer CR version Summary: What happen if the XPath expression doesn't evaluate to a Node Set ? 16) I didn't see anything in the XPointer spec that says the XPath expression has to evaluate to a node-set. Since 2+2 is a valid XPath expression, it seems that XPointer(2+2) is a syntactically valid XPointer, though presumably it will always fail as "a scheme that does not locate any subresource present in the resource". However, the rule that the expression must return a node-set could be stated more explicitly; and in particular, the syntax of an XPointer could refer to an XPath UnionExpr rather than an XPath Expr, since an Expr that is not a UnionExpr will never return a node-set. In fact the rules could be more restrictive than this. As a precedent, the XSLT syntax for Patterns describes a subset of XPath syntax that will always return a node-set. This subset is probably more restrictive than the subset that would be appropriate for XPointer, for example because it only allows use of the child and attribute axes, but the same idea could be applied. Possible decisions:
Resolution: 2/ agreed. add prose that anything returning anything other than a location set is a sub-resource error. |
[XP72] Editorial suggestionsSource: Michael Kay http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0039.html about the XPointer CR version Summary: mostly editorial only changes suggested:
Possible decisions for each point raised:
Resolution: Editorial changes were agreed upon, and unique() was decided to be dropped from XPointer |
[XP73] Resource or InfosetSource: Paul Grosso (XML Core) http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0049.html about the XPointer CR version Summary: XPointer working on resources or Infosets
Possible decisions: Resolution: accept Eve wording as amended to keep the Infoset reference |
[XP75] Editorial commentsSource: Susan Lesch http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0061.html about the XPointer CR version Summary: three minor comments In 3.4 par. 1, "(suitably escaping)" could read "(suitably escaped)". (Not certain.) In 5.2 last example, should the namespace-uri be 'http://example.com/foo'? In Appendix A, XML-Names, "Textuality, Hewlett-Packard, and Microsoft." can be omitted. Possible decisions: Resolution: Editorial, accepted, the editor are asked to close them |
[XP76] suggest that some additional functionsSource: Lance Otis http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0065.html about the XPointer CR version Summary: suggest that some additional functions We would like to add some flexibility to the XPointer spec for document search. Can the XPointer spec be changed to include functions such as similar-to(), find-by-concept(), and find-by-query() with the appropriate arguments? Possible decisions:
Resolution: no new features, those are searching related and rather difficult to specify and implement |
[XP77] a couple editorial errorsSource: Jeffrey Bacon http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0025.html about the XPointer CR version Summary: a couple editorial errors Section 5.4.2 string-range() Function, example 2: Section 5.4.2 string-range() Function, example 3: Section 5.4.6 unique Predicate Function Possible decisions: Resolution: Editorial, accepted, the editor are asked to close them |
[XP78] Minor editorial correction.Source: Elliotte Rusty Harold http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0071.html about the XPointer CR version Summary: Minor editorial correction. point into a non-final October 1999 draft of XPath, Possible decisions: Resolution: Editorial, accepted, the editor are asked to close them |
[XP79] Minor correction.Source: Elliotte Rusty Harold http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0071.html about the XPointer CR version Summary: Minor correcction I'm not 100% sure of this, but I think that in section 5.4.3 Additional Range-Related Functions the declarations of start-point and end-point are incorrect. You have: point start-point(point) point end-point(point) I suspect these should be point start-point(location-set) point end-point(location-set) That is, change the point argument to a location-set. Possible decisions: Resolution: Right the editors were instructed to make the change |
[XP80] Problematic Aspects of RangesSource: XSL/XML Linking Task Force http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0170.html Summary: a subset of XPointer be created that eliminates ranges We have observed that arbitrary ranges introduce some problematic situations for styling. In any styling technology whose data model granularity is coarser than the Infoset (which includes both XSLT and CSS, for example), XPointer ranges might identify material that is not "compliantly" expressible in styling terms. This problem is most acute in the case of embedding, and, more generally, in any case where the presentation context is equal to the ending resource. There is also the tricky case of string ranges that begin or end in the middle of a presented multiple-character glyph.[9] The XSL-affiliated members of the task force are working with that group on the data model issue and are recommending some extension functions to tide developers over. We have also recommended some strategies for "sloppy" application of link behavior in cases where this is acceptable to all applications and users involved.[10] However, for the sake of all styling technologies with the same problem (some of which may not be able to be upgraded in the near future), we recommend that a subset of XPointer be created that eliminates ranges (and possibly string ranges), in order to offer a version of XPointer whose data model has a better match with these technologies. In this way, applications could choose to claim compliance to this subset or require use of it as appropriate. This subset could perhaps take the form of a new scheme, such as #xptr-basic(...). [9] http://www.w3.org/XML/Group/2000/08/NOTE-xml-link-style.html#range-ligs [10] http://www.w3.org/XML/Group/2000/08/NOTE-xml-link-style.html#spec-range-display Possible decisions:
Resolution: 3/ The working group examined various options. The ensuing strawpoll clearly indicated that a large majority of the working group preferred to keep the range support as is and not provide an intermediate level of conformance. |
[XP81] mismatch XPointer here() vs. DSig's here()Source: XML DSig grouphttp://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Sep/0040.html Summary: XPointer and XML DSig here() functions diverged again [...] Now the question occurs, if an Xpointer in an instance is interrupted by a processing instruction or a comment, what should "here()" return? [...] John Boyer was invited to the WG meeting to discuss it: John Boyer: here() is expected to return the text-node/attribute/pi containing it. The XPath transform in DSig In order to do a signature they needed something similar to here() . Problem when here() append on textual content. Eve: the spec doesn't handle the case of a non-single node. John: for text node we return the parent element instead Jonathan: here() cannot return an attribute node in practice. no problem to give back the parent instead. Possible decisions:
Resolution: 3/ The WG had to vote on the issue |
[XP82] Editorial changesSource: Daniel Veillard Summary: formatting and examples - could it be possible to get numbering on the productions like any other spec ? - the fisrt example in 4.1.2 XML Escaping seems to have a problem, I read: xpointer(book/chapter position() <= 5) which is nonsense while I would expect xpointer(book/chapter[position() <= 5]) from the context - the last example is wrong: xpointer(id('list37')/item[1]/range-to(following-sibling(item)[2]) should be xpointer(id('list37')/item[1]/range-to(following-sibling::item[2]) following-sibling is an axis, not a function :-) See also related issue XP42 Possible decisions:
Resolution: 1/ fix those |
[XP83] Conformance sectionSource: Jose Kahan http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000OctDec/0027.html Summary: Hard to find the conformance definition On the other hand, the only way I could find out the conformance criteria was by doing a word search on the document using the keywords given in section 3. I have an idea of what is mandatory now, but I can't say I'm 100% sure if it's the whole spec or just some parts of it. A more explicit conformance section, such as the one given in the SVG spec[1] would have been made this clearer, for example by summarizing all the functions and things (without going into detail) that are required, optional, and so on. [1] http://www.w3.org/TR/SVG/conform.html See also related issue XP42 Possible decisions:
Resolution: 1/ Add a sentence saying there is no optional part and compliance can only be claimed by full implementation |
[XP84] Scheme Registry and Mime-TypesSource: W3C staff review, CR exit criteria, Gavin Nicol, etc... Summary: the scheme mechanisme possibly allows to reuse and mix new fragment identifier definitions, but the way the extension should be handled is unclea The CR version simply disallowed defining new schemes, with a pointer to the errata page: Because there is no way to avoid conflicts in scheme naming and use, the only scheme allowed in this version of the XPointer specification is xpointer. All other scheme names are reserved. Users who want to define or use new schemes are invited to check the XPointer errata document [ERR] for a possible solution. Though schemes served other schemes within XPointer it was suggested that this get fixed, and generated a voluminous discussion started in the level of conformance thread. Possible decisions:
Resolution: 3/ and 4/ this was actually done by adding a scheme syntax conformance level in Section 3.3 and Section 4.3 |
[XP85] (was XL101) Parameters of URI usage in role attributesSource: Eric van der Vlist http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0013.html Summary: about URI references used by semantic attributes About URI references used by semantic attributes : > The value of the role or arcrole attribute must be a URI reference as > defined in [IETF RFC 2396]. The URI reference identifies some resource > that describes the intended property. When no value is supplied, no > particular role value is to be inferred. Disallowed URI reference > characters in these attribute values must be specially encoded as > described in 5.4 Locator Attribute (href). Questions such as : - are relative references allowed ? - how should they be processed ? - when are 2 semantic attributes equal ? can be left to the application designers, but aren't we risking, to some extent, to see the same debates than for namespaces URIs ? Also see Jown Cowan's forwarded comment from Simon St. Laurent and ensuing thread. Possible decisions:
Decision: 1/ Disallow relative URIs for arcrole and role |
[XP86] MD1 Classes of XPointerSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 3.5 Classes of XPointer Errors "syntax error": "and applications must not attempt to evaluate it as an XPointer" This restriction conflicts with the last sentence of the section: "This specification does not constrain how applications deal with these errors." I'd remove the restriction. (If you think it should stay, then why isn't there a similar restriction for resource errors? Why is there no restriction on the location-set yielded by an XPointer with a sub-resource error?) In any event, discussion of how applications deal with syntax errors should not be within the *definition* of "syntax error". Possible decisions:
Decision: the xpointer expression is evaluated left to right, if a sub-resource error is found when evaluating a scheme then the processing should be done on next scheme, but if it is a syntax error the evaluation stops. |
[XP87] MD2: XML EscapingSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 4.1.2 XML Escaping "Note that if XML-based languages define elements or attributes containing URI references (such as XLink's href attribute shown above), the relevant element content or attribute values also require the processing defined in 4.1.1 URI Reference Encoding and Escaping." So shouldn't you complete the example by performing this processing? You could put the final result in a third box, so that the result of just the XML-escaping is still clear from the first two boxes. You might also note that if the URI-escaping were performed first, it would (among other things) change "<" into "%3C", which would (1) make XML-escaping unnecessary, and (2) result in a slightly different fragment identifier for the same XPointer.Eve said about this one: I'm inclined not to follow his suggestions, just to keep the section simple. Any opinions? And a sanity check: Is he right about URI-escaping obviating the need for XML-escaping? Possible decisions:
Decision: This generated a large thread involving Martin Duerst. Jonathan made a proposal it was discussed with Martin which suggested some clarifications. This is a 3 steps processing. editor to add the description of this processing in a new 4.1.1 section. |
[XP88] MD3: Forms of XPointerSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 4.2 Forms of XPointer StringWithBalancedParens: The EBNF does not admit escaped (unbalanced) parentheses. Yes, the validity constraint allows them, but I think it's unusual for a VC to be more permissive than the EBNF. Normally VCs are more restrictive. In the EBNF, you could change "[^()]*" to ( [^()] | '^' [()] )* which you might want to split off into its own production. (This, like the original, allows arbitrary occurrences of circumflex. You could disallow it in the EBNF, but only by having two different uses of circumflex in the same expression. In the VC, you might want to say "Any other occurrence of circumflex results in a syntax error.")Eve said about this: In this case, I'm inclined to leave the BNF nice and simple, and instead change the last sentence in the VC from: "If the unescaped parentheses in the expression are not balanced, a syntax error results." to: "Any other occurrence of a circumflex results in a syntax error." Possible decisions:
Decision: Keep the BNF as it is, add a sentence about the extra syntax rules not expressed by the BNF. Gavin Nicol objected. |
[XP89] MD4: Definition of Point LocationSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.3.1 Definition of Point Location "the location preceding any individual character ... in an XML document": Might as well say "preceding or following", as with nodes. Actually, a point can't represent *any* such location, in particular it can't represent locations between markup characters.David simply said about this: He is correct.Chris said about this: We should be more careful; what we really mean is any individual character that would create a character information item if we were using the infoset: i.e., characters in text nodes, attributes, processing instructions, comments. Markup, as such, doesn't exist in our data model and is therefore not addressable. Possible decisions:
Decision: just add "of the data set constructed from" before "of an XML document". |
[XP90] MD5: Definition of Point Location IISource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.3.1 Definition of Point Location What about the `parent' axis? Does a point location have a parent? What about the `preceding' and `following' axes? What about the `self' axis? One guesses that it would contain just the point itself. Possible decisions:
Decision: following and preceeding are also empty axes for points. |
[XP91] MD6: Definition of Range LocationSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.3.2 Definition of Range Location Can the start and end points be in different entities?Chris said about this: Yes. Our data model is entity ignorant, except for base URIs, right? Consider: <!DOCTYPE xmp [ <!ENTITY foo "bar"> ]> <xmp>This &foo; is closed. Go home.</xmp> If you make a range from the start of the singular text node to a point seven characters in, you've crossed an entity boundary. David said about this: Yes, since a point is a pair of a node and a child-number, and a range is just a pair of points. Possible decisions:
Decision: inherited and defined in XPath |
[XP92] MD7: Definition of Range Location IISource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.3.2 Definition of Range Location "The axes of a range location are the axes of its start point." So if the `self' axis of a point contains just the point, then the `self' axis of a range contains just its start point, which is probably not what people would expect. Some of the other axes (e.g., `parent' and `following') are also a bit odd under this definition. Not that that's wrong, but it might be worth a note saying, "yes this is intentional".David said about this: This answers the question of what these axes mean. I don't have idea if these definitions are confusing, because I don't have a strong presupposition about what they _should_ mean. Possible decisions:
Decision: the definition as given is kept, but the editors will add an example to clarify |
[XP93] MD8: Covering Ranges for All Location TypesSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.3.3 Covering Ranges for All Location Types "This definition ensures that for a range location, [various axes] do not intersect and that they together contain all locations in the document (other than attribute, namespace, and range locations)." I think this paragraph is misplaced. I don't see how the definition of "covering range" has anything to do with establishing how a range's axes partition the document. In fact, the only use I see of the term "covering range" is in the definition of the "range" function. Maybe the content of this section should be moved there.Eve said about this: He may be right, but I'd like to keep the restructuring to a minimum. Would it work to move the final paragraph to the main section that defines ranges, and reword so that it doesn't seem to provide a rationale for anything? Possible decisions:
Decision: keep the definition but remove the final paragraph of the final bullet point |
[XP94] MD9: Covering Ranges for All Location Types IISource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.3.3 Covering Ranges for All Location Types And I think you'll have to add point locations to the "other than" list. As far as I can tell, no axis contains a point location except for the self axis of a point (or range, see above).Chris said about this: Erm. I *think* he's right.David said about this: I believe that he's right about where points can show up. Whether that decides the list-membership question isn't clear to me. In fact, the whole comment at the end of the definition seems opaque to me. The only place the words "covering range" appear outside 5.3.3, is in 5.4.3, in the definition of the "range() function" Possible decisions:
Decision: MD8 decision makes it moot, this paragraph is removed |
[XP95] MD10: range-to FunctionSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.4.1 range-to Function prototype: Change "expression" to "location". (Every argument is an expression. The prototype must give the expected type of the value of the argument.) Possible decisions:
Decision: make the change |
[XP96] MD11: string-range() FunctionSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.4.2 string-range() Function prototype: Delete space between "location-set" and comma. Possible decisions:
Decision: okay purely editorial |
[XP97] MD12: string-range() Function IISource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.4.2 string-range() Function the resulting range: What happens if third and/or fourth arguments specify positions that lie outside the string-value of the location?David said about this: It should be a sub-resource error, if it isn't. Possible decisions:
Decision: accepted mostly solved in a slightly different way by defining it an XPointer scheme part error. Accepted by existing clarification and substituting "string" by "position" |
[XP98] MD13: string-range() Function IIISource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.4.2 string-range() Function "indicates a string that is beyond": You mean wholly beyond, or even just partly beyond?Eve said about this: To me, this prose means "wholly", but I think our intent is "partly or wholly." Can I get an amen? Possible decisions:
Decision: Accepted by existing clarification and substitute "the third or fourth argument indicates a string" by "the third or fourth argument indicates a position" |
[XP99] MD14: Additional Range-Related FunctionsSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.4.3 Additional Range-Related Functions range-inside: The definition seems to ignore the possibility that x might be a point location: a point can't be a container.Chris said about this: It could be just a sub-resource error, but that's kind of a cop-out. Possible decisions:
Decision: 1/ Define range-inside for a point as being the point itself. |
[XP100] MD15: Additional Range-Related Functions IISource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.4.3 Additional Range-Related Functions "the function must signal a syntax error": Change to "no point is added to the resulting location-set".David said about this: I'd prefer it to be a sub-resource error (as it seems semantic). If it's possible to determine that this error has occurred _without_ accessing the document, then it _could_ be a syntax error under the rules that we've adopted. Possible decisions:
Decision: start-point() got fixed but not end-point() fix it in the same way: the XPointer part in which the function appears fails |
[XP101] MD16: here FunctionSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JulSep/0147.html 5.4.4 here Function "syntax error": I think "resource error" would make more sense.Eve said about this: I tend to agree with him, since the problem is a resource mismatch and can be determined by the act of accessing the resource.David said about this: This is a harder one, since we can't define the semantics of here() except in an XML document, and furthermore, any author (or program) creating XPointers in a non-XML document could be reasonably be expected to avoid this problem. These are reasons to keep things as they are. However, this means that there are essentially two XPointer _syntaxes_ depending on whether one is parsing within an XML document. This seems an undue burden on Xpointer parser implementors. I'd be inclined to make this a sub-resource error on that account. Possible decisions:
Decision: make the XPointer part in which the here() function appears fail |
[XP102] Editorial: Susan Lesch commentsSource: Susan Leschhttp://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0026.html The RFC 2119 key words are listed under 3, but are used throughout. Would it make more sense to place that definition under 1.2? Recommendation: There are three likely places to put this information: 1.2 (Notation and Document Conventions), 2 (XPointer Terms and Concepts), and 3 (XPointer Processing and Conformance). Picking the first seems better than the last. Let's accept the comment. In 4.2.1 and 5.4.2, whitespace -> white space (if you want to follow XML 1.0, see http://www.w3.org/TR/REC-xml#sec-white-space). Recommendation: Accept the comment. In A.2 References, I imagine that you will update the editors and date of XIS. Recommendation: Accept the comment. Deleting rowspan="1" colspan="1", and the thead and tbody elements from the tables in 4.1.3 will save a few bytes in file size. Is there some kind of production script that inserts these? It's hardly a problem in XPointer, but adds up in other XML specs with more tables. Recommendation: The production of the HTML output is controlled by an XSLT stylesheet, but this is a low-priority change. Accept the comment if we can find the resources to change the stylesheet. Decision: changes were accepted |
[XP103] Editorial: Status of document with respect to Sun patentSource: Andrew Watt http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0038.html The suggested changes apply to the "Status of the Document" section which currently reads, "XPointer is affected by a technology patent held by Sun Microsystems. The legal terms and conditions offered by Sun to XPointer implementors can be found in the archives of the public comments list.". To the best of my knowledge there is no reason whatsover to believe that ALL of XPointer is affected by Sun's claimed patent. I suggest that there be redrafting to indicate those aspects of the XPointer specification to which the Sun patent **may** apply. Thus the paragraph would more appropriately start, "Certain parts of XPointer may be affected by a technology patent held by Sun Microsystems. [specify here if you wish]." ... Possible decisions:
Recommendation: #1. Decision: the working group recommends to change it to something like "Certain parts of XPointer may be affected by a technology patent held by Sun Microsystems.", but ultimately the sentence is in the Status so it's under the W3C staff responsability to make this change. |
[XP104] Location set vs. XPath node listSource: Andrew Watt http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0039.html It seems to me that there is an error in the 8th January 2001 XPointer WD. It states as a definition of "location-set": "An ordered list of locations, such as produced by an XPointer expression. This corresponds to the node-set that is produced by XPath expressions, except for the generalization to include points and ranges." However the November 1999 XPath Recommendation defines a node-set as: "an unordered collection of nodes without duplicates" Thus there appears, contrary to the XPointer WD, to be a further distinction between an XPointer location-set and an XPath node-set in that the location-set is _ordered_ while an XPath node-set is _UNordered_. The alternative interpretation is that if an XPointer location-set is a generalisation of an XPath node-set to include points and ranges then it too is unordered. I couldn't readily find clarification in the XPointer WD. Possible decisions:
Decision: Accepted, the definition of location-set is changed to: "An unordered list of locations, such as produced by an XPointer expression. This corresponds to the node-set that is produced by XPath expressions, except for the generalization to include points and ranges. Just as for a node-set, a location-set is treated as having a specific order depending on the axis that is operating on it. However, this ordering depends on XPointer's extended notion of document order as defined in Section 5.3.5, rather than XPath's original notion of document order." |
[XP105] Allow additional schemes for */xml media typesSource: C. Michael Sperberg-McQueen http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/att-0053/01-xptrrev.html The end of para 1 suggests that the extension facilities described here are to be used only with MIME types other than text/xml, application/xml, etc. If it were feasible (I bow to the considered opinion of the WG on this), I think it might be useful to allow extensions even in material shipped with these types. The example I have in mind is XML Schema. XML Schema documents are likely to be shipped as text/xml or application/xml (the XML Schema spec is to be agnostic on this point), but users would, I think, benefit from a scheme allowing the simple identification of arbitrary schema constructs by reference to their nature and local name, without reference to the element structure of the schema document in which they happen to be declared. I don't see any severe problems arising in consequence, but this may reflect naïveté on my part and I am willing to be enlightened. Section 3.3 seems to imply the opposite, that unknown schemes will be skipped (not treated as errors) in fully conformant applications. That suggests that the wording here might need to be revised. Possible decisions:
Recommendation: #1. Were we to allow arbitrary additional schemes for */xml, the registration document for these media types would need continual maintenance. Our "scheme scheme" was intended to allow for extensibility through exploitation of the media type registration process, so that neither W3C nor IETF would be in a position to have to keep track in a central way. On the matter of the implication that additional schemes are okay, the point is to allow resources to be served up under several media types without breakage of URI references that point into them, so this is consistent. Resolution: not accepted, Eve gave an answer to Michael on this issue, and both the WG and Michael accepted it |
[XP106] Editorial: Sperberg-McQueen commentsSource: C. Michael Sperberg-McQueen http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/att-0053/01-xptrrev.html Section 3.3 Application conformance: For "items comprising minimal conformance" read "items comprised in minimal conformance" or "items included in minimal conformance". Recommendation: Accept the comment. Section 4.1.1 Escaping Contexts: For the reference to IURIs you should probably now substitute a reference to IRIs, as defined by Masinter and Dürst's Internet draft. Recommendation: Accept the comment. Decision: Accepted |
[XP107] Resolve Sun patent situation before CRSource: Wayne Carr http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0063.html We are very concerned about the IPR situation in XPointer. We don't think precedent should be set for the type of terms that are being required for IPR on XPointer. The group should attempt to work around the patent before proceeding to Candidate Recommendation. Possible decisions:
Decision: Reject, unfortunately it's not workable at the XML Linking Working Group level. This need to be handled at the Company and W3C level, this may influence the way W3C members will vote at the Proposed Recommendation stage or even whether Proposed Recommendation is granted. The working group has not resolved the issue and defer the treatment of this issue to the next layer of processing. |
[XP108] Assign namespace name to XPointerSource: Henry Thompson http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0074.html I agree that it's not immediately obvious that there's any need for a namespace URI in the short term, but it wouldn't hurt to establish it now for future use, e.g. to have an XML Schema with a simple type definition for the XPointer subset of xs:uriReference. Possible decisions:
Resolution: We will use http://www.w3.org/2001/05/XPointer |
[XP109] (Mostly) editorial: Mark Polman comments/questionsSource: Mark Polman http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0073.html 1) In Section 5.3.4, two new tests for location selection are introduced: "point" and "range". Does anybody have an example of a situation in which these tests actually return a non-empty location set? The only one I can think of is self::point(), under the condition that the context location is a point. It seems to me that an axis can only preselect node-locations and point-locations (only in the case of a "self"-axis). How would it be possible to select ranges from these? Is there an issue with this part of the spec? Resolution: small rewording of 5.3.4 5.3.4 Tests for point and range Locations XPointer extends the XPath production for NodeType by adding items for the point and range location types. That production becomes as follows: NodeType [11] NodeType ::= 'comment' | 'text' | 'processing-instruction' | 'node' | 'point' | 'range' This modified definition is included here in order to insure that there is a node test for every kind of location. In principle it allows NodeTests to select locations of type point or range from a location-set that might include locations of more than one location type. NOTE: In practice such sets are unlikely to arise other than artificially, but as implementation simply requires filtering the current location set by location type, the implementation burden is slight. 2) In Section 5.3.1, the axes of a point location are defined. What is the point of the last item: "A node-point's siblings...after the node-point", when before it is stated that the preceding-sibling and following-sibling axes are empty? Is there an issue with this part of the spec? Decision: redefine precisely the various axis for points, add a graphic to make the relationship between sibling points clear. 3) Also, what is the definition of the "following" and "preceding" axes? Are they delegated to the XPath semantics? Recommendation: Respond "yes". Decision: the "following" and "preceding" axes are added (in the first bullet of the list) as empty. 4) Also, is there a reason why items 3 and 4 explicitly refer to NODE-points instead of just points? Possible decisions:
Decision: Accepted, replace "node-point" with "point" in 3, 4 and 5 |
[XP110] Editorial: Michael Dyck general/header commentsSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html In general, I think the spec would be ultimately clearer (especially to those who would introduce a new scheme) if it were structured as two specs, one that defined the general XPointer framework, and another that defined two schemes ('xpointer' and 'xmlns') that fit into that framework. At the very least, it would be less confusing if the spec used different terms for the two things. (E.g., "XFragmentIdentifier" [XFragId] for the general framework, and "XLocator" or [the existing] "XPtrExpr" for the `xpointer'-specific expressions.) Possible decisions:
Recommendation: #2. Decision: The working group did not reach consensus on splitting the specification, largely because the perceived cost of such a major structural change late in the process would outweight the benefits. Decision: keep the terminology as is, Eve made an analysis and it seems we use XPointer uniformly in the spec to mean the full interpretation of XPointer. Throughout, change "[IETF I-D XMT]" to "[IETF RFC 3023]" and delete the "Internet Draft" that occasionally precedes it. Recommendation: Fix here and in Appendix A. Decision: accepted Status of This Document: 4th para: "This document is intended to be taken in conjunction with [x], in order for that document to officially designate XPointer ..." Awkward construction. How about just: "It is intended that [x] officially designate XPointer ..." Recommendation: Keep as is. This spec has been developed with the knowledge of the authors of the eventual registration document, which is what we mean; plus, the suggested wording isn't much less awkward than the present wording. Decision: change the beginning of the sentence to "It is intended that an IETF registration document eventually designate XPointer ... " Status of This Document: 4th para: Italicize "XML Media Types"? Recommendation: Keep as is. Decision: purely editorial let the editor decide Status of This Document: 4th para: "However, because of the timing problem associated with publishing two related documents on separate tracks, currently that document ..." It's not so much the timing problems of publishing, but simply the fact that the XML Media Types document came into existence before the XPointer document reached Recommendation stage. Change to "Currently, that document ..." Maybe join it to the next sentence with "but". Recommendation: Accept both parts of the comment. Decision: purely editorial let the editor decide |
[XP111] Editorial: Michael Dyck Section 1 commentsSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html Introduction: 1st para: "IETF RFC 2376" Obsoleted by "IETF RFC 3023". Recommendation: Fix here and in Appendix A. Decision: accepted Introduction: 1st para: Section 5.2 (first bullet) makes it clear that "an application [may use] XPointers in another context than as a URI reference's fragment identifier", but it would be helpful if you said this in the introduction too. Recommendation: Accept the comment. Decision: rejected, we were chartered only to define a fragment identifier syntax section 5.2 were for completeness only Introduction: 1st para: -- 4th para, 3rd bullet: "in URI references as fragment identifiers" -> "as fragment identifiers in URI references" Recommendation: Reword the entire third bullet as "Be used in URI references to address into resources" and move it to be the first bullet. Decision: Reword the entire third bullet as "Be used in URI references to address into resources" and move it to be the first bullet. Introduction: 1st para: Note: "the basis of" Vague? Change to "the language for"? "XPointer is intended ... only for [text/xml, etc]" No, not *only* those resources, as the rest of the note goes on to say. Maybe "primarily" or "initially", but not "only". Recommendation: Change "XPointer is intended to be the basis of" to "XPointer is defined to be the language for". Change "XPointer is expected to be useful as a fragment identifier language for the generic XML aspects of those media types" to "However, XPointer is also suitable to be used as the basis for new fragment identifier languages for other XML-based media types." This note was not properly updated when we invented the new "scheme scheme." 1 Introduction: 1st para: "a recent Internet Draft [...] suggests the use of a naming convention ..." -> "[IETF RFC 3023] encourages the use of the suffix "+xml" ..." Recommendation: Accept the comment. 1.2 Notation and Document Conventions: last para: "[XPath] is the normative version" "version" -> "reference" ? "specification" ? Recommendation: Change to "XPath is normative." Decision: the others suggestions in this section were editorial and the editor is allowed to do the required word-smithing. |
[XP112] Editorial: Michael Dyck Section 2 commentsSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html Definition: range "end points" -> "points" (The rest of the spec is consistent in using "end point" only in contra- distinction to "start point", and not as a catch-all for both.) Definition: location "range" -> "ranges" Recommendation: Accept the comments. Definition: singleton "A point is always a singleton. A range is always a singleton as well," No, this is a confusion of categories. A point or range is a *location*, not a *location-set*. Thus, it is meaningless to speak of a point or range being a singleton or not. Maybe this definition should be deleted, given that the only use of the term outside this definition is, in fact, a mis-use. (See 5.3.2.) Recommendation: Delete the definition and the text in Section 5.3.2 that says "(encompassing both these nodes, but still a singleton)". Our further refinement of the definitions of location and location-set over time has made the concept clear enough. Definition: sub-resource "is an XML document" -> "may be an XML document" (Since it might instead be an external parsed entity.) Recommendation: Change to "is an XML document or external parsed entity ... inside the document or entity". Decision: suggestions in this section were editorial and the editor is allowed to do the required word-smithing. |
[XP113] Editorial: Michael Dyck Section 3 commentsSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html 3.3 Application Conformance: I think it would be useful for the definition of application conformance and classes of errors, to define an "XPointer-processor" abstraction. The definition would go something like this: Given a resource (purportedly an XML document or external parsed entity) and a string (purportedly an XPointer), an XPointer-processor yields the subresource (location-set) identified by the XPointer or else an error. Then, for instance, instead of phrasing such as "Minimal conformance entails ..." (which avoids even a referent for the thing whose conformance is in question), one could say "An XPointer-processor is minimally conforming if it ..." Recommendation: Add the recommended definition as the first sentence of the first paragraph in Section 3.3 (except remove the hyphen in the new term). Change the (now) second sentence in that paragraph to "two levels of conformance of XPointer processors". No other changes are needed to the spec, which routinely refers to "XPointer processing" -- which will be understood as a clear reference to the newly defined term. (He has other comments that invoke this new concept, and I find it helps in these cases, so new mentions of "XPointer processor" might be added if those comments are accepted too. Decision: add the definition of an XPointer-processor but add the fact that it is fully conformant. -- Definition: Minimal conformance: "series of XPointer parts" -> "FullXPtrs" Recommendation: Keep as is. "XPointer part" is well defined as a prose synonym for the FullXPtr nonterminal, and its instance here is linked to the definition. Decision: keep as is "routing XPointer parts with particular schemes to an application that can evaluate those parts" This wording seems fairly implementation-specific. From the point of view of someone judging the conformance of XPointer-handling software, whether that software routes parts to other applications is immaterial. Recommendation: Not sure. Would saying "handling each scheme appropriately" be more abstract and yet helpful enough? Decision: kee as is, we don't see it as a point of confusion since it describes an abstract model. The placement of the closing bracket is arbitrary. Move to end of sentence. Recommendation: Accept the comment. So, as long as it handles bare names, an XPointer-processor that yields a sub-resource error for every FullXPtr is minimally conforming, since it can claim not to understand any schemes. In which case, why not just say that minimal conformance only entails interpretation of bare names? Recommendation: Keep as is. Minmal conformance also entails proper handling of the "scheme scheme," however we choose to word our description of this handling. Decision: keep as is, this is a divergence in interpretation of what is an XPointer processor, it must understand the xptr scheme last para: "for the convenience of XML-based Internet media types" Maybe insert "other" before "XML-based". Recommendation: Keep as is. The rest of the sentence makes clear that we mean media types other than the ones for which XPointer itself will be mandated. 3.4 Classes of XPointer Errors: Definition: resource error: "If a syntactically correct XPointer ... is appended to a URI that identifies no resource, ... the XPointer has a resource error." This is odd. If a URI identifies no resource, then there is no media type, and thus no fragment identifier language (FIL). So it's a moot point whether the fragment identifier is an XPointer, and "even mooter" whether the fragment identifier is erroneous. The XPointer-processor would presumably not even be invoked in such a case. As for "a URI that identifies ... a resource that is not well-formed XML", this includes resources of most media types (e.g., image/jpeg, audio/mid, text/plain), and these do not use XPointer as their FIL. Thus, again, it is incorrect to think of the fragment identifier as an XPointer. In fact, even if the resource *is* well-formed XML, it doesn't necessarily have a media type that uses XPointer as its FIL. So it *still* might be incorrect to think of the fragment identifier as an XPointer. Moreover, the definition suggests that whether an XPointer has a resource error is determined when it is appended to a URI, but this is presumably not what was intended. Whether a URI identifies a resource, the content of that resource, and the media type of that resource, all vary over time. Thus, whether an XPointer has a resource error would depend on when the URI is resolved. I think all of these problems would be solved by rephrasing the errors in terms of an XPointer-processor abstraction: If the string passed to the processor does not match the syntax specified in this document, the processor yields a syntax error. Otherwise, if the resource passed to the processor is not a well-formed XML document entity or external parsed entity, the processor yields a resource error. Otherwise, the processor attempts to evaluate the XPointer with respect to the resource as described in section 4. If the evaluation fails as discussed in 4.3 Schemes, the processor yields a sub-resource error. Note that this doesn't mention URIs at all, which is as it should be, since "resource error" is a meaningful concept whether the XPointer is the fragment identifier of a URI or not. Recommendation: Though this may seem like a fairly invasive change, I recommend making it. It is much better motivated than the current wording, while not changing the intent at all and while leveraging the entirely natural definition of "XPointer processor" that I recommended accepting above. Decision: left to the editor, seems there is a bug in the second paragraph, (addition) "Otherwise, if no resource or an empty resource is passed to the processor, the processor yields a resource error." Decision: other items in this groups were considered editorial and letf to the appreciation of the editor |
[XP114] Michael Dyck Section 4/4.1 comments |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html |
The WG should discuss (e), (h), (i), (k), (n), and (o). Resolution: all other issues were considered editorial |
(a) |
2nd para: 'such as "footnote"; or select' Insert "one can" before "select". |
Recommendation: Accept the comment. |
(b) |
4.1 Character Escaping: -- 1st para "The XPointer language is designed to be used in the context of URI references, ..." Once again (as in the introduction), it would be good to say that XPointers can be used in other contexts as well. "is designed to be" -> "may be" ? |
Recommendation: Keep as is. The point has been made, and we don't want to weaken the fact that XPointer's main chartered function is to be the official fragment identifier language for certain media types. |
(c) |
"XPointers (in URI references) also often appear ..." Insert "possibly" before "in". |
Recommendation: Keep as is. If they appear in other places, they are something else. The parenthetical remark is for clarity. |
(d) |
"Finally" Presumably you only mean "finally in this list of contexts", but it suggests "finally in the order of applying the escaping". Change to "Moreover"? |
Recommendation: Accept the comment. |
(e) |
4.1.1 Escaping Contexts: You should point out that an XPointer can occur in many other contexts (a string-literal in a Java program, a comment in a LaTeX document, etc.) and these will generally have their own escaping requirements. The ones outlined in this section are just the most common. This spec is normative only for context A. In all other cases, the specification that governs the context is the normative reference for the necessary escaping. Also, an XPointer may appear in many contexts at once (e.g., an XPointer in a URI reference in an XML document in a Java string-literal), but these are always nested in a particular order, and it is the nesting order that determines the order in which the escaping and unescaping is done. (The most deeply-nested context does the first escaping and the last unescaping.) |
Recommendation: Accept the comment, and add language very much like what is said here. However, I would like to get this checked by either I18N folks or the escaping-knowledgeable people in our group. Resolution: add a single sentence in the paragraph before 4.1.2 "an XPointer can occur in many other contexts and these will generally have their own escaping requirements." |
(f) |
-- A: "When an XPointer is created that addresses into an XML resource" This is redundant. An XPointer *can* only address into an XML resource. Unless you mean to exclude XPointers that don't address into anything, because of resource errors. But that would be silly, because you'd still need the escaping. I suggest changing it to: "When an XPtrExpr [or XPath Expr] occurs in an XPtrPart" because that reflects the syntactic level at which this escaping becomes necessary. |
Recommendation: Change to "An XPointer might need to contain characters that are significant..." |
(g) |
"Thus, occurrences of the circumflex..." This sentence is mostly redundant given the previous sentences, and completely redundant given the referenced section. |
Recommendation: Change to "...must be escaped as described in 4.2 Forms of XPointer." The benefit of restating this had been to imply the proper implementation order, but this should be left as an exercise for the implementor. |
(h) |
-- B: "Escaping of reserved URI characters" This heading is not very appropriate, since the section only considers the escaping of one URI-reserved character, the percent sign. |
Recommendation: Rename the section "Escaping of URI-reserved characters". Since RFC 2396 defines a class of characters called "reserved", we don't want to be ambiguous. We should check this with the I18N folks just to be sure, though. Resolution: keep as is, this section was designed closely with the I18N working groups and is used as reference in other specs, we would perfer not changing it at that point. |
(i) |
-- C: "If an XPointer appears in a URI reference or IURI reference in an XML document" Delete "in a URI reference or IURI reference": it is immaterial to the need for escaping. You may wish to change it to "in the character data of an XML document", since this escaping wouldn't be necessary if an XPointer appeared in, for instance, a comment in an XML document. (Although in that context, you *would* need to somehow escape any occurrences of "--".) |
Recommendation: I'm tempted to accept this comment because it strengthens the appearance of these contexts as being, not steps in a process, but totally independent. But I'm wary of touching too much here, if the extra wording doesn't harm anything. Resolution: keep as is, this section was designed closely with the I18N working groups and is used as reference in other specs, we would perfer not changing it at that point. |
(j) |
"must be escaped as character references" Or as entity references (e.g., ") Or you could embed them in CDATA sections. |
Recommendation: Keep as is. The description we have is accurate, if the reader goes through the whole sentence. |
(k) |
"This escaping is removed when the XML document is parsed." "removed" sounds like it's removed from the file containing the XML doc. Maybe change to "undone" or "reversed". |
Recommendation: Don't know. Resolution: use "replace" since that's what is used in the XML-1.0 specification |
(l) |
-- D "an XPointer (perhaps originating in an XML document)" What does "originating" mean here? If the XPointer was "originally" in an XML document, where is it "now"? Do you just mean "(perhaps in an XML document)"? |
Recommendation: Keep as is unless somebody has a better suggestion. |
(m) |
I dislike the division between B and D. Section B considers two contexts, URI references and IURI references, but only gives the escaping that is common to the two. To get the rest of the escaping for the URI reference context, the user must also consult section D. Moreover, the escaping described there supposedly occurs when an IURI reference is converted to a URI reference, which casts the process in terms of IURI references, which is unnecessary. (If the user doesn't understand what an IURI is, or knows that the situation does not allow them, s/he shouldn't have to think in terms of IURIs.) Instead, I suggest you rework these two sections so that one considers just IURIs, and the other just URIs. Also, because they are related, I would make them adjacent sections. (Insert D between B and C.) |
Recommendation: Reworking is not an option. Reordering of D to go just after B might be. Opinions solicited. |
(n) |
"Square brackets ..." Move to 4.1.2. |
Recommendation: Didn't we already determine that the square bracket stuff belongs in D, not B? Can we confirm this? Resolution: Keep as is, that was approved by the IETF |
(o) |
-- last para: "in the reverse order" The reverse of what? You haven't specified the "forward" order. (But I've given some wording above that does.) "If the result [of undoing the encodings and escapings] does not conform to the syntactic rules for XPointers in this specification, a syntax error results." But if you undo escaping A, the result may have unescaped unbalanced parentheses, which are not permitted by the "Parenthesis escaping" VC. And if you think that "the syntactic rules" does not include VCs, note that the bare EBNF disallows unbalanced parentheses, escaped or not. So either way, a syntax error would supposedly result, which is not what you want. I suppose you could say "If the result, before undoing escaping A, ..." but that's pretty ugly. If you adopt the idea of an XPointer-processor, you could say something like (very roughly): The XPointer-processor handles undoing A. All other escaping is undone (in reverse order of application) outside the processor. If the result (passed to the processor) does not conform ... the processor yields a syntax error. |
Recommendation: Adopt roughly the wording proposed here. Resolution: Accept the change and his wording since we also included the definition of an XPointer processor: The XPointer-processor handles undoing A. All other escaping is undone (in reverse order of application) outside the processor. If the result (passed to the processor) does not conform ... the processor yields a syntax error. |
[XP115] Editorial: Michael Dyck Section 4.1.x comments |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html |
These are all purely and trivially editorial. Resolution: all issues were considered editorial |
(a) |
4.1.2 URI Reference Encoding and Escaping Various occurrences of "byte(s)": Change to "octet(s)", I think. |
Recommendation: Keep to byte, which aligns with XLink. Doublecheck this in both specs. |
(b) |
4.1.3 Examples of Escaping -- 1st para "and spaces that is" Awkward. Put comma after "spaces"? Put "containing ... spaces" in parentheses? |
Recommendation: Keep as is. |
(c) |
"appear in an XML document" Insert "in a URI reference" after "appear". |
Recommendation: Keep as is. |
(d) |
-- Initial "The desired XPointer ..." Maybe change "XPointer" to "XPtrExpr", and remove "xpointer(" and ")" from the example text. (See my suggested rewording under 4.1.1 A.) |
Recommendation: Keep as is. Already rejected above. |
(e) |
-- A Delete "doc.xml#", since it's part of the (I)URI reference, which doesn't enter into it yet. (Note that the second example doesn't have "doc.xml#" at stage A.) |
Recommendation: Accept the comment. |
(f) |
The example is a little muddled. The string at C shows the escaping for an IURI reference in an XML document, whereas the string at D shows the escaping for a URI reference, possibly in an XML document. If D is the final form in this example, the string at C is irrelevant. On the other hand, it could be that C is the final form and D is irrelevant. I think you should pick one. Ditto for the second example. |
Recommendation: Keep as is. These were carefully worked on and approved. |
[XP116] Editorial: Michael Dyck Section 4.2/4.2.x comments |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html |
The WG should discuss (c), (g), and (l). Resolution: all the other issues were considered editorial |
(a) |
4.2 Forms of XPointer -- 1st para "as if the full form of the XPointer were specified" "specified" -> "given" |
Recommendation: Keep as is. |
(b) |
-- 3rd para "Any XPointer whose evaluation returns anything other than a non-empty location-set must signal a sub-resource error" This makes sense for an XPtrPart whose scheme is "xpointer", but what if some other scheme adds 'thingies' to the data model, and has SchemeSpecificExprs that yield them? Anyway, this sentence doesn't belong here. Move it to the 4th para of 4.3? |
Recommendation: Accept the comment, approximately. The comment should be removed from 4.2, and it should be stated in 4.3 that any xpointer()-scheme XPointer part must fail if it returns an empty location set. |
(c) |
-- production [4] In 4.3 Schemes, you allow for the possibility that a future XML-based media type might choose to adopt the XPointer scheme mechanism, but define its own scheme instead of the "xpointer" scheme. Consider the specification for the fragment identifier language for that media type: in defining the syntax, would it have to say something like "ignore the first two alternatives for XPtrPart"? It might be more convenient for future media types if XPointer said just [4] XPtrPart ::= Scheme '(' SchemeSpecificExpr ')' and then defined `xpointer' and `xmlns' as particular schemes, in the same way that future schemes will presumably have to be defined. |
Recommendation: Don't know. Consider the suggestion? It is indeed cleaner. Resolution: Keep as is: we need to be able to point at 2 specific productions defined by this specification and prefer to minimize changes to the productions at this point |
(d) |
-- Validity constraint: Parenthesis escaping
"XPointer part"
-> "
|
Recommendation: Keep as is. |
(e) |
"even within literals" "even" -> "typically" "literals" -> "a literal" |
Recommendation: Keep as is. |
(f) |
"escaped with a circumflex (^) character preceding it" -> "escaped by preceding it with a circumflex (^) character" |
Recommendation: Keep as is. |
(g) |
"Any other use of a circumflex results in a syntax error." So escaping *balanced* parentheses is invalid? (Software that generates xpointers might find it easier to escape *all* parentheses rather than figure out which ones are unbalanced.) |
Recommendation: Don't know. He has a point here. Resolution: Keep as is, escaping all parenthesis in general is not possible, they are needed for scheme boundary detection, only paranteses within string values may need to be escaped in practice. |
(h) |
-- Validity constraint: Namespace Name
"XPtrNsURI", "Name", "S", "Char", "NCName", "Expr"
Put in "
|
Recommendation: Keep as is. These are all coded as nonterminals or externally defined nonterminals, which is correct. |
(i) |
4.2.1 Full XPointers -- 1st para "one or more [Definition: ..." This is awkward. I suggest deleting the whole sentence, as it just repeats in prose what the EBNF already says more succinctly. |
Recommendation: Keep as is. It is important to define "XPointer part," and properly each type of XPointer should have an explanation. |
(j) |
"(except for nodes representing CDATA sections and entities)" Delete. No such nodes exist in the XPath data model. |
Recommendation: Accept the comment. |
(k) |
"and access to arbitrary non-node locations" If you mean "locations" in its XPointer sense, then this is tautologically true, but if it's read with a more casual sense, then "arbitrary" is misleading. Maybe delete the phrase, and change "nodes" in the previous clause to "nodes and non-node locations". |
Recommendation: Change to "...nodes and non-node locations in an XML document's data set." |
(l) |
4.2.2 Bare Names -- 1st para "a location step using the id() function" Syntactically, "id()" isn't a location step (i.e., Step), it's a FilterExpr. |
Recommendation: Don't know. Resolution: change the first sentence to "A bare name stands for the same name provided as the argument of id()." |
(m) |
-- 2nd bullet "that use a markup language similar to that of HTML" "markup language" -> "vocabulary" ? But is this phrase necessary at all? I mean, even for XML resources that *don't* use a HTML-like vocabulary, bare names *still* provide an analog of HTML fragment identifier behavior. |
Recommendation: Remove "that use a markup language similar to that of HTML." |
(n) |
4.2.3 Child Sequences -- 1st para "The first integer in the sequence refers to" "refers to" -> "locates", to match the verb used earlier in the para. The sentence as a whole is a bit too abbreviated. I suggest: "If the resource [passed to the Xpointer-processor] is a document, the first integer in the sequence will be 1, and locates the document element; if the resource is an external parsed entity, the first integer locates one of the top-level elements." Really, the sentence is unnecessary, since the semantics are defined by the "*[n]" equivalence, but it's helpful. |
Recommendation: Replace the second sentence of the first paragraph with the above suggestion, retaining the bracketed portion. |
[XP117] Michael Dyck Section 4.3 commentsSource: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html The WG should discuss (b), (h), and (k). (a)4.3 Schemes
-- 1st para
"XPtrPart", "Scheme", "XPtrPart".
Put in "
Recommendation: Keep as is. These are marked up correctly. (b)"reserves all others" It's not clear what this means. Is any other scheme a syntax error? A resource error? Or is the XPointer-processor required to treat it as an unknown scheme (and thus fail that part)? Or something else? What about when the XPointer is used in a context other than as the fragment identifier of a URI reference? Then there isn't necessarily a media type involved. Recommendation: We should clarify what kind of error (if any) this is. But I don't think we need to specify anything about occasions when it's used in a context not covered by this spec. Decision: If there is a binding that says an XPointer processor is supposed to handle this XPointer and it doesn't recognize a scheme, the right failure point seems to be on the scheme. This would be an XPointer part failure, and it should continue to the next part (if any). We need to clarify that. On his second point: We don't need to specify anything about occasions when it's used in a context not covered by this spec. (c)-- 3rd para
"XPtrParts"
Put in "
Recommendation: Keep as is. (d)-- 1st bullet "An unknown scheme" -> "The part's scheme is unknown." Recommendation: Keep as is, except to add periods to the ends of the first three bullets. The structure of the list is to start with noun phrases. (e)-- 2nd bullet "A scheme that is not applicable ..." -> "The part's scheme is not applicable ..." Recommendation: Keep as is; see above. (f)"the media type of the resource" What if there isn't a media type involved? Recommendation: Keep as is. This situation is not our problem. (g)-- 3rd bullet "A scheme that does not locate ..." -> "The part does not locate ..." Recommendation: Change to "An XPointer part that does not locate" (h)-- 4th bullet "If the scheme being interpreted is xpointer:" -> "If the part's scheme is xpointer:" Minimal conformance does not require interpretation of the 'xpointer' scheme, so this bullet does not belong here. Moreover, I disagree that these conditions should be grounds for a part to fail. (But I'll discuss that later.) Lastly, what does it mean for a point to be "of type attribute or namespace"? Recommendation: Accept the rewording. (However, note that for the four media types we're in charge of, minimal conformance isn't good enough.) But what to do about the problem with the last sub-bullet? Decision: We should break out the fourth bullet entirely into its own paragraph just below the list, and head it up by saying "Full conformance additionally requires the following part failure handling:". (i)-- 4th para "consume a failed XPointer part" "consume" -> "skip"? "XPointer part" -> "XPtrPart" "the first XPointer part" "XPointer part" -> "XPtrPart" Recommendation: Keep as is. (j)"the result for the XPointer as a whole has a sub-resource error" Delete "the result for". Recommendation: Accept the comment. (k)"If a syntax error is detected in any part or in the construction of the XPointer as a whole, evaluation stops and additional parts are not consumed" If there were a syntax error in the construction of the XPointer as a whole, then according to section 3.4, the application should not have attempted to evaluate it in the first place. (But apparently it did, since it must now stop evaluation.) Presumably, the processor is not required to detect syntax errors in the SchemeSpecificExpr of any part whose Scheme it doesn't understand. Say there is a syntax error in the SchemeSpecificExpr of a part whose Scheme the processor *does* understand, but that part occurs after another part that would succeed if evaluated. e.g., something like: xpointer(/)4Dgrafix-xml("unterminated literal) Is the processor required to detect the later syntax error (and thus stop with an error) before evaluating the first part, or is it required to detect scheme-specific syntax errors only if and when it gets to the part that contains the error? (In a "routing" implementation, you probably want the latter.) Recommendation: Don't know. Decision: The left-to-right nature of evaluation means that the later syntax error in his example wouldn't be caught. Does the existing wording need to be changed, though? We decided that it's redundant, but not false, so we're going to keep it. |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a) to discuss"XPointer" should probably be changed to "XPtrExpr Recommendation: drop by our decision on XP110 Decision: Keep as is, by our decision on XP110. (b)Put "which subsume ..." in parentheses and insert after "locations". Recommendation: purely editorial (c)This is kind of redundant given the first bullet. Maybe swap the two? Recommendation: purely editorial (d)Maybe reverse the order, as that's how they appear in 5.4. Recommendation: purely editorial (e)This should probably go after the fourth bullet Recommendation: purely editorial (f) to discussyou missed the range and range-inside functions. Recommendation: add them suggestion: add a 7th bullet with "The functions range and range-inside, to address to covering range of location sets." Decision: Take his suggestion: Add a 7th bullet with "The functions range and range-inside, to address the covering range of location sets." |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a) to discussmaybe change "XPointer" to "XPtrExpr" Recommendation: drop by our decision on XP110 Decision: Keep as is, by our decision on XP110. (b) to discussActually, the context must also contain properties for the locations that the origin() and here() functions return. Recommendation: he is right, add this Decision: Accept the comment; add that "the context must also contain properties for the locations that the origin() and here() functions return." (c) to discussAppend "or external parsed entity". Recommendation: Right, add this Decision: Accept the comment; add mention of "or external entity." (d) to discussFuture schemes will almost certainly define their own functions, so this is another obvious case where "XPointers" should be changed to "XPtrExprs". Recommendation: drop by our decision on XP110, disagreement on teh word XPointer Decision: Keep as is, by our decision on XP110; disagreement on the word XPointer. |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a) to discuss"XPointer part" -> "XPtrPart" "XPointer parts" -> "XPtrParts" Recommendation: keep as is c.f. other decisions Decision: Keep as is, by our decision on XP110, and the fact that there's an official definition for "XPointer part". (b)"NCName", "XPtrNsURI": Put in "<code>...</code>". Recommendation: Purely editorial (c) to discussThis suggests that if the XPointer appeared in an XML document that *did* have a declaration of the namespace prefix x, it *wouldn't* result in a sub-resource error. I think this is incorrect, since the first para doesn't mention anything about namespace declarations leaking from the containing document into the XPointer evaluation context. So delete "appearing ... prefix x)". Recommendation: right the xmlns() scheme is the only way to propagate a namespace to an xptr() expression now. Decision: Accept the comment; this is an old feature of the example that needs to be fixed. Delete the text "appearing in a non-XML document (or in an XML document with no declaration of the namespace prefix x)". Even though the example is now overkill (because it shows the same prefix attached to two namespaces when just one would have done), we'll keep it. |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a)-- Note "DOM Level 2, which is based on UTF-16 units" It would be more accurate to say that DOMStrings encode UCS characters using UTF-16, and the DOM indexes into them using 16-bit units. Thus, one UCS character results in one or two 16-bit units. "XPath and XPointer are based on UCS characters" In effect, implementations must behave as if they encode UCS characters using UTF-32 (UCS-4). "a sequence which in DOM counts as two characters might count in XPointer as one character" This is a misuse of the term "character", but I'm not sure what the proper term is. Something like "string indexing unit"? Recommendation: drop it this is Michael Notes on a point which is not directly part of our specification, keep as is Decision: He is looking for clarification, but more properly this should come from the DOM side, not ours. |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a)Is "point" not in bold because there's already a definition for it in section 2? That would be a shame, because this is the real definition. Recommendation: this is the definition Purely editorialm add bold (b) to discuss"preceding any individual character" Insert "or following" after "preceding". Recommendation: Right do it Decision: Did we mean this precise wording, or is this just an error of omission? Accept the comment, on the theory that keeping an asymmetric definition is awkward for implementation, and also add information about doing an equality test. (c)"is" -> "contains" (XPath terminology) Recommendation: Purely editorial, drop see (e) (d)"is a location set containing" -> "contains" Recommendation: Purely editorial, drop see (e) (e) to discussBut these two sentences don't really belong here (the content of its axes are not the defining properties of a point), and anyway, they're redundant given the 2nd and 3rd bullets. Delete them. Recommendation: He is right this doesn't pertains in the definition Decision: Accept the comment and delete the third-to-last and second-to-last sentences in the first paragraph of 5.3.1. (f)-- 6th para "(such as text nodes, comments, and processing instructions)" Change "such as" to "i.e.," and insert "attribute nodes" and "namespace nodes". (Why not be complete?) Recommendation: Purely editorial, do it (g) to discussAre "preceding" and "following" empty too? Recommendation: node point siblings are defined, what about character point siblings. Decision: drop "preceding" and "following" axis i.e. they are empty for points (h) to discussPresumably the "descendant-or-self" axis also contains the point itself. Recommendation: right, add it Decision: Accept the comment. (i) to discussDoes "ancestor-or-self" contain the point itself and the contents of the "ancestor" axis? Recommendation: right, add it Decision: right, add it (j) to discuss"A node-point's siblings are the children of the container node that are before or after the node-point." But the first bullet says that the *-sibling axes are empty. Recommendation: Purely editorial |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a)"range" isn't bold Recommendation: Purely editorial (b)If the target resource is an external parsed entity, there isn't a document. Recommendation: Purely editorial add "or external parsed entity" (c)"singleton" -> "single location" Recommendation: Purely editorial, right change this (d)Insert "start and end" before "points". Recommendation: Purely editorial, but do (e) instead (e) to discussreplace the whole para with this: The string-value of a range consists of the characters that are in text nodes and that are between the start and end points of the range. Recommendation: Unless I have missed somthing this covers both cases and should be accepted Discussion: after some discussion it appeared that keeping ranges 'terminal' w.r.t. axis computation wasn't a problem and keeping all axis of a range being empty is not a problem in practice. Decision: accepted all the axis for a a range are empty excepted *self which are the range itself. Add a note about start-point() or end-point() as intermediary step for doing axis computation from a range . this makes other points in this section moot. (f)"returns" -> "contains" Recommendation: Purely editorial, do it (g) to discussYou might want to add the weirder example that a range's self axis contains the range's start point, and not the range itself, thus falsifying the (reasonable) assumption that a location's self axis contains the location itself. I think you might be better off to decide that a range's self axis (and its *-or-self axes) contain the range itself, and all the other axes are empty. That way, you don't get snookered by the arbitariness of picking the start point over the end point. And you don't lose any capability, because you can always use "start-point" explicitly. For instance, if "r" selects (a location-set containing) a range, then r/parent::x (under the current semantics) would be replaced by start-point(r)/parent::x (under my semantics). Recommendation: while this semantic could have been chosen earlier on in the design considering the current state of the specification keep as is (h)"with respect to the respective boundaries" Clank. Delete "respective". Recommendation: Purely editorial, sure do it |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a)5.3.3-- 4th bullet Insert this after the first bullet, since it's simple and deals with an XPointer-specific location type, like the first bullet. Recommendation: Purely editorial (b)5.3.4-- 1st para
"NodeType": Put in "
Recommendation: Purely editorial (c)"[11]" -> "[38]" Recommendation: Purely editorial (d)"all three types" "three" -> "six" (or just delete it, or say "of many types") Recommendation: Purely editorial |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a)Put "immediately preceding node" in bold. It's a definition. Recommendation: Purely editorial (b)"the immediately preceding node is the node immediately preceding the point" This is circular. The rest of the bullet is verbose. Replace it with: "For a node-point with a non-zero index n, the immediately preceding node is the nth child of the node-point's container-node." Recommendation: Purely editorial (c)"the container node is also the immediately preceding node" For consistency of wording, change to: "the immediately preceding node is the node-point's container node" Recommendation: Purely editorial (d) approve quickly"the last of those [attribute or namespace] nodes" Append: "in document order. (Note that this is implementation-dependent.)" Recommendation: Nearly editorial, attribute and namespace node order is completely application dependant Decision: approved (e)Insert a comma after "character-point". Recommendation: Purely editorial (f)"For any point, the immediately following node" Put "immediately following node" in bold. Actually, this term isn't used anywhere. Delete the para. (Which is just as well, because I don't think "immediately after" is defined anywhere.) Recommendation: Purely editorial, remove after checking if not used (g) to discussThe rest of the section is muddled. Look at it this way: you have to define an ordering for every combination of node, point, and range: {node, node} - defined by XPath {node, point} - 4th para, using terms "before" and "after" {node, range} - 5th para, using the term "relative order" {point, point} - 6th para, using the term "document order" {point, range} - missed {range, range} - 7th para, using the term "before" So you missed the combination of point and range, and you used lots of different terms to do it. XPath mostly just defines the "before" relation. Recommendation: he has a point, follow his advices, refactor the section as one bulleted list. We need to help the editor on the {point, range} document order definition Decision: refactor the paragraph as suggested, for comparing a point to a range we compare the point to the start of the range which is one of the defined existing comparisons. (h)"a point" -> "two points" Recommendation: Purely editorial (i)"If the immediately preceding nodes of the two points are the same, then either the points are the same or they are both character-points with the same container node" This is not true. For instance, in "<e>foo<e>", consider: (1) the node-point whose container node is the <e> element node, and whose index is 1 (the point after the text node); and (2) any character-point whose container node is the text node. For both points, the immediately preceding node is the text node, but they are not the same point, nor are they character-points with the same container node. Recommendation: seems we missed to address this case i.e. the last point in the node, can someone suggest a rewording Decision: analysis of the problem. Node point and character points are relatively differents. We want to explain the document order to points. It won't fit into a single sentence, though. This part will be reworded and a graphic will be added (j)-- 7th para This relies on identifying "the one range" in the bullets with "one range location" in the first line, and "the other range" in the bullets with "another range location" in the first line. Which I suppose isn't unreasonable, but wouldn't it be clearer if you called them A and B, say? Recommendation: Purely editorial |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a)For consistency with XPath, in every function prototype, remove the space before the closing parenthesis. Recommendation: Purely editorial (b) to discuss-- 1st para "For each location in the context," This is misleading; there *is* only one location in the context. Delete. (You could say "For the location in the context" or "Given the location in the context" or just "Given the context", but they're all implied by the definition of evaluation context -- no other XPointer/XPath function is defined with such a phrase.) and "the location found by evaluating the expression argument with respect to that context location" It's not the function's job to evaluate the expression(s) that appear in a call to the function. XPath semantics say that the arguments are evaluated before the function is called, and the results are passed to the function. Change to: "the location that is the only member of the location-set argument". You could add: "(Note that [in accordance with XPath semantics] the Argument in the FunctionCall will have been evaluated with respect to the same context as the FunctionCall itself.)" There should be a sentence saying that it's some kind of error if the location-set argument doesn't contain a single location (isn't a singleton). Recommendation: don't touch it, this is the result of a long discussion at CR involving Michael Kay Issue (check range-to-definition in http://www.w3.org/XML/2000/10/xptr-CR-comments.html . The wording potentially change the semantic of the existing definition Decision: keep as is (c)"The start of the range" "start" -> "start point" "the start-point of the context location" Insert "(as determined by the start-point function)" after "start-point" "the end of the range" "end" -> "end point" "the end-point of the location" Insert "(as determined by the end-point function)" after "end-point". Recommendation: Purely editorial (d) to discuss-- 4th para "for each of the nodes in the current node list" "the current node list" is an undefined term. If we allow that readers will understand what you mean, you should still change "nodes" to "locations" and "node list" to "location list". Recommendation: sounds right, change it Decision: change approved (e)-- 5th para "start-point for the element", "end-point for the element" "for" -> "of" Recommendation: Purely editorial |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a)-- prototype "location-set ," Delete blank before comma. Recommendation: Purely editorial (b)-- 1st para "For each location in the location-set argument, string-range returns a set of string ranges" Italicize "location-set". Recommendation: Purely editorial (c)"a set of [Definition: string ranges ..." Awkward to start a definition in the middle of a sentence. Recommendation: Purely editorial (d) to discussAlso, it's not a very good definition. You could say: "A string range is a range whose start point and end point are both character-points." Recommendation: do it, looks better Decision: change approved (e) to discuss-- 3rd para "If the string argument is not found in the string-value of the location, ... the XPointer part in which the function appears fails." I'm pretty sure you don't want this. For instance, consider string-range(//title, "Thomas Pynchon") If *any* <title> element doesn't contain "Thomas Pynchon", the string argument will not be found in the string-value of that location, and so (according to the above rule) the part will fail. Recommendation: I think we discussed this already, I suggest we stick to our earlier decision Decision: Accepted, change string-range() if the string argument is not found in the string-value of the location, no range is added to the location set result. (f) to discuss"If the third or fourth argument indicates a position that is beyond the beginning or end of the document, the XPointer part in which the function appears fails." Why? This seems unnecessarily harsh to me. Consider this situation: Some on-line document has a sentence that I'd like to refer to. It begins "There comes a time" and goes on for 160 characters. So I check that that string doesn't occur elsewhere in the document, and use: xpointer(string-range(/,"There comes a time",1,160)) Later, however, the document is modified. The sentence I refer to is not changed at all, but the author adds another sentence beginning the same way. Chances are, my xpointer will now select two ranges of the document, which is tolerable. But if the author happens to start the new sentence less than 160 characters from the (new) end of the document, then (according to the rule above) the whole XPtrPart fails, and the XPointer has a sub-resource error. Instead of failing the whole XPtrPart, two gentler reactions would be: (1) "Clamp" any outside-document positions to the start or end of the document, as appropriate. (In my example situation, the xpointer would select two ranges, regardless of where the new sentence was added.) (2) Simply disregard any matches that result in outside-document positions. (In my example, the xpointer would select two or one ranges, depending on where the new sentence was added.) Recommendation: same issue as (e) do we maintain our earlier decision (g) to discussWhat happens if the third or fourth arguments indicate a position that is within the document, but outside the string-value of the location? For example, with this as the document: Recommendation: sounds clear that this will select "Pynchon", since "Element boundaries, as well as entire embedded nodes such as processing instructions and comments, are ignored" (h) to discussgeneralize "document" to "document or external parsed entity, as appropriate". Recommendation: right do it Decision: approved (i)-- 4th para "The points of the range-locations" "points" -> "start and end points" "range-locations": delete hyphen. Recommendation: Purely editorial (j)-- last para "locate ranges in elements" "elements" -> "the string-values of elements" Recommendation: Purely editorial |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a) to discuss-- 1st para "If x is a range location or a point, the x is added to the result..." But if x is a point, then you'd be adding a point to the result, and you just said that the function returns ranges. Instead, you presumably want to add the collapsed range at that point. Recommendation: sounds right Decision: approved (b) to discuss"If x is not a range location" -> "If x is a node" Recommendation: disagree "If x is a range location or a point, then ...If x is not a range location, ...." to be complete it should be "if If x is not a range location nor a point, then x is used as the container node ... Decision: simply use "otherwise" (c)"and otherwise is" Insert "it" before "is". Recommendation: Purely editorial |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a)Put "point" in "<code>...</code>"? Recommendation: Purely editorial (b)"to the result location-set" "result" -> "resulting" Recommendation: Purely editorial (c)-- first 3 bullets "the start point is" Change to "the resulting point is", for consistency with end-point()? Recommendation: Purely editorial (d) to discuss"If x is of type attribute or namespace, the XPointer part in which the function appears fails." I'm mystified: why is it so wrong to ask for the start-point (or end-point) of an attribute or namespace location? Why can't these functions treat such locations just like text, comment, and processing instruction locations? That's what range-inside does. In fact, if someone really wanted to write start-point(@foo) they could get around start-point's dislike of attribute locations just by writing start-point(range-inside(@foo)) If the latter expression isn't erroneous, why is the former? In fact, it seems to me that: start-point(range-inside(L)) = start-point(L) for all locations L would be a useful identity. (Ditto end-point.) Not that you'd have to say so explicitly; but you could, for instance, define range-inside(L) as the range from start-point(L) to end-point(L), roughly speaking. Recommendation: keep as this, this is a change in semantic, and not in order at this point, i.e. comment arrived too late Decision: keep as is we would prefer to not add complexity at this point |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a)-- 1st para "possibilties" -> "possibilities" Recommendation: Purely editorial (b)You need to say that an invocation of the here() function is only meaningful if the containing XPointer appears in a XML document (or external parsed entity?), because the rest of the section seems to just assume that it does (except for the very last sentence in the section). Recommendation: Purely editorial, move the last paragraph as the first one (c)-- 4th para "If the resource in which the XPointer appears is not XML" This phrasing assumes that the XPointer appears in a resource, which is not necessarily the case. Better to say: "If the XPointer is not located in an XML resource" Recommendation: Purely editorial, same paragraph, sounds better (d)-- 1st para "traversal of the link" There isn't really a referent for "the link". I suggest you swap the 3rd and 4th sentences, and change "from an XML document" to "from a link in an XML document". Recommendation: Purely editorial (e)-- 2nd para "a containing resource" Delete "containing". Recommendation: Purely editorial |
Source: Michael Dyck http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001JanMar/0054.html (a) to discuss5.5 Root Node Children It isn't just a change to the children that the root node can have -- it's the very fact that an external parsed entity even *has* a data model. Recommendation: old issue, closed, keep as is Decision: keep as is (b) to discussA References A.1 Normative References -- IETF RFC 2376 Change to 3023. Recommendation: do it, we already decided on this XP111 Decision: do it, we already decided on this XP111 (c) to discussA.2 Non-Normative References -- IETF I-D XMT Change to RFC 3023, move to Normative. Recommendation: do it, we already decided on this XP110 Decision: do it, we already decided on this XP110 |
[XB1] Do intra-document hrefs participate in xml:base?Source: IG - http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Jan/0058.html Summary: Does anything in XBase need to be changed to reflect that relative URI references consisting only of a fragment identifier do NOT consider the base URI when they are resolved Possible decisions:
4/ No, everything is fine as is. |
[XB2] XBase" abbreviation is confusingSource: Steve Hodgkiss, http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0051.html Summary: The term "XBase" previously referred to dBase, FoxPro, Clipper, et. al. as in the "XBase World" or "XBase Community". Unique terminology would be welcomed. Possible decisions:
Resolution: 2/ agreed ! All occurences of "XBase" will be replaced with "XML Base" |
[XB3] XBase: unsetting the base URISource: Richard Tobin, http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMar/0051.html Summary: Can the base URI infoset property be explicitly set to unknown by specifying xml:base=""? It seems that this or some such syntax is needed to allow serialisation of an infoset that contains elements with unknown URI nested inside elements with a known URI. (Presumably such an infoset would have to be created by hand.) Possible decisions:
Resolution: 2/ this is not a good idea, considered withdrawn |
[XB4] I18N: scoped attribute supportSource: Martin Duerst, http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Mar/0020.html Summary: The XML Base spec defines an attribute xml:base that works in a nested/inherited way. This is similar to xml:lang. Support for such attributes in W3C technologies, e.g. in XSLT or XML Schemas, is currently scarse if not inexistent. The I18N WG/IG hopes that both groups can use their contacts to make the relevant W3C WGs aware of the need for such support. Possible decisions:
Resolution with clarification by P.Grosso: Closed without action, check XB7 resolution |
[XB5] I18N: reference character modelSource: Martin Duerst, http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Mar/0020.html Summary: For URIs, RFC 2396 (URIs) is referenced directly, without taking the provisions of http://www.w3.org/TR/charmod/#URIsinto account. This should be corrected. Possible decisions:
Resolution: basically 2/ grab XPointer and XLink snippet about the character model and incorporate it into XML Base |
[XB6] I18N: scoping into external entitiesSource: Martin Duerst, http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Mar/0020.html Summary: There is some text in Section 3 saying 'Note that the scope of xml:base does not extend into external entities. This is in keeping with xml:space.' The I18N WG/IG is worried that this may create an unnecessary difference to how xml:lang is handled. However, we are not sure we fully understand the issue. We therefore ask you to provide an example that shows the difference between not extending into external entities and extending into external entities, so that we can check this issue further. Possible decisions:
Resolution: The scoping wording is unclear, it need to be clarified. The Working Group examined the problem of scoping withing external entities and decided to keep the current status-quo, i.e. not have base to scope within external entities. |
[XB7] XML Base like xml:space/xml:langSource: XML Core WG discussions, Summary: The last paragraph of section 3 Note that the scope of xml:base does not extend into external entities. This is in keeping with xml:space. and the last sentence of the second paragraph of section 2 http://www.w3.org/TR/2000/WD-xmlbase-20000221#AEN1_4_2_2 reads: This enables scoping behavior consistent with the xml:lang and xml:space attributes. References to the behavior of xml:lang and xml:space are potentially confusing and at best unnecessary and cause potential cross-dependencies that needn't be there and should be deleted. Possible decisions:
Resolution with clarification by P.Grosso: 1/ remove both sentences |
[XB8] XML Base scopeSource: XML Core WG discussions Summary: Whereas the last paragraph of section 3 http://www.w3.org/TR/2000/WD-xmlbase-20000221#AEN1_4_2_3
says that the scope of xml:base does not extend into external
entities, and the second paragraph of section 2 http://www.w3.org/TR/2000/WD-xmlbase-20000221#AEN1_4_2_2
starts: Possible decisions:
Resolution: As in XB6, the editors are instructed to clarify the wording. |
[XB9] XML Base is in conflict with RFC 2396Source: MURATA Makoto http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000AprJun/0011.html Summary: I think that XBase should prohibit default values for xml:base. At present, a default value for the xml:base is allowed to appear in an external DTD subset or external parameter entitiy. Then, that default value would control all XML document entities that reference to this external DTD subset or external parameter entity. (BTW, as we are painfully aware, non-validating processors are allowed to ignore them!) I think this is a violation of RFC 2396. It only allows a base URI for a MIME entity to be embedded in this very MIME entity, but does not allow embedding in different MIME entities. RFC 2396 says: 5.1.1. Base URI within Document Content Within certain document media types, the base URI of the document can be embedded within the content itself such that it can be readily obtained by a parser. This can be useful for descriptive documents, such as tables of content, which may be transmitted to others through protocols other than their usual retrieval context (e.g., E-Mail or USENET news). Possible decisions:
Resolution: 1/ but directing the editor to borrow wording from the namespace spec about warning about having such declarations in the external subset. the DOC should include a modified version of Steve's analysis. |
[XB10] describe XML Base for comments ?Source: Jonathan Marsh during Core telcon Summary: should we describe XML Base for comments ? I noticed (in looking at Infoset issues in the Core WG telcon) that XML Base does not specify the base for URI References appearing in comments. Do we want to do anything about this? pro) Yes. For consistency, we should describe the base for URI References everywhere they could appear in an XML document, and this includes comments. con) No. The content of a comment is not interpretable as anything but text, and cannot be recognized as a URI Reference. XML Base therefore does not apply. Mentioning it would only encourage people to put processable information inside comments which is abusive. Possible decisions:
Resolution: 1/ status quo. |
[XB11] allowing non-absolute xml:base attribute valuesSource: James Clark http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Aug/0007.html Summary: should we allow relative URI in XML Base values Allowing the value of xml:base to be relative seems like an unnecessary complication to be. In HTML 4.0, a base URI specified by the BASE element is required to be absolute (http://www.w3.org/TR/html401/struct/links.html#edef-BASE). The Content-Base MIME header defined in RFC 2110 also requires an absolute URI. Possible decisions:
Resolution: 1/ keep as is, XML Base doesn't do an exactly equivalent job as HTML BASE |
[XB12] Ambiguity in XML BaseSource: James Clark http://lists.w3.org/Archives/Member/w3c-xml-linking-ig/2000Sep/0005.html Summary: it is unclear whether one should first check for entity boundary or the parent Base XML Base states: The base URI for a URI reference appearing in the content of a processing instruction is the base URI of the parent element of the processing instruction, if one exists, otherwise the base URI of the document entity or external entity containing the processing instruction. James read this to mean that you check for parent elements first (crossing external entity boundaries if necessary) and only if no parent exists do you look for the containing entity. This is not what we intended. Here is a clarifying phrase. The base URI for a URI reference appearing in the content of a processing instruction is the base URI of the parent element of the processing instruction, if one exists [+[within the document or external entity]], otherwise the base URI of the document entity or external entity containing the processing instruction. This clarification also is appropriate when describing xml:base attribute treatment: The base URI for a URI reference appearing in an xml:base attribute is the base URI of the parent element of the element bearing the xml:base attribute, if one exists [+[within the document or external entity]], otherwise the base URI of the document entity or external entity containing the element. Possible decisions:
Resolution: 2/ Change as recommended. |