Listing Pragmas

The listing facility provides a number of pragmas to control various features of the listing format. The available pragmas are described below.

#pragma LINES linenum

Sets the number of lines per page to linenum. Default is 63. Minimum number is 20 lines.

#pragma WIDTH pagewidth

Sets the width of the page to pagewidth. Default is 80 columns. Minimum number is 50 columns.

	NOTE: If the WIDTH pragma is being used, put it before any TITLE or SUBTITLE pragmas, since the title and subtitle field widths vary with the page width.

#pragma TITLE "string"

Sets the page title to string. string is truncated without warning to 44 characters less than the page width. Default is the empty string.

#pragma SUBTITLE "string"

Sets the page subtitle to string. string is truncated without warning to 44 characters less than the page width. Default is the empty string.

	NOTE: The TITLE and SUBTITLE pragmas do not take effect until the second page, because the banner on the first page appears before the pragmas.

#pragma PAGE

Causes a page break and the start of a new page.

#pragma AUTOPAGE { ON }

#pragma AUTOPAGE { OFF }

Causes a page break after each function definition. Default is OFF.

#pragma LIST { ON }

#pragma LIST { OFF }

Turns the listing ON/OFF. The default is ON. Use this pragma as a toggle to turn listing off around any source lines that you do not want to be listed, such as include files.