From 39be73514c317e7d672e0a09862571e64f8979da Mon Sep 17 00:00:00 2001
From: Zufu Liu <unknown>
Date: Thu, 15 Jul 2021 17:29:24 +1000
Subject: Feature [feature-requests:#1370] Implement SCI_ALLOCATELINES to
 allocate indices to hold some number of lines. This is an optimization that
 can decrease reallocation overhead.

---
 doc/ScintillaDoc.html     | 7 +++++++
 doc/ScintillaHistory.html | 5 +++++
 2 files changed, 12 insertions(+)

(limited to 'doc')

diff --git a/doc/ScintillaDoc.html b/doc/ScintillaDoc.html
index 50409c0af..03fe95ea9 100644
--- a/doc/ScintillaDoc.html
+++ b/doc/ScintillaDoc.html
@@ -531,6 +531,7 @@
      <a class="message" href="#SCI_GETREADONLY">SCI_GETREADONLY &rarr; bool</a><br />
      <a class="message" href="#SCI_GETTEXTRANGE">SCI_GETTEXTRANGE(&lt;unused&gt;, Sci_TextRange *tr) &rarr; position</a><br />
      <a class="message" href="#SCI_ALLOCATE">SCI_ALLOCATE(position bytes)</a><br />
+     <a class="message" href="#SCI_ALLOCATELINES">SCI_ALLOCATELINES(line lines)</a><br />
      <a class="message" href="#SCI_ADDTEXT">SCI_ADDTEXT(position length, const char *text)</a><br />
      <a class="message" href="#SCI_ADDSTYLEDTEXT">SCI_ADDSTYLEDTEXT(position length, cell *c)</a><br />
      <a class="message" href="#SCI_APPENDTEXT">SCI_APPENDTEXT(position length, const char *text)</a><br />
@@ -645,6 +646,12 @@
      Allocate a document buffer large enough to store a given number of bytes.
      The document will not be made smaller than its current contents.</p>
 
+    <p><b id="SCI_ALLOCATELINES">SCI_ALLOCATELINES(line lines)</b><br />
+     Allocate line indices to match the <code class="parameter">lines</code> argument.
+     This is an optimization that can prevent multiple reallocations of the indices as text is inserted
+     if the application can estimate the number of lines in the document.
+     The number of lines will not be reduced by this call.</p>
+
     <p><b id="SCI_ADDTEXT">SCI_ADDTEXT(position length, const char *text)</b><br />
      This inserts the first <code class="parameter">length</code> characters from the string
      <code class="parameter">text</code>
diff --git a/doc/ScintillaHistory.html b/doc/ScintillaHistory.html
index c4cd3132c..f433322ea 100644
--- a/doc/ScintillaHistory.html
+++ b/doc/ScintillaHistory.html
@@ -580,6 +580,11 @@
 	<a href="https://sourceforge.net/p/scintilla/feature-requests/1381/">Feature #1381</a>.
 	</li>
 	<li>
+	Add SCI_ALLOCATELINES to allocate indices to hold some number of lines.
+	This can decrease reallocation overhead when the application can count or estimate the number of lines in huge files.
+	<a href="https://sourceforge.net/p/scintilla/feature-requests/1370/">Feature #1370</a>.
+	</li>
+	<li>
 	On Win32, when technology is changed, buffering is set to a reasonable value for the technology:
 	on for GDI and off for Direct2D as Direct2D performs its own buffering.
 	<a href="https://sourceforge.net/p/scintilla/feature-requests/1400/">Feature #1400</a>.
-- 
cgit v1.2.3