From fff4fd06d77e66010dba3ba604b2c714a02f5a19 Mon Sep 17 00:00:00 2001 From: Neil Date: Wed, 5 Feb 2014 10:28:21 +1100 Subject: The Unicode line ends and substyles features added as provisional in 3.2.5 are now finalised. --- doc/ScintillaDoc.html | 23 ++++++----------------- 1 file changed, 6 insertions(+), 17 deletions(-) (limited to 'doc/ScintillaDoc.html') diff --git a/doc/ScintillaDoc.html b/doc/ScintillaDoc.html index 306df840a..ab8f4064f 100644 --- a/doc/ScintillaDoc.html +++ b/doc/ScintillaDoc.html @@ -2256,8 +2256,8 @@ struct Sci_TextToFind {

Line endings

-

Scintilla can handle the major line end conventions and, depending on settings and - the current lexer also support additional Unicode line ends.

+

Scintilla can handle the major line end conventions and, depending on settings and + the current lexer also support additional Unicode line ends.

Scintilla can interpret any of the Macintosh (\r), Unix (\n) and Windows (\r\n) line ends. @@ -2267,12 +2267,10 @@ struct Sci_TextToFind { entire document to one of these line endings with SCI_CONVERTEOLS. Finally, you can choose to display the line endings with SCI_SETVIEWEOL.

-

For the UTF-8 encoding, three additional Unicode line ends, Next Line (NEL=U+0085), Line Separator (LS=U+2028), and Paragraph Separator (PS=U+2029) may optionally be interpreted when Unicode line ends is turned on and the current lexer also supports Unicode line ends.

-
SCI_SETEOLMODE(int eolMode)
SCI_GETEOLMODE
@@ -2280,12 +2278,10 @@ struct Sci_TextToFind { SCI_SETVIEWEOL(bool visible)
SCI_GETVIEWEOL
-
SCI_GETLINEENDTYPESSUPPORTED
SCI_SETLINEENDTYPESALLOWED(int lineEndBitSet)
SCI_GETLINEENDTYPESALLOWED
SCI_GETLINEENDTYPESACTIVE
-

SCI_SETEOLMODE(int eolMode)
SCI_GETEOLMODE
@@ -2307,9 +2303,6 @@ struct Sci_TextToFind { (CR), (LF), or (CR)(LF). SCI_GETVIEWEOL returns the current state.

-
- These features are provisional
-

SCI_GETLINEENDTYPESSUPPORTED
SCI_GETLINEENDTYPESSUPPORTED reports the different types of line ends supported by the current lexer. This is a bit set although there is currently only a single choice @@ -2326,7 +2319,6 @@ struct Sci_TextToFind {

SCI_GETLINEENDTYPESACTIVE
SCI_GETLINEENDTYPESACTIVE reports the set of line ends currently interpreted by Scintilla. It is SCI_GETLINEENDTYPESSUPPORTED & SCI_GETLINEENDTYPESALLOWED.

-

Styling

@@ -5963,7 +5955,6 @@ sptr_t CallScintilla(unsigned int iMessage, uptr_t wParam, sptr_t lParam){ *keyWordList)
SCI_GETSTYLEBITSNEEDED
-
SCI_GETSUBSTYLEBASES(<unused>, char *styles)
SCI_DISTANCETOSECONDARYSTYLES
SCI_ALLOCATESUBSTYLES(int styleBase, int numberStyles)
@@ -5973,7 +5964,6 @@ sptr_t CallScintilla(unsigned int iMessage, uptr_t wParam, sptr_t lParam){ SCI_GETSTYLEFROMSUBSTYLE(int subStyle)
SCI_GETPRIMARYSTYLEFROMSTYLE(int style)
SCI_SETIDENTIFIERS(int style, const char *identifiers)
-

SCI_SETLEXER(int lexer)
SCI_GETLEXER
@@ -6118,9 +6108,7 @@ sptr_t CallScintilla(unsigned int iMessage, uptr_t wParam, sptr_t lParam){ to SCI_SETSTYLEBITS.

-

Substyles

- These features are provisional

Lexers may support several different sublanguages and each sublanguage may want to style some number of sets of identifiers (or similar lexemes such as documentation keywords) uniquely. Preallocating a large number for each purpose would exhaust the number of allowed styles quickly. @@ -6154,7 +6142,6 @@ sptr_t CallScintilla(unsigned int iMessage, uptr_t wParam, sptr_t lParam){

SCI_SETIDENTIFIERS(int style, const char *identifiers)
Similar to SCI_SETKEYWORDS but for substyles. The prefix feature available with SCI_SETKEYWORDS is not implemented for SCI_SETIDENTIFIERS.

-

Lexer Objects

@@ -6270,9 +6257,9 @@ needs to be folded as this allowed fixing up the last line from the previous fol The new approach allows the lexer to decide whether to backtrack or to handle this more efficiently.

-

ILexerWithSubStyles

+

ILexerWithSubStyles

-

+

To allow lexers to report which line ends they support, and to support substyles, Ilexer is extended to ILexerWithSubStyles.

@@ -7397,6 +7384,8 @@ for line = lineStart to lineEnd do SCI_ENSUREVISIBLE(line) next

Provisional features are displayed in this document with a distinctive background colour.

+

There are currently no provisional features.

+

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 SCI_DISABLE_PROVISIONAL defined.

-- cgit v1.2.3