<change id="BreakpointsGrouping">

        <api name="DebuggerCoreAPI"/>

        <summary>Breakpoints group properties.</summary>

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

        <date day="28" month="1" year="2010"/>

        <author login="mentlicher"/>

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

        <description>

             <p>

             Add Breakpoint.getGroupProperties() method, that returns an implementation

             of GroupProperties class with the relevant grouping information

             used by BreakpointsWindow to create hierarchy of breakpoint groups

             </p>

        </description>

        <class package="org.netbeans.api.debugger" name="Breakpoint" />

        <issue number="179759"/>

    </change>

                    <code-name-base>org.netbeans.modules.projectapi</code-name-base>

                    <build-prerequisite/>

                    <compile-dependency/>

                    <run-dependency>

                        <release-version>1</release-version>

                        <specification-version>1.28</specification-version>

                    </run-dependency>

                </dependency>

                <dependency>

import org.netbeans.api.project.Project;

import org.openide.filesystems.FileObject;

    /** Property name for other group properties of the breakpoint. 

     * @since 1.23 */

    public static final String          PROP_GROUP_PROPERTIES = "groupProperties"; // NOI18N

    /**

     * Set the name of a user-created group for this breakpoint.

     */

    }

    /**

     * Get group properties of the breakpoint.

     * These are implementation-defined group properties as oposed to {@link #getGroupName()},

     * which returns user-defined group name.

     * <p>

     * These properties are used by the Breakpoint Window to show a tree

     * hierarchy of groups and associated breakpoints.

     * Implementation should fire {@link #PROP_GROUP_PROPERTIES} event when

     * the group properties change.

     * @return {@link GroupProperties} or <code>null</code> when no group properties

     * are defined.

     * @since 1.23

     */

    public GroupProperties getGroupProperties() {

        return null;

    /**

     * Group properties of breakpoint.

     * These are used by the Breakpoint Window to show a tree hierarchy of

     * groups and associated breakpoints.

     * @since 1.23

     */

    public static abstract class GroupProperties {

        /**

         * Get the language of the source file with the breakpoint.

         * @return The human-readable language of the breakpoint source file or <code>null</code>

         * when this does not apply.

         * @see <code>org.netbeans.spi.debugger.ui.BreakpointType.getCategoryDisplayName()</code>

         */

        public abstract String getLanguage();

        /**

         * Get the breakpoint type.

         * @return The human-readable type of the breakpoint or <code>null</code>

         * when this does not apply.

         * @see <code>org.netbeans.spi.debugger.ui.BreakpointType.getTypeDisplayName()</code>

         */

        public abstract String getType();

        /**

         * Get the source files containing this breakpoint.

         * @return The source files where this breakpoint is submitted or <code>null</code>

         * when this does not apply.

         */

        public abstract FileObject[] getFiles();

        /**

         * Get the projects containing this breakpoint.

         * @return The projects in which this breakpoint is submitted or <code>null</code>

         * when this does not apply.

         */

        public abstract Project[] getProjects();

        /**

         * Get the debugger engines that are currently actively using this breakpoint.

         * @return The engines in which this breakpoint is active or <code>null</code>

         * when this does not apply.

         */

        public abstract DebuggerEngine[] getEngines();

        /**

         * Test is this breakpoint is hidden (not visible to the user).

         * @return <code>true</code> when this breakpoint is hidden, <code>false</code> otherwise.

         */

        public abstract boolean isHidden();

    }