Preferences - Properties

This section describes Logiscope workbench preferences and project properties for the Logiscope Eclipse Plug-in.
If you have not already done what is described in Before you begin, it is time to do it.

Logiscope Preferences Pages

Depending on installed languages (JDT and/or CDT) in your Eclipse installation, Logiscope Preferences pages for Java, C and C++ will be made available or not.
If Logiscope is correctly configured, opening the Preferences dialog Window > Preferences... will show the following:

Logiscope General Preferences

This page is used to configure the Logiscope installation to be used by the Eclipse Plug-in.
Only Logiscope version starting at 2012.1 supports the Kalimetrix Logiscope Plug-in for Eclipse.

Logiscope Preference Page

Logiscope RuleChecker Preferences

This page is used to configure the general behaviour of Logiscope RuleChecker within Eclipse.

Allow relaxation mechanism: This option activates the Logiscope rule violation relaxation mechanism. When set, the user can relax violations using the Eclispe Quick Fix mechanism.
Use frames in html reports: When this option is set, the RuleChecker html reports are generated using frames to facilitate navigation within the document.
Add linked files to the project: This option allows the Logiscope Plug-in to add linked files into the Eclipse project to facilitate access to the Logiscope RuleChecker project and report.
Here is an example of both linked files created:

Logiscope RuleChecker C / C++ / Java Preferences

Depending on the programming language for which the Logiscope Plug-in has to be configured, open the C, C++ or Java page.
Each page contains 3 tabs as shown below:

Language page

C Analysis Preferences

This page allows to configure Logiscope C parsing options.

C Analysis page

Logiscope directory name: the name of a directory where Logiscope store all project internal data. The given name will be created as a sub directory of the project root directory.
If the name starts with a dot (.), the directory is hidden inside Eclipse project.
Logiscope C Dialect: the Logiscope dialect which corresponds to the specifics (e.g. predefined macros and standard include paths) of the C preprocessor and compiler (e.g. gcc) of the Eclipse project. A dialect corresponds to predefined Logiscope Definition file and Ignore file where these specifics are defined. If needed, you can provide your own Logiscope C parser Definition and/or Ignore files (see below).
Definitions and Includes: Logiscope has a mechanism to automatically find the predefined macros and include paths from the Eclipse settings. However, in some cases, the information may not be accurate enough. If you notice warning and problems when analysis your project, you may need to add here appropriate -D and -I compiler options.
Definition file: For each Logiscope C dialect, a default Definition file is automatically used by Logiscope when parsing the source files. In case of you would need to use your own Definition file, set the path in this pane.
Ignore file: For some Logiscope C dialect, a default Ignore file is automatically used by Logiscope when parsing the source files. The Ignore file allows to specify syntaxes of pieces of code you want to ignore when parsing the source files.
In case you would require to use your own Ignore file, set its path in this pane.

For more details on Logiscope C parsing options, please refer to Logiscope C Audit & RuleChecker Reference Manual

C++ Analysis Preferences

This page allows to configure Logiscope C++ parsing options.

C++ Analysis page

Logiscope directory name: the name of a directory where Logiscope store all project internal data. The given name will be created as a sub directory of the project root directory.
If the name starts with a dot (.), the directory is hidden inside Eclipse project.
Logiscope C++ Dialect: the Logiscope dialect which corresponds to the specifics (e.g. predefined macros) of the C++ compiler of the Eclipse project. A dialect corresponds to predefined Logiscope parsing configuration file where these specifics are defined. If needed, you can provide your own Logiscope C++ parser configuration files using the Browse ... button.
Macro definitions:.Logiscope has a mechanism to automatically find the predefined macros from the Eclipse settings. However, in some cases, the information may not be accurate enough. If you notice warning and problems when analysis your project, you may need to add appropriate -D and -U compiler options in this pane.

For more details on Logiscope C++ parsing options, refer to Logiscope C++ Audit & RuleChecker Reference Manual

Java Analysis Preferences

This page is used to configure how Logiscope Java analyzer will behave.

Java analysis page

Logiscope directory name: the name of a directory where Logiscope store all project internal data. The given name will be created as a sub directory of the project root directory.
If the name starts with a dot (.), the directory is hidden inside Eclipse project.

Rule Set Preferences

This page is used to configure which rule set(s) will be checked during Logiscope analysis. The list of available rule sets depends on the language.

Rule set page

By default, whatever the language is, the selected rule set is the Eclipse one. You can easily add any other rule sets by selecting them and pressing the Add button. In the opposite, you can remove rule sets by selecting them and pressing the Remove button. Once rule sets to use have been chosen, rules can be added or removed by using the Rules Preferences tab.

Rules Preferences

This page is used to configure which programming rules are checked during Logiscope analysis. The list of available rules depends on the language.

Rules page

Rule states are by default set according to the chosen rules sets.
Possible values for a rule state are:

Ignore: the rule will not be checked.
Warning: the violations found for this rule will be reported as Warning in the Problems view .
Error: the violations found for this rule will be reported as Error in the problems view .

Clicking on the small arrow in front of the rule name opens a text describing the rule.

Logiscope Project Properties

The Logiscope Properties pages can be accessed from the menu Project > Properties if the selected Eclipse project is written in a supported language.

Use project specific settings : If not set, preferences set for the project language at workbench level are used. If set, you can choose project specific settings for Logiscope RuleChecker.