Setting a Header Text in the Main Window: TOP

Use

You can specify which lines of text that you want to always print at the top of the main window. These text lines are also known as header texts. For example, you would use header texts in the case of a very large table covering several pages of output to ensure that the table heading information were repeated at the start of each new page of output.

        
            /: TOP : : /: ENDTOP

The lines of text enclosed between the two control commands will be output from now on at the start of the main window.

An existing header text can be disabled by using the TOP .. ENDTOP command pair without enclosing any text lines between the two command lines:

        
            /: TOP /: ENDTOP

Subsequent pages will contain no header text.

Note

If the main window already contains some output then a newly specified header text takes effect on the next page only.
The same applies to the deletion of a header text. If a header text has already been output on the current page then it cannot be retracted.
Header texts should not be employed in texts that are printed from applications programs, such as reminder texts, order texts. These applications programs can also work with header texts via the form interface, which may lead to unexpected results.