Text and HTML Reports |
Understand for C++ generates a variety of analysis and quality reports. The reports fall into these categories:
- Cross Reference reports show much the same information as the Reference section in the Info Browser, except that all entities are shown together in alphabetic order. Cross Reference reports include the Data Dictionary, Object, Type, Function, Macro, Include, and Unused entities Cross Reference Reports.Understand for C++ reports are output either to Text or HTML format files. On Windows 95/NT the ASCII follows the DOS text file format (carriage return and linefeed after each line). On Unix and VMS Unix text files are created (with a carriage return after each line).
When HTML reports are generated they are stored in HTML 3.0 format files. The generated HTML is not complex, the only HTML 3.0 (over HTML 2.0) feature used is frames.
If you have specified multiple HTML files be generated per report in the Report Configuration dialog, the top of the HTML report will show the index of the report sections by displaying the first character of the entity name in that section. These are also links to those files, so clicking on the desired index entry will take you directly to that page.
File names of reports generated vary based on the type and format of the report generated.
For text files, a single text file containing all selected reports may be generated or separate files for each type of report may be generated. A single text file is named <project_name>.txt. For separate text files, the root of the file name is <project_name> with varying suffixes added to the file name to distinguish the type of report. The following table shows the file names used for each text report.
For HTML files, a single HTML file containing all selected reports may be generated or separate files for each type of report may be generated. HTML files are further broken down into separate files, either alphabetically by entity name or in groups of N number of entities. An index file is also generated and contains links to all the other HTML reports generated. The report index file is named index.html.
The following table shows the file names used for each separate HTML and Text report.
For HTML reports only, there is a single index file containing an alphabetical list of all entities found in all other generated HTML reports. The entities listed in the index have hyper links to the Data Dictionary report for that entity. The entity index file is named entity_index.html and can be accessed from the "index" link on the main HTML page. Following is an example of the entity index.
HTML, text, and project metrics reports may be generated with the command line program "repc". Refer to Generating Reports for details on using "repc".
Scientific Toolworks, Inc. http://www.scitools.com Voice: (802) 763-2995 Fax: (802) 763-3066 support@scitools.com sales@scitools.com |