ISSUE-5: Wording for the Treatment of Unexpanded Entity References and Entity Replacement Markup

Unexpanded Entities

Wording for the Treatment of Unexpanded Entity References and Entity Replacement Markup

State:
CLOSED
Product:
HISTORICAL: Element Traversal [features subsumed by DOM spec]
Raised by:
Doug Schepers
Opened on:
2008-06-17
Description:
In <http://lists.w3.org/Archives/Public/public-webapi/2007Mar/0065.html>, Björn said, "you have to define how the method behave in case of unexpanded entity references and entity replacement markup."

In response, the spec was changed to say, "For the purpose of ElementTraversal, an entity reference node which represents an element must be treated as an element node."

Anne remarked that that passage wasn't clear, in <http://lists.w3.org/Archives/Public/public-webapi/2008Feb/0185.html>, saying "Does this mean that an EntityReference node also implements this interface? I suggest dropping this sentence or stating that this interface assumes that all entities are normalized away or something."

Doug defended the passage, saying "I'm reluctant to mandate how a UA implements the solution, whether by implementing this interface on the entity reference node or only on the expanded resulting DOM, because I don't know how every UA does so. I don't think it effects interoperability, so I prefer to leave it as is." in <http://lists.w3.org/Archives/Public/public-webapi/2008Feb/0187.html>.

This response did not satisfy Anne (see <http://lists.w3.org/Archives/Public/public-webapi/2008Feb/0188.html>), while Doug replied (in <>), "I'm not sure how I can make it more clear without imposing undue restrictions on UAs." Anne questioned how that might be tested, in <http://lists.w3.org/Archives/Public/public-webapi/2008Feb/0190.html>.

Simon Pieters suggests wording similar to HTML5, in <http://lists.w3.org/Archives/Public/public-webapi/2008Feb/0191.html>.

The open question is whether this would constrain UAs to behave a particular way regarding entities, which might conflict with existing UAs. If no evidence is presented to the contrary, the spec might be changed in that way.

Note that this is an issue for any interface specification, so a uniform solution should be decided.
Related Actions Items:
No related actions
Related emails:
  1. Re: Background sync & push messaging: declarative vs imperative (from johnme@google.com on 2014-01-02)
  2. Re: Background sync & push messaging: declarative vs imperative (from mattgaunt@google.com on 2013-12-20)
  3. Re: Background sync & push messaging: declarative vs imperative (from mattgaunt@google.com on 2013-12-20)
  4. Re: Background sync & push messaging: declarative vs imperative (from mjs@apple.com on 2013-12-19)
  5. Background sync & push messaging: declarative vs imperative (from johnme@google.com on 2013-12-19)
  6. Re: ISSUE-5 (Unexpanded Entities): Wording for the Treatment of Unexpanded Entity References and Entity Replacement Markup [Element Traversal] (from schepers@w3.org on 2008-07-30)
  7. Re: ISSUE-5 (Unexpanded Entities): Wording for the Treatment of Unexpanded Entity References and Entity Replacement Markup [Element Traversal] (from schepers@w3.org on 2008-07-29)
  8. Re: ISSUE-5 (Unexpanded Entities): Wording for the Treatment of Unexpanded Entity References and Entity Replacement Markup [Element Traversal] (from annevk@opera.com on 2008-06-22)
  9. Re: ISSUE-5 (Unexpanded Entities): Wording for the Treatment of Unexpanded Entity References and Entity Replacement Markup [Element Traversal] (from derhoermi@gmx.net on 2008-06-22)
  10. Re: ISSUE-5 (Unexpanded Entities): Wording for the Treatment of Unexpanded Entity References and Entity Replacement Markup [Element Traversal] (from annevk@opera.com on 2008-06-17)
  11. ISSUE-5 (Unexpanded Entities): Wording for the Treatment of Unexpanded Entity References and Entity Replacement Markup [Element Traversal] (from sysbot+tracker@w3.org on 2008-06-17)

Related notes:

The spec has been updated to say, "For the purpose of Element Traversal, the implementation must handle entity reference nodes as if each entity reference has been fully expanded."

Doug Schepers, 23 Jul 2008, 23:04:00

Display change log ATOM feed


Chair, Staff Contact
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <w3t-sys@w3.org>.
$Id: 5.html,v 1.1 2016/01/25 10:26:21 carine Exp $