aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc/ScintillaDoc.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ScintillaDoc.html')
-rw-r--r--doc/ScintillaDoc.html19
1 files changed, 11 insertions, 8 deletions
diff --git a/doc/ScintillaDoc.html b/doc/ScintillaDoc.html
index 1aa57ef70..202a0f5b1 100644
--- a/doc/ScintillaDoc.html
+++ b/doc/ScintillaDoc.html
@@ -119,7 +119,7 @@
<h1>Scintilla Documentation</h1>
- <p>Last edited 17 April 2018 NH</p>
+ <p>Last edited 23 May 2018 NH</p>
<p>There is <a class="jump" href="Design.html">an overview of the internal design of
Scintilla</a>.<br />
@@ -157,9 +157,10 @@
<p>Scintilla also builds with Cocoa on OS X and with Qt, and follows the conventions of
those platforms.</p>
- <p>Scintilla does not properly support right-to-left languages like Arabic and Hebrew.
- While text in these languages may appear correct, it is not possible to interact with this text
- as is normal with other editing components.</p>
+ <p>Scintilla provides only limited experimental support on Windows for right-to-left languages
+ like Arabic and Hebrew.
+ While text in these languages may appear correct, interaction with this text may not work
+ correctly as occurs with other editors.</p>
<p>This documentation describes the individual messages and notifications used by Scintilla. It
does not describe how to link them together to form a useful editor. For now, the best way to
@@ -3723,15 +3724,17 @@ struct Sci_TextToFind {
Scintilla may ignore this call in some cases. For example, the inline behaviour might only be supported for some languages.</p>
<div class="provisional">
- <a href="#ProvisionalMessages">These bidirectional features are not yet implemented and the API is provisional</a><br />
+ <a href="#ProvisionalMessages">These bidirectional features are experimental and incomplete.</a><br />
<p><b id="SCI_SETBIDIRECTIONAL">SCI_SETBIDIRECTIONAL(int bidirectional)</b><br />
<b id="SCI_GETBIDIRECTIONAL">SCI_GETBIDIRECTIONAL &rarr; int</b><br />
Some languages, like Arabic and Hebrew, are written from right to left instead of from left to right as English is.
Documents that use multiple languages may contain both directions and this is termed "bidirectional".
The default text direction may be right to left or left to right.
- Scintilla only correctly displays bidirectional text on some platforms and there can be additional processing and storage
- costs to this.
- Currently, bidirectional text only works on Win32 using DirectWrite.
+ Scintilla only correctly displays bidirectional text on some platforms.
+ Currently, there is experimental support for bidirectional text only on Win32 using DirectWrite for UTF-8 documents
+ in <code>SC_BIDIRECTIONAL_L2R</code> mode. Some features, such as virtual space may not work with
+ bidirectional text or may work only in some circumstances.</p>
+ <p>There are additional processing and storage costs to bidirectional text.
As some applications may not want to pay the costs, bidirectional support must be explicitly enabled by calling
<code>SCI_SETBIDIRECTIONAL(SC_BIDIRECTIONAL_L2R)</code> (1) which chooses left to right as the default direction or
<code>SCI_SETBIDIRECTIONAL(SC_BIDIRECTIONAL_R2L)</code> (2) for default right to left.