Skip to content
Yuriy Brun edited this page Jul 23, 2015 · 3 revisions

This document lists workarounds for some common problems with Quick Fix Scout.

Shadow ("DO_NOT_DELETE_") Projects in Open Type Dialog #_

Problem

The Open Type Dialog (OTD) is cluttered with shadow project information. As an example, when you search for type MyType, you get the following results:

MyType in My Project
MyType in DO_NOT_DELETE_Speculation_My Project
MyType in DO_NOT_DELETE_Observation_My Project

Workaround

Note: If you are already using working sets (WS) in Eclipse you can skip to step #3.

  1. Create a WS called QFS and add all shadow projects into this WS (Note: If you are using the final version of the plug-in, this should be already done, so you can skip it. Checking plug-in version.) * Down arrow ⇒ Top Level Elements ⇒ Working Sets * Down arrow ⇒ Configure Working Sets * New
    • Name: QFS
    • Select all projects that start with name DO_NOT_DELETE into this WS
  2. Create another WS for your other projects * Down arrow ⇒ Top Level Elements ⇒ Working Sets * Down arrow ⇒ Configure Working Sets * New
    • Name:
    • Select all projects that do not start with name DO_NOT_DELETE into this WS
  3. Configure OTD so that it won't show results from shadow projects. * Open OTD (ctrl + shift + T) * Down Arrow ⇒ Select Working Set... * Select all WSs except QFS

In the above instructions, Down Arrow is in the red box in this image:

Eclipse Package Explorer

Shadow ("DO_NOT_DELETE_") Projects in Navigator View #_

Problem

The Navigator View is cluttered with shadow project information. As an example, you might see projects with names:

DO_NOT_DELETE_Observation_...
DO_NOT_DELETE_Speculation_...

Workaround

Note: If you are already using working sets (WS) in Eclipse you can skip to step #3.

  1. Create a WS called QFS and add all shadow projects into this WS (Note: If you are using the final version of the plug-in, this should be already done, so you can skip it. Checking plug-in version.) * Down arrow ⇒ Top Level Elements ⇒ Working Sets * Down arrow ⇒ Configure Working Sets * New
    • Name: QFS
    • Select all projects that start with name DO_NOT_DELETE into this WS
  2. Create another WS for your other projects * Down arrow ⇒ Top Level Elements ⇒ Working Sets * Down arrow ⇒ Configure Working Sets * New
    • Name:
    • Select all projects that do not start with name DO_NOT_DELETE into this WS
  3. Configure Navigator View so that it won't show results from shadow projects. * Down Arrow ⇒ Select Working Set... * Select all WSs except QFS

In the above instructions, Down Arrow is in the red box in this image:

EclipsePackage Explorer

Shadow ("DO_NOT_DELETE_") Projects in Problems View #_

Problem

The Problems View is cluttered with shadow project information. As an example, you might see some problems with the following path information:

/DO_NOT_DELETE_Observation_...
/DO_NOT_DELETE_Speculation_...

Workaround

  1. Configure Problems View so that it will show results for only the selected project. Since shadow projects are never visible and selected, this should fix the issue. * Down Arrow ⇒ Show ⇒ Errors/Warning on Project * Make sure that it is the only selected configuration.

In the above instructions, Down Arrow is in the red box in this image:

EclipsePackage Explorer

Quick Fix Dialog does not have QFS additions

Problem

QFS does not augment the Quick Fix Dialog. The Quick Fix Dialog does not give a parenthesized prediction of compilation errors, nor are the proposals sorted and colored.

Possible Solution

There can be three general reasons why you are not seeing updated information on the Quick Fix Dialog.

  1. The speculative analysis in the background is still running and haven't computed the results yet.
  2. The speculative analysis crashed due to an internal Eclipse error that I haven't handled yet.
  3. The speculative analysis has missed this round (this was a previous concurrency bug, I don't know if this still happens).

You need to first determine whether the speculative analysis is running in the background or not. To do so:

  1. Make a change in one of your files and don't save it yourself.
  2. You should see a star to the right of the file name (this indicates that the file is dirty).
  3. Invoke quick fix somewhere in the project (if your project does not have compilation errors, you can still invoke quick fix by using the right click menu or keyboard shortcut, ctrl+1).
  4. If the speculative analysis is running, it should save that file and you should not see the star at the top right anymore.

After the check, if you know that the speculative analysis is running, give it some more time (depends on project size and computer speed, but should not be more than a minute). If the speculative analysis not running anymore (your file is not auto-saved) or if you haven't received updated information even after a minute, please send me a bug report. The plug-in should behave correctly after you close and reopen Eclipse.

No preference pages for Observer or Evaluator

Problem

You followed every step exactly as mentioned in the installation guidelines and you are using the correct version of Eclipse, however QFS plug-in still does not load (i.e., you don't see preference pages for Observer and Evaluator).

Possible Solution: Close Eclipse and reopen it

If you deactivated (or activated) a plug-in and it is still working (or has not started working), please close your Eclipse and reopen it.

Possible Solution: Run Eclipse with -clean Option

Sometimes Eclipse loads plug-ins from its plug-in cache and especially if you have recently updated QFS (and some of the internal plug-ins changed), Eclipse might not understand this directly. Therefore, a clean start-up of Eclipse might fix most of these problems.

To start-up Eclipse in clean mode (i.e., delete all plug-in cache and load all plug-ins from scratch), invoke Eclipse with clean option. e.g., in Windows invoke (from command line):

eclipse.exe -clean

Possible Solution: Fresh Eclipse Installation

Unzip a new copy of Eclipse and make a fresh installation.

If none of above solved your problem, please submit a bug report.

Reporting Bugs

Quick Fix Scout (QFS) plug-in has the following limitations at the moment. If you have a problem that is not listed here, please submit a bug report. Thanks!

Limitations

Problems listed under this category applies to both features (evaluator and observer)

  1. Hovering your mouse over the red squiggly does not produce a quick fix menu with the augmented compilation information nor log any usage data. The other three ways to create a quick fix dialog: * Click on the quick fix icon on the left * While the cursor is on the red squiggly, invoke the keyboard shortcut (cmd-1 for Mac, ctrl-1 for Windows) * While the cursor is on the red squiggly, right click and select quick fix from the menu.
  2. The plug-in works only with Java Projects and under Eclipse Classic 3.7.0 or 3.7.1. If you are running another version, you won’t be able to use the plug-in (though it should not hinder your normal Eclipse experience).