The TITLE pragma can be used to define additional text to be included in the default header generated for the listing.
#pragma TITLE text
text | Any string that is enclosed within quotes and consists of printable |
If the text to be added exceeds the maximum line length defined with the -N output or LINE-SIZE=... options, it is split into multiple lines of appropriate length.
The text in the TITLE pragma appears only as of the second page in the header of the listing and overwrites any text defined with the INITIAL-TITLE-TEXT option. The first page of the listing contains either a blank line or the text defined with the INITIAL-TITLE-TEXT option.
The defined text remains in effect until the next TITLE or PAGE pragma or until the end of the file.
Invalid characters (e.g. control characters) also result in a warning and are replaced by blanks.
If the generation of multiple additional text lines in the header of a listing makes theminimum prescribed number of 11 lines per page (see the options -N output and LINES-PER-PAGE) insufficient for the output of at least one line of source text in addition to the header and footer, the listing generator issues a warning and selects a correspondingly higher number of lines.