All Classes

Introduction

This document lists changes made to the Braces Matching SPI.

Index of APIs

Uncategorized changes

Incompatible changes by date

Fuller descriptions of all changes can be found below (follow links).

Not all deprecations are listed here, assuming that the deprecated APIs continue to essentially work. For a full deprecation list, please consult the Javadoc.

(Aug 27 '08) Document locking changed
(Nov 3 '07) Added MatcherContext.isTastCanceled()
(Nov 1 '07) Marking the SPI as under development

All changes by date

(May 6 '13) Semantic context can be provided for a brace
(Aug 27 '08) Document locking changed
(Nov 3 '07) Added MatcherContext.isTastCanceled()
(Nov 1 '07) Marking the SPI as under development
(Jun 18 '07) Additional highlights from BracesMatcher.findOrigin
(May 17 '07) Braces Matching SPI created

Changes by version

These API specification versions may be used to indicate that a module requires a certain API feature in order to function. For example, if you see here a feature you need which is labelled 1.20, your manifest should contain in its main attributes the line:

OpenIDE-Module-Module-Dependencies: org.netbeans.modules.editor.bracesmatching/0 > 1.20

(1.30) Semantic context can be provided for a brace
(1.6) Document locking changed
(1.3) Added MatcherContext.isTastCanceled()
(1.2) Marking the SPI as under development
(1.1) Additional highlights from BracesMatcher.findOrigin
(1.0) Braces Matching SPI created

Changes by affected class

`org.netbeans.spi.editor.bracesmatching.BraceContext`

(May 6 '13) Semantic context can be provided for a brace

`org.netbeans.spi.editor.bracesmatching.BracesMatcher`

(May 6 '13) Semantic context can be provided for a brace

Details of all changes by API and date

Uncategorized changes

Semantic context can be provided for a brace

May 6 '13; API spec. version: 1.30; affected top-level classes: BracesMatcher BraceContext; made by: sdedic; issues: #217730
The brace tooltip may need to display additional text, if for example if-condition spans multiple lines, or for an else-branch, where the important information (if-condition text) is located elsewhere. BraceMatcher can implement the optional mixin BraceMatcher.ContextLocator and provide boundaries for this additional text.

Document locking changed

Aug 27 '08; API spec. version: 1.6; made by: vstejskal; issues: #131284

The infrastructure does not lock the document prior calling the BracesMatcher methods. This change was done in order to support BracesMatcher implementations that need parser results and have to lock the parser first.

From now on it's up to BracesMatcher implementations to readlock the document when directly searching through it for the origin or matching areas.

Added MatcherContext.isTastCanceled()

Nov 3 '07; API spec. version: 1.3; made by: vstejskal; issues: #114651

The concept of using Thread.currentThread().interrupt() for canceling braces matching tasks is flawed. The call breaks synchronization of other parts ofthe system that are used from the braces matching tasks, which results in InterruptedExceptions throw from various random places and possibly in corruption of internal data.

We introduced MatcherContext.isTaskCanceled() method for determinig if a braces matching task was caceled.