## Options Tab

The Options tab in the Project Configuration dialog (which you open with Project->Configure) provides a variety of analysis options, including information about the source code, how to handle errors found during parsing, and the compiler.

The Options tab contains the following fields:

- Prompt for Missing Includes
  By default, for any include files that cannot be found during analysis, you will be prompted as to how to handle that missing include file. When prompted during analysis, you may choose to ignore the missing file, or you may specify the path where the file can be found. Turn this option off to disable this prompting feature. Any missing include files found during analysis when the prompt feature is turned off will be ignored.
- Record Local Object Declarations
  By default, all local object declarations are included in the database. If you wish to exclude variables declared within functions from the database, turn this option off.
  Local objects included for analysis can then be either included or excluded from the HTML output generated. Specify whether to include local objects in the HTML output on the main window of Understand for C++.
- Record References During Intermediate Macro Expansion
  Checking this box causes references to be stored during macro expansion. In some cases this is useful. Be aware that enabling this option can add a lot of references and make the database large and slower. The default is off.
- Record Parameter References
  If you wish to exclude cross reference information for parameters, turn this option off. By default, this option is on and all cross reference information for parameters is included.
- Include Cache
  By default, include files are cached during the analysis phase as they are often referenced in multiple source files. This speeds up analysis, but also uses more memory. If you have problems with excessive memory use during analysis, turn this option off.
- Add Found Include Files to Source List
  Enabling this option causes include files found during project analysis to be added to the project. This allows you to see more detailed information about such include files.
- Allow Nested Comments
  By default, this is off. If turned on it permits C style (/* */) comments to be nested. This isn’t permitted by the ANSI standard, but some compilers do permit it.
- Associate Comments
  You can choose which source code comments should be associated with an entity. Your choice depends on how you typically comment entity declarations. The choices are “never” (comments are not associated with entities), “comments before definitions,” “comments after definitions” (the default), and “longest comment before or definition.”
- Compiler
  Select the compiler/platform that you use. This will set up compiler specific macros for use by the Understand for C++ parser.

Note: Not all features of a particular compiler will necessarily be handled.

- Compiler Include Paths
  Type the path the compiler uses to find include files. For example, %include%.

Scientific Toolworks, Inc. http://www.scitools.com