From 6e372ac3287fe3db658cf95dcd1c2928683e924a Mon Sep 17 00:00:00 2001
From: Neil <nyamatongwe@gmail.com>
Date: Thu, 25 Sep 2014 09:29:04 +1000
Subject: Mentioning that SC_TECHNOLOGY_DIRECTWRITERETAIN is provisional.

---
 doc/ScintillaDoc.html     | 14 +++++++++-----
 doc/ScintillaHistory.html |  1 +
 2 files changed, 10 insertions(+), 5 deletions(-)

(limited to 'doc')

diff --git a/doc/ScintillaDoc.html b/doc/ScintillaDoc.html
index e71b39a4d..acb5910fd 100644
--- a/doc/ScintillaDoc.html
+++ b/doc/ScintillaDoc.html
@@ -82,7 +82,7 @@
 
     <h1>Scintilla Documentation</h1>
 
-    <p>Last edited 12 September 2014 NH</p>
+    <p>Last edited 25 September 2014 NH</p>
 
     <p>There is <a class="jump" href="Design.html">an overview of the internal design of
     Scintilla</a>.<br />
@@ -3243,13 +3243,15 @@ struct Sci_TextToFind {
     The technology property allows choosing between different drawing APIs and options.
     On most platforms, the only choice is <code>SC_TECHNOLOGY_DEFAULT</code> (0).
     On Windows Vista or later, <code>SC_TECHNOLOGY_DIRECTWRITE</code> (1) or
-    <code>SC_TECHNOLOGY_DIRECTWRITERETAIN</code> (2)
+    <code class="provisional">SC_TECHNOLOGY_DIRECTWRITERETAIN</code> (2)
     can be chosen to use the Direct2D and DirectWrite APIs for higher quality antialiased drawing.
-    <code>SC_TECHNOLOGY_DIRECTWRITERETAIN</code> differs from
+    <code class="provisional">SC_TECHNOLOGY_DIRECTWRITERETAIN</code> differs from
     <code>SC_TECHNOLOGY_DIRECTWRITE</code> by requesting that the frame
     is retained after being presented which may prevent drawing failures on some cards and drivers.
     Since Direct2D buffers drawing, Scintilla's buffering can be turned off with
-    <code>SCI_SETBUFFEREDDRAW(0)</code>.</p>
+    <code>SCI_SETBUFFEREDDRAW(0)</code>.
+    <span class="provisional">Since <code>SC_TECHNOLOGY_DIRECTWRITERETAIN</code>
+    is provisional, it may be changed or removed in a future release if a better solution is found.</span></p>
 
     <p><b id="SCI_SETFONTQUALITY">SCI_SETFONTQUALITY(int fontQuality)</b><br />
      <b id="SCI_GETFONTQUALITY">SCI_GETFONTQUALITY</b><br />
@@ -7427,7 +7429,9 @@ for line = lineStart to lineEnd do SCI_ENSUREVISIBLE(line) next
 
     <p>Provisional features are displayed in this document with <span class="provisional">a distinctive background colour</span>.</p>
 
-    <p>There are currently no provisional features.</p>
+    <p>There are currently no provisional messages.
+    The <code class="provisional">SC_TECHNOLOGY_DIRECTWRITERETAIN</code> value for
+    <a class="message" href="#SCI_SETTECHNOLOGY">SCI_SETTECHNOLOGY</a> is provisional.</p>
 
     <p>Some developers may want to only use features that are stable and have graduated from
     provisional status. To avoid using provisional messages compile with the symbol
diff --git a/doc/ScintillaHistory.html b/doc/ScintillaHistory.html
index bb167cc53..1d622f26c 100644
--- a/doc/ScintillaHistory.html
+++ b/doc/ScintillaHistory.html
@@ -514,6 +514,7 @@
 	<li>
 	On Windows another DirectWrite mode SC_TECHNOLOGY_DIRECTWRITERETAIN added
 	which may avoid drawing failures on some cards and drivers.
+	This feature is provisional and may be changed or removed if a better solution is found.
 	</li>
 	<li>
 	On Windows support the Visual Studio 2010+ clipboard format that indicates a line copy.
-- 
cgit v1.2.3