From f4d5c00424eff7c84b4152b4df4de5c0ba4b12bc Mon Sep 17 00:00:00 2001
From: Ferdinand Oeinck <unknown>
Date: Tue, 4 Oct 2022 09:35:06 +1100
Subject: Feature [feature-requests:#1453] Added
 SCI_STYLESETINVISIBLEREPRESENTATION to make it easier to edit around
 invisible text. This also allows representing long lexemes with a single
 character to provide a summarized view.

---
 doc/ScintillaDoc.html     | 11 +++++++++++
 doc/ScintillaHistory.html |  6 ++++++
 2 files changed, 17 insertions(+)

(limited to 'doc')

diff --git a/doc/ScintillaDoc.html b/doc/ScintillaDoc.html
index a9a7e72ed..fb5d59dfd 100644
--- a/doc/ScintillaDoc.html
+++ b/doc/ScintillaDoc.html
@@ -3248,6 +3248,8 @@ struct Sci_TextToFindFull {
      <a class="message" href="#SCI_STYLESETCHECKMONOSPACED">SCI_STYLESETCHECKMONOSPACED(int style, bool
     checkMonospaced)</a><br />
     <a class="message" href="#SCI_STYLEGETCHECKMONOSPACED">SCI_STYLEGETCHECKMONOSPACED(int style) &rarr; bool</a><br />
+    <a class="message" href="#SCI_STYLESETINVISIBLEREPRESENTATION">SCI_STYLESETINVISIBLEREPRESENTATION(int style, const char *representation)</a><br />
+    <a class="message" href="#SCI_STYLEGETINVISIBLEREPRESENTATION">SCI_STYLEGETINVISIBLEREPRESENTATION(int style, char *representation NUL-terminated) &rarr; int</a><br />
     <a class="message" href="#SCI_SETFONTLOCALE">SCI_SETFONTLOCALE(&lt;unused&gt;, const char *localeName)</a><br />
     <a class="message" href="#SCI_GETFONTLOCALE">SCI_GETFONTLOCALE(&lt;unused&gt;, char *localeName) &rarr; int</a><br />
     </code>
@@ -3514,6 +3516,15 @@ struct Sci_TextToFindFull {
     Applications may apply the 'check monospaced' attribute just to fonts known to be monospaced or on all fonts, leaving it to Scintilla to
     reject fonts that are proportional.</p>
 
+    <p><b id="SCI_STYLESETINVISIBLEREPRESENTATION">SCI_STYLESETINVISIBLEREPRESENTATION(int style, const char *representation)</b><br />
+    <b id="SCI_STYLEGETINVISIBLEREPRESENTATION">SCI_STYLEGETINVISIBLEREPRESENTATION(int style, char *representation NUL-terminated) &rarr; int</b><br />
+     When a style is made invisible with <a class="seealso" href="#SCI_STYLESETVISIBLE">SCI_STYLESETVISIBLE</a>, text is difficult to edit as
+     the cursor can be at both sides of the invisible text segment. With these messages invisible text segements can be made visible with a single
+     UTF8 characater giving the user an indication if the cursor is left or right of the invisible text. The character is displayed using the current style.</p>
+
+    <p>The <code>representation</code> parameter is a zero terminated string holding the one character used to represent the invisible text segment. Only the first character
+    is used, the character is decoded as UTF-8.</p>
+
     <p><b id="SCI_SETFONTLOCALE">SCI_SETFONTLOCALE(&lt;unused&gt;, const char *localeName)</b><br />
     <b id="SCI_GETFONTLOCALE">SCI_GETFONTLOCALE(&lt;unused&gt;, char *localeName NUL-terminated) &rarr; int</b><br />
      These messages set the locale used for font selection with language-dependent glyphs.
diff --git a/doc/ScintillaHistory.html b/doc/ScintillaHistory.html
index abbf4f4ef..cac690226 100644
--- a/doc/ScintillaHistory.html
+++ b/doc/ScintillaHistory.html
@@ -573,6 +573,7 @@
 	<td>Jacky Yang</td>
       </tr><tr>
 	<td>Reinhard Nißl</td>
+	<td>Ferdinand Oeinck</td>
     </tr>
     </table>
     <h2>Releases</h2>
@@ -584,6 +585,11 @@
 	Released 27 August 2022.
 	</li>
 	<li>
+	Added SCI_STYLESETINVISIBLEREPRESENTATION to make it easier to edit around invisible text.
+	This also allows representing long lexemes with a single character to provide a summarized view.
+	<a href="https://sourceforge.net/p/scintilla/feature-requests/1453/">Feature #1453</a>.
+	</li>
+	<li>
 	Removed NotifyLexerChanged notification from DocWatcher.
 	This is a private interface but could be used by independent platform layers
 	and was exposed by ScintillaDocument in the Qt implementation of ScintillaEdit.
-- 
cgit v1.2.3