Updated September 2008

PAGE <command line>

The PAGE command can be used as a prefix to any other (non-screen-oriented) command to cause its output to be displayed one page at a time instead of scrolling. It stops after each screen-full of output and waits for any key to proceed. For example:

PAGE DUMP FILE.TXT

This will dump the contents of the file a page at a time. General paging may also be toggled by using PAGE /ON and PAGE /OFF.

This command can be very useful when dealing with commands that send lots of information to the screen very quickly, such as TYPE, DIR, DUMP, and COMPIL.

You can terminate the command by entering Q when prompted to proceed to the next page.

See Also

•   A-Shell's Scrollback feature, which is supported in A-Shell/Windows and ATE.

History

2016 January, A-Shell 6.2.1422, PAGE.LIT 1.0(104):  PAGE.LIT now sets a flag allowing other LIT and RUN programs to detect if they are running under control of PAGE. This is mainly for the benefit of ERASE, which see—the History notes—for more information.

2008 September, A-Shell build 1125:  Adds support for syntax display (PAGE /?), and also checks and adjusts for common mistake of using PAGE <file> to display a file, instead of PAGE TYPE <file>. In other words, if the argument list consists of a single filespec, and that filespec appears to be a text file, it is treated as if the command was PAGE TYPE <file>.