#
Breakpoint Organizers

###### Identifier:

org.eclipse.debug.ui.breakpointOrganizers

###### Since:

3.1

###### Description:

Breakpoint organizers categorize breakpoints based on some specific criteria. For example, a breakpoint organizer is provided to categorize breakpoints by project. Organizers with the specified name will be automatically created by the Debug Platform and presented to the user as options for grouping breakpoints. The supplied class, which must implement org.eclipse.debug.ui.IBreakpointOrganizerDelegate, will be loaded only as necessary, to avoid early plugin activation.

###### Configuration Markup:

<!ELEMENT extension (breakpointOrganizer+)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

<!ELEMENT breakpointOrganizer EMPTY>

<!ATTLIST breakpointOrganizer

id CDATA #REQUIRED

class CDATA #REQUIRED

label CDATA #REQUIRED

icon CDATA #IMPLIED

othersLabel CDATA #IMPLIED>

- id - Unique identifier for this breakpoint organizer.
- class - Implementation of `org.eclipse.debug.ui.IBreakpointOrganizerDelegate` that performs categorization
- label - Label for this organizer which is suitable for presentation to the user.
- icon - Optional path to an icon which can be shown for this organizer.
- othersLabel - Optional label for this organizer which is suitable for presentation to the user to describe breakpoints that do not fall into a category supplied by this organizer. For example, if an organizer categorizes breakpoints by working sets, but a breakpoint does not belong to a working set, this label will be used. When unspecified, "Others" is used.

###### Examples:

Following is an example of a breakpoint organizer extension.

    <extension
        point="org.eclipse.debug.ui.breakpointOrganizers">
        <breakpointOrganizer
        class="com.example.BreakpointOrganizer"
         id="com.example.BreakpointOrganizer"
         label="Example Organizer"
         icon="icons/full/obj16/example_org.gif"/>
    </extension>

In the above example, the supplied factory will be included in the list of options for grouping breakpoints ("Group By > Example Organizer"). When selected, the associated organizer will be used to categorize breakpoints.

###### API Information:

Value of the attribute class must be a fully qualified name of a Java class that implements the interface org.eclipse.debug.ui.IBreakpointOrganizerDelegate.

###### Supplied Implementation:

The Debug Platform provides breakpoint organizers for projects, files, breakpoint types, and working sets.

Copyright (c) 2005 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html