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.

See also Before
you begin.
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:

C Analysis Preferences
This page allows to configure Logiscope C parsing options.

- 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.

- 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.

- 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.

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.

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.
Licensed Materials – Property of Kalimetrix
(c) Copyright Kalimetrix. All Rights Reserved.