DepDegree - Getting Started

Installation Instructions:

   1. Install 'JRE' (Java Runtime Environment) 1.6 or higher.
         http://java.sun.com/
   2. Install eclipse 3.4.1 or higher.
         http://www.eclipse.org/
   3. Download the DepDegree plug-in (jar) file and copy it 
      into the "plugins" folder of your eclipse installation.
   4. Run Eclipse, and find the "Show View" item within the
      "Window" menu in the main menu bar.
   5. Select "Other..." option from the "Show View" menu choices.
   6. Select "Source Analyzer View" under the "DepDegree Category" 
      and press ok.
   7. The "Source Analyzer" view appears in the IDE. Resize it so that all 
      controls become visible.

Using DepDegree (Source Analyzer View)

1. Open your desired java source file in the main editor of eclipse, and 
   make sure the editor is selected and is showing the file.

2. Press the 'Calculate' button. Some assignment statements in the source code
   are now highlighted with a red background. These statements are
   assignments (e.g. i = j + 1; or i++; or i+=j;), method calls, or return
   statements that return an expression.
   
   Note: Usually a small part of the statement is highlighted (e.g., the 
   assignment operator). If the whole statement was to be highlighted, then 
   the sub-statements within that statement could not be marked.
   For example, the statement 'i *= 2 + j++' consists of two assignments, i.e. 
   the binary assignment (*=) and the unary assignment (++). 
   If the whole statement was highlighted, then the  
   original complexity of 'j++' could not be illustrated. Instead, only the 
   operator '*=' is highlighted, and 'j++' is highlighted separately.
   
3. Tick the 'Interactive' check box to get details about specific statements
   in the source code. Make sure that you have pressed the 'Calculate' button on 
   the source code prior to using this feature, otherwise you would probably 
   receive an error message, or nothing happens.
   
   After ticking the check box, set the cursor over an assignment operator, 
   method name or a return keyword. You could alternatively select the area
   around the explained region. The statement would be highlighted in green, 
   and all the related assignments are highlighted with the cyan color. Also,
   the complexity value of the statement and additional information about it would 
   appear in the 'Indicator Value Monitor' text field.
   
Trouble Shootout:

- Some statements are not highlighted when I press the calculate button.

A. Please check that the complexity value of the statement is at least one. 
   otherwise, the statement would be highlighted with a 'white' background.
   Also, if the statement is not of the types mentioned above (assignment,
   return statement, method invocation) it will not be highlighted, because 
   it will not have an indicator value.
   If non of the above conditions solved the problem, it might be a bug - please report.