© 2013 Programming Research Ltd
Notes:
If you create and save a new personality, you must select it in order to apply it to the current folder
parameters.
Ctrl-F is an alternative way of displaying the Folder Parameters dialog.
Making File Selections
Visually, the project is portrayed by a hierarchy of folders on the left, and, based on selection within this listing,
the list of constituent files on the right.
All selections in the Browse and Reports menu items operate according to the current selection of files. The
basis of selection is as follows:
a) if a single file or a group of files is selected, these form the selection;
b) otherwise the current selected folder, plus all its sub-folders, form the selection. This means all
constituent files in these folders are included.
From within the metrics, structure and relationship browsers, it is possible to alter this starting selection of files,
using File > Select Files...
Relative Path and Environment Variable Support
QA·C supports the use of relative paths and environment variables in project files and associated personality
files. This path reduction operation involves the following principles:
• Relative paths are applied from the location of the project file, termed the Root Path.
• Relative paths and environment variables cannot be mixed in a single entry.
• The default and preferred means of applying path reduction is during the save operation on a project.
• When applying path reduction, preference is given to relative paths over environment variables.
• Application of path reduction can extend to associated personalities. An “associated” personality refers to
a personality configured as part of the project and located within the directory branch defined by the
project file location (such that it is subject to relative path reduction).
• In all analysis and display processes, any path reductions in projects are converted to their fully-qualified
paths. This means that there is no dependence on relative paths or environment variables in these
external processes through configuration files such as settings.via and filelist.lst.
Note:
In order to optimize your use of relative paths, locate the project file at the root of project components,
including the source tree, project headers, project personality files, and analysis output locations.
Root Path
The key variable for application of relative paths is the location of the project file. This Root Path is
displayed on the main GUI window in a toolbar entry. When a project is opened, it is automatically set to
display the project file location. It will change only if the project file is saved to a different location.
When editing personalities, any use of relative path entries will be resolved using the Root Path, so that
browse and edit operations will work correctly.
Note:
Although it is possible to apply relative path entries manually to the existing (saved) projects, it is
recommended to apply relative paths and environment variables only through a project-saving