From 27e74c10b31767a637a4e3281c93dadc3280d640 Mon Sep 17 00:00:00 2001
From: Neil <nyamatongwe@gmail.com>
Date: Wed, 12 Feb 2025 14:08:55 +1100
Subject: Document SC_TECHNOLOGY_DIRECT_WRITE_1 and reformat technology choice
 as a table.

---
 doc/ScintillaDoc.html | 59 ++++++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 49 insertions(+), 10 deletions(-)

diff --git a/doc/ScintillaDoc.html b/doc/ScintillaDoc.html
index dda900b7c..e36c2059d 100644
--- a/doc/ScintillaDoc.html
+++ b/doc/ScintillaDoc.html
@@ -130,7 +130,7 @@
 
     <h1>Scintilla Documentation</h1>
 
-    <p>Last edited 1 February 2025 NH</p>
+    <p>Last edited 12 February 2025 NH</p>
 
     <p style="background:#90F0C0">Scintilla 5 has moved the lexers from Scintilla into a new
     <a href="Lexilla.html">Lexilla</a> project.<br />
@@ -5065,16 +5065,55 @@ struct Sci_TextToFindFull {
      <b id="SCI_GETTECHNOLOGY">SCI_GETTECHNOLOGY &rarr; int</b><br />
     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),
-    <code>SC_TECHNOLOGY_DIRECTWRITERETAIN</code> (2), or
-    <code>SC_TECHNOLOGY_DIRECTWRITEDC</code> (3)
-    can be chosen to use the Direct2D and DirectWrite APIs for higher quality antialiased drawing.
-    <code>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.
-    <code>SC_TECHNOLOGY_DIRECTWRITEDC</code> differs from
-    <code>SC_TECHNOLOGY_DIRECTWRITE</code> by using DirectWrite to draw into a GDI DC.
+    On Windows 7 or later, <code>SC_TECHNOLOGY_DIRECTWRITE</code> (1) performs higher quality antialiased drawing.
+    The other choices in the following table are similar to <code>SC_TECHNOLOGY_DIRECTWRITE</code>
+    but may work or be more efficient in some situations where <code>SC_TECHNOLOGY_DIRECTWRITE</code> fails or is slow.
     </p>
+    <table class="standard" summary="Technology choice">
+      <tbody valign="top">
+        <tr>
+          <th align="left"><code>SC_TECHNOLOGY_DEFAULT</code></th>
+
+          <td>0</td>
+
+          <td>Use older GDI API which is compatible with all versions of Windows including Windows Vista and XP.</td>
+        </tr>
+
+        <tr>
+          <th align="left"><code>SC_TECHNOLOGY_DIRECTWRITE</code></th>
+
+          <td>1</td>
+
+          <td>Use the Direct2D and DirectWrite APIs for higher quality antialiased drawing.</td>
+        </tr>
+
+        <tr>
+          <th align="left"><code>SC_TECHNOLOGY_DIRECTWRITERETAIN</code></th>
+
+          <td>2</td>
+
+          <td>Request that the frame is retained after being presented which may prevent drawing failures on some cards and drivers.</td>
+        </tr>
+
+        <tr>
+          <th align="left"><code>SC_TECHNOLOGY_DIRECTWRITEDC</code></th>
+
+          <td>3</td>
+
+          <td>Use DirectWrite to draw into a GDI DC. This mode may work for remote access sessions.</td>
+        </tr>
+
+        <tr>
+          <th align="left"><code>SC_TECHNOLOGY_DIRECT_WRITE_1</code></th>
+
+          <td>4</td>
+
+          <td>Use DirectWrite in a lower level way that manages graphics state more explicitly.</td>
+        </tr>
+
+      </tbody>
+    </table>
+
     <p>
     On Win32, buffered drawing is set to a reasonable value for the technology: on for GDI and off for Direct2D
     as Direct2D performs its own buffering.
-- 
cgit v1.2.3