Text and HTML Reports |
Understand for Ada generates a variety of analysis and quality reports. The reports fall into these categories:
· Cross Reference reports show much the same information as the References section in the Info Browswer, except that all entities are shown together in alphabetic order. Cross Reference reports include the Data Dictionary, Program Unit, Object, Type, Exception, and Unused Objects, Unused Types, Unused Program Units, and Withs Not Needed.Understand for Ada reports are generated either as Text or as HTML files. On Windows 95/NT the ASCII text follows the DOS text file format (carriage return and line feed at the end of each line). On Unix and VMS text files are created according to the Unix convention with lines ending with just a carriage return.
When HTML reports are generated they are stored in the HTML 3.0 format. The generated HTML is not complex, the only HTML 3.0 (versus earlier versions) feature used is Frames. The Netscape browser version 2.0 and higher, and Internet Explorer 3.0 and higher are able to browse the files.
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 one or two characters 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. A .pcn file is also created as in index to every program unit, listing it's parameters and file/line declaration.
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 "repada". Refer to Generating Reports for details on using "repada".
Scientific Toolworks, Inc. http://www.scitools.com Voice: (802) 763-2995 Fax: (802) 763-3066 support@scitools.com sales@scitools.com |