Text and HTML Reports |
Understand for Ada's Quality Reports are designed to provide information about areas of the analyzed source that might not meet standards or that hold the potential for trouble. They also identify areas where extra programming has been done but not needed. This sometimes identifies areas that aren't yet complete, or that haven't been maintained completely.
The Program Unit Complexity Report lists the Cyclomatic Complexity for each program unit that has been analyzed. Also sometimes called the McCabe Complexity, the higher this metric the more likely a program unit is to be difficult to test and maintain without error.
The Program Unit Metrics Report lists these metrics for each program unit that has been analyzed:
- lines - the total number of lines in the program unit.Note that specifications and bodies of program units are reported separate.
The Program Unit Inclusive Metrics Report sums each of the metrics provided in the Program Unit Metrics Report (above) for all program units nested in a given program unit.
The File Metrics Report provides the same information as the other metrics reports except by source file.
This report identifies any object (variable, parameter, constant) that is declared but never used.
This report identifies any type (type, subtype, derived type) that is declared but never used to declare or derive a new object or type.
This report identifies program units that are declared but never used.
Note that this listing in this report doesn't mean the system doesn't need this program unit. For instance, interrupt handlers that are called by system interrupts are often never "used" within the other source of the program.
This report lists, for each program unit, any With statements it has but doesn't need (by not using any items made public by the With statement).
Note that this covers only direct usage in the program unit and doesn't account for side effects that may be needed by the program to operate correctly. For instance, sometimes a package can be Withed just to start a task or to execute code in its begin/end block.
Project metrics can be saved to a comma delimited text file which can be used in Excel and other spreadsheet programs.
From the Project menu, select Metrics Export,->Set Options, and the following dialog appears. Specify the file name for the metrics text file and select whether column titles are to be included in the file or not.
After setting options, choose Project->Metrics Export->Generate, and the file is exported. Following is an excerpt of the comma delimited metrics file produced.
Scientific Toolworks, Inc. http://www.scitools.com Voice: (802) 763-2995 Fax: (802) 763-3066 support@scitools.com sales@scitools.com |