From a3b4cd70c2a6fdb039d22ffc34c582c6c223817e Mon Sep 17 00:00:00 2001 From: Neil Date: Wed, 23 May 2018 19:27:11 +1000 Subject: Update for bidirectional support. --- doc/ScintillaDoc.html | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) (limited to 'doc/ScintillaDoc.html') 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 @@

Scintilla Documentation

-

Last edited 17 April 2018 NH

+

Last edited 23 May 2018 NH

There is an overview of the internal design of Scintilla.
@@ -157,9 +157,10 @@

Scintilla also builds with Cocoa on OS X and with Qt, and follows the conventions of those platforms.

-

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.

+

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.

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.

- These bidirectional features are not yet implemented and the API is provisional
+ These bidirectional features are experimental and incomplete.

SCI_SETBIDIRECTIONAL(int bidirectional)
SCI_GETBIDIRECTIONAL → int
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 SC_BIDIRECTIONAL_L2R mode. Some features, such as virtual space may not work with + bidirectional text or may work only in some circumstances.

+

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 SCI_SETBIDIRECTIONAL(SC_BIDIRECTIONAL_L2R) (1) which chooses left to right as the default direction or SCI_SETBIDIRECTIONAL(SC_BIDIRECTIONAL_R2L) (2) for default right to left. -- cgit v1.2.3