Trace Components

Identifier:
org.eclipse.ui.trace.traceComponents

Since:
1.0

Description:
This extension point allows plug-ins to contribute debug trace options to the Tracing preference page (Preferences > General > Tracing). All of the option-paths from a set of plug-in .options files will be editable from the preference page. As the options will be dynamically enabled or disabled via the OSGi DebugOptions service, the specified plug-ins' tracing must listen for changes (see org.eclipse.osgi.service.debug.DebugOptions).

Configuration Markup:

<!ELEMENT extension (component+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT component (bundle*)>

<!ATTLIST component

id    CDATA #REQUIRED

label CDATA #IMPLIED>

A tracing component



<!ELEMENT bundle EMPTY>

<!ATTLIST bundle

name     CDATA #IMPLIED

consumed (true | false) >

An Eclipse bundle.



Examples:
The following is an example for the extension point where a component called 'Equinox Framework' includes all of the option-paths from the .options file in the org.eclipse.osgi bundle. As well, a second component called 'JDT Core' includes all of the option-paths from the .options files found in any bundle matching org.eclipse.jdt.*core*. The tracing preference page would display these two categories in the tree with all known option-paths as children.


   <extension
         point="org.eclipse.ui.trace.traceComponent">
      <component
            id="org.eclipse.ui.trace.osgitrace"
            label="Equinox Framework">
         <bundle
               name="org.eclipse.osgi">
         </bundle>
      </component>
   </extension>
   <extension
         point="org.eclipse.ui.trace.traceComponent">
      <component
            id="org.eclipse.ui.trace.jdtcoretrace"
            label="JDT Core">
         <bundle
               name="org.eclipse.jdt.*core*">
         </bundle>
      </component>
   </extension>


Copyright (c) 2011, 2014 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