From a3dd1952c420158febe7a11d596ba3f402eb17ab Mon Sep 17 00:00:00 2001
From: Neil <nyamatongwe@gmail.com>
Date: Sun, 5 Nov 2023 14:59:49 +1100
Subject: Add SCI_CHANGESELECTIONMODE to simplify selection mode manipulation.

---
 doc/ScintillaDoc.html     | 15 +++++++++------
 doc/ScintillaHistory.html |  3 ++-
 2 files changed, 11 insertions(+), 7 deletions(-)

(limited to 'doc')

diff --git a/doc/ScintillaDoc.html b/doc/ScintillaDoc.html
index 43407a40b..dcabdd9ee 100644
--- a/doc/ScintillaDoc.html
+++ b/doc/ScintillaDoc.html
@@ -979,6 +979,7 @@ struct Sci_TextRangeFull {
      <a class="message" href="#SCI_GETCURLINE">SCI_GETCURLINE(position length, char *text) &rarr; position</a><br />
      <a class="message" href="#SCI_SELECTIONISRECTANGLE">SCI_SELECTIONISRECTANGLE &rarr; bool</a><br />
      <a class="message" href="#SCI_SETSELECTIONMODE">SCI_SETSELECTIONMODE(int selectionMode)</a><br />
+     <a class="message" href="#SCI_CHANGESELECTIONMODE">SCI_CHANGESELECTIONMODE(int selectionMode)</a><br />
      <a class="message" href="#SCI_GETSELECTIONMODE">SCI_GETSELECTIONMODE &rarr; int</a><br />
      <a class="message" href="#SCI_SETMOVEEXTENDSSELECTION">SCI_SETMOVEEXTENDSSELECTION(bool moveExtendsSelection)</a><br />
      <a class="message" href="#SCI_GETMOVEEXTENDSSELECTION">SCI_GETMOVEEXTENDSSELECTION &rarr; bool</a><br />
@@ -1122,17 +1123,19 @@ struct Sci_TextRangeFull {
     <p><b id="SCI_SELECTIONISRECTANGLE">SCI_SELECTIONISRECTANGLE &rarr; bool</b><br />
      This returns 1 if the current selection is in rectangle mode, 0 if not.</p>
 
-    <p><b id="SCI_SETSELECTIONMODE">SCI_SETSELECTIONMODE(int selectionMode)</b><br />
+    <p>
+    <b id="SCI_SETSELECTIONMODE">SCI_SETSELECTIONMODE(int selectionMode)</b><br />
+    <b id="SCI_CHANGESELECTIONMODE">SCI_CHANGESELECTIONMODE(int selectionMode)</b><br />
     <b id="SCI_GETSELECTIONMODE">SCI_GETSELECTIONMODE &rarr; int</b><br />
-    The two functions set and get the selection mode, which can be
+    The functions set, change, and get the selection mode, which can be
      stream (<code>SC_SEL_STREAM</code>=0) or
      rectangular (<code>SC_SEL_RECTANGLE</code>=1) or
      by lines (<code>SC_SEL_LINES</code>=2)
      or thin rectangular (<code>SC_SEL_THIN</code>=3).
-     When set in these modes, regular caret moves will extend or reduce the selection,
-     until the mode is cancelled by a call with same value or with <code>SCI_CANCEL</code>.
-     The get function returns the current mode even if the selection was made by mouse
-     or with regular extended moves.
+     When <code>SCI_SETSELECTIONMODE</code> sets these modes, regular caret moves will extend or reduce the selection,
+     until the mode is cancelled by a call with same value, or with <code>SCI_CANCEL</code>, or with <code>SCI_SETMOVEEXTENDSSELECTION</code>.
+     <code>SCI_CHANGESELECTIONMODE</code> sets the mode but does not make regular caret moves extend or reduce the selection.</p>
+     <p>The get function returns the current mode even if the selection was made by mouse or with regular extended moves.
      <code>SC_SEL_THIN</code> is the mode after a rectangular selection has been typed into and ensures
      that no characters are selected.</p>
 
diff --git a/doc/ScintillaHistory.html b/doc/ScintillaHistory.html
index f823ee0ef..b808bd4b8 100644
--- a/doc/ScintillaHistory.html
+++ b/doc/ScintillaHistory.html
@@ -591,7 +591,8 @@
 	Released 18 November 2023.
 	</li>
 	<li>
-	Add SCI_SETMOVEEXTENDSSELECTION to simplify selection mode manipulation.
+	Add SCI_SETMOVEEXTENDSSELECTION and SCI_CHANGESELECTIONMODE to
+	simplify selection mode manipulation.
 	</li>
 	<li>
 	Improve performance of global replace by reducing cache invalidation overhead.
-- 
cgit v1.2.3