/sys$common/syshlp/helplib.hlb FORTRAN, /DESIGN, COMMENTS *Conan The Librarian (sorry for the slow response - running on an old VAX) |
Controls whether the compiler analyzes the text of each comment (either a full-line or end-of-line comment) for program design information. Comment text is scanned for tags that are defined in the current DEC Language Sensitive Editor environment file. Certain tags are predefined by LSE; however, you can add, change, or remove tags as desired. See the DEC Language Sensitive Editor documentation for details. If you also specify the /ANALYSIS_DATA qualifier, the SCA analysis data file includes information about tags found, text of tagged and untagged comments, and their locations in the source file. You can then use SCA and LSE commands to retrieve the design information. At compile time, the compiler reports any errors detected by comment analysis routines. If LSE and SCA are not installed or if a severe error is reported by the comment analysis routines, the compilation is aborted. Groups of full-line comments are identified by the compiler as "comment blocks", including lines that consist of whitespace followed by a "!" comment introducer. Differences in indentation of full-line comments are ignored for the purposes of grouping comments into blocks. A comment block ends when a completely blank line or a line which is not a full-line comment is detected. End-of-line comments, where non-blank text is followed by a "!" comment introducer, are treated as self-contained comment blocks. Comments from source that is included with the INCLUDE or DICTIONARY statements are also analyzed for design information. The end of an INCLUDE module or DICTIONARY definition, by itself, does not end a comment block. Comments beginning with a "D" or "d" in column 1 are not examined for program design information.
|