Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "PTP/ETFw/PTP External Tools Framework Feedback View"

< PTP
(Show Items in feedback view)
(Show Items in feedback view)
Line 17: Line 17:
  
 
# Create a basic C project (or almost any type of Eclipse project will do)  
 
# Create a basic C project (or almost any type of Eclipse project will do)  
# Put the xml file in the project (e.g. use data/sample.xml in the above project)  
+
# Put the xml file in the project (e.g. use data/sample.xml from  the sample project)  
 
# Put source files referenced in the xml file(s) in the same directory (e.g. use data/sample.c from the above project) as the xml file, unless you put specific code in your plug-in to find them.  
 
# Put source files referenced in the xml file(s) in the same directory (e.g. use data/sample.c from the above project) as the xml file, unless you put specific code in your plug-in to find them.  
 
# Select the xml file in the Project Explorer view.  Hit the ETFw Feedback view button in the toolbar (Hover says "Show Feedback View for selected XML File")  
 
# Select the xml file in the Project Explorer view.  Hit the ETFw Feedback view button in the toolbar (Hover says "Show Feedback View for selected XML File")  

Revision as of 11:51, 4 January 2010

The Parallel Tools Platform External Tools Framework Feedback view provides an eclipse view, exposing information found e.g. in an XML file, with convenient mapping and navigation to source lines referenced in the XML file. For example, a compiler or analysis tool may expose items of interest in an XML file and list the filename and line number (or range of lines, or character region) applicable to the item found. A performance tool may note regions of interest with source code lines that are referenced.

The PTP ETFw Feedback view allows a convenient way to expose this information in a way that allows the user to easily navigate to the source code lines in the user's source code.

Show Items in feedback view

Note that the ETFw Feedback view code that is part of PTP Release 3.0 does not include a concrete view that shows ETFw Feedback view capabilities. It is a framework that makes constructing this easier. However, an example is provided to show some of the features that are available.

As an example, check out the org.eclipse.ptp.etfw.feedback.sample project from CVS:

  • Host: dev.eclipse.org
  • Repository path: /cvsroot/tools
  • Under HEAD, scroll down to org.eclipse.ptp and expand it.
  • Expand tools/etfw
  • Check out org.eclipse.ptp.etfw.feedback.sample

Launch a development eclipse workspace with the etfw.feedback project and the etfw.feedback.sample project. Then:

  1. Create a basic C project (or almost any type of Eclipse project will do)
  2. Put the xml file in the project (e.g. use data/sample.xml from the sample project)
  3. Put source files referenced in the xml file(s) in the same directory (e.g. use data/sample.c from the above project) as the xml file, unless you put specific code in your plug-in to find them.
  4. Select the xml file in the Project Explorer view. Hit the ETFw Feedback view button in the toolbar (Hover says "Show Feedback View for selected XML File")
  5. The xml file is parsed by the SampleFeedbackParser class, IFeedbackItems are created, and markers are created for each of these, which appear in the Feedback view.
    • The items are initially all collapsed. You can expand individual parent nodes, or use the "Expand All" button in the view's toolbar (see red arrow in middle of image above\) to see more information.
  6. To see the source file line referred to by an item, double-click on the line in the Feedback view.
  7. To see more information on an item, rightMouse and select "Show Info", or select the item and hit the "Show Info" (icon "i") button in the view toolbar.
FeedbackSample.png

Back to the top