<change id="brace.context">

            <summary>Semantic context can be provided for a brace</summary>

            <version major="1" minor="30"/>

            <date day="6" month="5" year="2013"/>

            <author login="sdedic"/>

            <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible"/>

            <description>

                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.

            </description>

            <class package="org.netbeans.spi.editor.bracesmatching" name="BracesMatcher"/>

            <class package="org.netbeans.spi.editor.bracesmatching" name="BraceContext"/>

            <issue number="217730"/>

        </change>

import javax.swing.text.Position;

    /**

     * Mixin interface, which provides context ranges for brace matches.

     * The interface is expected to be implemented on the {@link BracesMatcher} instances

     * produced by {@link BracesMatcherFactory}. If implemented, the infrastructure may

     * call the method to obtain additional context for display along with brace highlight. 

     * See the {@link BraceContext} for more information.

     */

    public interface ContextLocator {

        /**

         * Obtains context for the given text position. At this moment, only start offset

         * of the origin will be passed in, but the implementation should be prepared to

         * handle (or ignore) each of the starting offsets reported by {@link #findOrigin()} or 

         * {@link #findMatches()}.

         * 

         * @param originOrMatchPosition position of 'origin' or 'match' brace

         * @return context information or {@code null} if the context cannot be provided.

         */

        public BraceContext findContext(int originOrMatchPosition);

    }