XInclude DoC + two small editorial changes

Folks,

I updated the XInclude 1.1 DoC; I believe it is now complete:

  http://www.w3.org/XML/2013/05/xinclude-11-lc-doc/Overview

In working through them, I was persuaded to make two additional
editorial changes.

In the description of fragid in Section 3.1, I added a parenthetical
reference to RFC 4288. Erik Wilde observed that it would make it
easier for readers to connect the dots:

  <p>The <att>fragid</att> attribute is a generalization of the
  <att>xpointer</att> attribute. A <att>fragid</att> may be present
  regardless of the value of the <att>parse</att> attribute. The
  interpretation of the value of the attribute depends on the value of
  <att>parse</att>. For <phrase>XML processing</phrase>, the value is
  interpreted as an XPointer (see <bibref ref="XPCore"/>); for
  <phrase>text processing</phrase>, it is interpreted as a <bibref
  ref="RFC5147"/> fragment identifier. For other values of
  <att>parse</att>, <phrase diff="add">implementations <termref
  def="dt-must">should</termref> process fragment identifiers per the
  relevant media type</phrase>
     <phrase diff="add">(i.e., media types
     registered per <bibref ref="RFC4288"/>)</phrase>,
  but the
  interpretation <phrase diff="del">is implementation-defined</phrase>
  <phrase diff="add">is not defined by this
  specification</phrase>.</p> <p>See <specref
  ref="xpointer-and-fragid"/> for more information.</p>

In Section 3.2 I made the corresponding change about unprefixed
attribute names (we made this change in 3.1 earlier but missed it in
3.2):

  <p>Attributes <termref def="dt-must">may</termref> be placed on the
  <code>xi:fallback</code> element. Unprefixed attribute names are
  reserved for future versions of this specification, and <termref
  def="dt-must">must</termref> be ignored by XInclude
    <phrase diff="chg">1.1</phrase>
  processors.</p>

                                        Be seeing you,
                                          norm

-- 
Norman Walsh
Lead Engineer
MarkLogic Corporation
Phone: +1 512 761 6676
www.marklogic.com

Received on Wednesday, 2 October 2013 13:24:01 UTC