# HG changeset patch
# User Aryeh Gregor <ayg+spec@aryeh.name>
# Date 1294795143 25200
# Node ID 7963331ee0cb241fd07ae48b9b617b8a25379fde
# Parent  de818fdcdac1ff0db105241c543feb42ccb333d4
First pass at direction support for selections

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

diff --git a/source.html b/source.html
--- a/source.html
+++ b/source.html
@@ -817,16 +817,31 @@ that it has only one segment and that se
 same) then the <span title=concept-selection>selection</span>'s position
 should equal the caret position. When the
 <span title=concept-selection>selection</span> is not empty, this
 specification does not define the caret position; user agents should follow
 platform conventions in deciding whether the caret is at the start of the
 <span title=concept-selection>selection</span>, the end of the
 <span title=concept-selection>selection</span>, or somewhere else.
 
+<p>Each <span title=concept-selection>selection</span> has a <dfn
+title=concept-selection-dir>direction</dfn>, either <i>forwards</i> or
+<i>backwards</i>.  If the user creates a <span
+title=concept-selection>selection</span> by indicating first one <span
+title=concept-boundary-point>boundary point</span> of the <span
+title=concept-selection>selection</span> and then the other (such as by
+clicking on one point and dragging to another), and the <span
+title=concept-bp-position>position</span> of the first indicated <span
+title=concept-boundary-point>boundary point</span> relative to the second is
+"after", then the corresponding <span title=concept-selection>selection</span>
+should initially be backwards.  Otherwise, it should be forwards (including if
+the user didn't create the <span title=concept-selection>selection</span>,
+created it by selecting an entire part of the page using a keyboard shortcut,
+etc.).
+
 <p>On some platforms (such as those using Wordstar editing conventions), the
 caret position is totally independent of the start and end of the
 <span title=concept-selection>selection</span>, even when the
 <span title=concept-selection>selection</span> is empty. On such platforms, user
 agents may ignore the requirement that the cursor position be linked to the
 position of the <span title=concept-selection>selection</span> altogether.
 
 <p>User agents may selectively ignore attempts to use the API to adjust the
@@ -924,34 +939,50 @@ any explicitly called out below.
   <dd>
     <p>Returns the offset of the end of the selection relative to the element
     that contains the end of the selection.
     <p>Returns 0 if there's no selection.
 </dl>
 
 <div class=impl>
 <p>The <dfn title=dom-Selection-anchorNode><code>anchorNode</code></dfn>
-attribute must return the value returned by the
-<code title=dom-Range-startContainer>startContainer</code> attribute of the last
-<code>Range</code> object in the list, or null if the list is empty.
+attribute must return null if the list is empty.  Otherwise, if the <span
+title=concept-selection>selection</span>'s <span
+title=concept-selection-dir>direction</span> is forwards (respectively
+backwards), it must return the value returned by the <code
+title=dom-Range-startContainer>startContainer</code> (respectively <code
+title=dom-Range-endContainer>endContainer</code>) attribute of the last
+<code>Range</code> object in the list.
 
 <p>The <dfn title=dom-Selection-anchorOffset><code>anchorOffset</code></dfn>
-attribute must return the value returned by the
-<code title=dom-Range-startOffset>startOffset</code> attribute of the last
-<code>Range</code> object in the list, or 0 if the list is empty.
+attribute must return 0 if the list is empty.  Otherwise, if the <span
+title=concept-selection>selection</span>'s <span
+title=concept-selection-dir>direction</span> is forwards (respectively
+backwards), it must return the value returned by the <code
+title=dom-Range-startOffset>startOffset</code> (respectively <code
+title=dom-Range-endOffset>endOffset</code>) attribute of the last
+<code>Range</code> object in the list.
 
 <p>The <dfn title=dom-Selection-focusNode><code>focusNode</code></dfn>
-attribute must return the value returned by the
-<code title=dom-Range-endContainer>endContainer</code> attribute of the last
-<code>Range</code> object in the list, or null if the list is empty.
+attribute must return null if the list is empty.  Otherwise, if the <span
+title=concept-selection>selection</span>'s <span
+title=concept-selection-dir>direction</span> is forwards (respectively
+backwards), it must return the value returned by the <code
+title=dom-Range-endContainer>endContainer</code> (respectively <code
+title=dom-Range-startContainer>startContainer</code>) attribute of the last
+<code>Range</code> object in the list.
 
 <p>The <dfn title=dom-Selection-focusOffset><code>focusOffset</code></dfn>
-attribute must return the value returned by the
-<code title=dom-Range-endOffset>endOffset</code> attribute of the last
-<code>Range</code> object in the list, or 0 if the list is empty.
+attribute must return 0 if the list is empty.  Otherwise, if the <span
+title=concept-selection>selection</span>'s <span
+title=concept-selection-dir>direction</span> is forwards (respectively
+backwards), it must return the value returned by the <code
+title=dom-Range-endOffset>endOffset</code> (respectively <code
+title=dom-Range-startOffset>startOffset</code>) attribute of the last
+<code>Range</code> object in the list.
 </div>
 
 <hr>
 
 <dl class=domintro>
   <dt><var title>collapsed</var> = <var title>selection</var> . <code title=dom-Selection-isCollapsed>isCollapsed</code>()
   <dd>
     <p>Returns true if there's no selection or if the selection is empty.
@@ -1111,17 +1142,18 @@ title>range</var>)</code></dfn> method m
 
 <p>The
 <dfn title=dom-Selection-removeAllRanges><code>removeAllRanges()</code></dfn>
 method must remove all the <code>Range</code>s from the list of
 <code>Range</code>s, such that the
 <code title=dom-Selection-rangeCount>rangeCount</code> attribute returns 0 after
 the <code title=dom-Selection-removeAllRanges>removeAllRanges()</code> method is
 invoked (and until a new <code>Range</code> is added to the list, either through
-this interface or via user interaction).
+this interface or via user interaction).  The <span
+title=concept-selection-dir>direction</span> must be set to forwards.
 </div>
 
 <hr>
 
 <div class=impl>
 <p>The <dfn title=dom-Selection-stringifier>stringifier</dfn> must return the
 concatenation of the results of
 <span title=dom-Range-stringifier>stringifying</span> each of the