From 1fdd0b8dc8f2895c5942b23410f11ea21dd4e3f4 Mon Sep 17 00:00:00 2001
From: Neil <nyamatongwe@gmail.com>
Date: Thu, 10 Jun 2021 16:03:47 +1000
Subject: Use string_view for PositionCache methods. Replace custom hash code
 with standard library hash. Drop standard methods that are not needed.
 Restrict representations to 200 bytes. Improve documentation.

---
 doc/ScintillaDoc.html | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

(limited to 'doc')

diff --git a/doc/ScintillaDoc.html b/doc/ScintillaDoc.html
index 300ae0208..d972c99a7 100644
--- a/doc/ScintillaDoc.html
+++ b/doc/ScintillaDoc.html
@@ -3861,20 +3861,22 @@ struct Sci_TextToFind {
      <b id="SCI_GETREPRESENTATION">SCI_GETREPRESENTATION(const char *encodedCharacter, char *representation NUL-terminated) &rarr; int</b><br />
      <b id="SCI_CLEARREPRESENTATION">SCI_CLEARREPRESENTATION(const char *encodedCharacter)</b><br />
     Any character, including those normally displayed  as mnemonics may be represented by a
-    string inverted in a rounded rectangle.</p>
+    Unicode string inverted in a rounded rectangle.</p>
 
     <p>For example, the Ohm sign &#x2126; U+2126 looks very similar to the Greek Omega character &#x3a9; U+03C9 so,
     for the UTF-8 encoding, to distinguish the Ohm sign as "U+2126 &#x2126;" this call could be made:
     <code>SCI_SETREPRESENTATION("\xe2\x84\xa6", "U+2126 \xe2\x84\xa6")</code></p>
 
-    <p>The encodedCharacter parameter is a NUL-terminated string of the bytes for one character in the
+    <p>The <code class="parameter">encodedCharacter</code> parameter is a NUL-terminated string of the bytes for one character in the
     current encoding. This can not be used to set a representation for multiple-character strings. </p>
 
+    <p>The <code class="parameter">representation</code> parameter is a NUL-terminated UTF-8 string with a maximum length of 200 bytes.</p>
+
     <p>One exception to the single character restriction is that the two character sequence "\r\n" (Carriage Return + Line Feed)
     can have a representation that is visible in line end viewing (<a class="seealso" href="#SCI_SETVIEWEOL">SCI_SETVIEWEOL</a>) mode.
     If there is no representation for "\r\n" then the individual '\r' and '\n' representations will be seen.</p>
 
-    <p>The NUL (0) character is a special case since the encodedCharacter parameter is NUL terminated, the NUL
+    <p>The NUL (0) character is a special case since the <code class="parameter">encodedCharacter</code> parameter is NUL terminated, the NUL
     character is specified as an empty string.</p>
 
     <p><b id="SCI_CLEARALLREPRESENTATIONS">SCI_CLEARALLREPRESENTATIONS</b><br />
-- 
cgit v1.2.3