Description:
Displays information about the editing session. This built-in is used to
place requested information in the SHOW_ BUFFER. SHOW takes a single parameter
which can be any of those listed below. When information is being sent to the
SHOW_BUFFER, a buffer with the name "SHOW_BUFFER" must exist. If not, an error is
returned.
If a window named INFO_WINDOW is available, nu/TPU maps it to SHOW_BUFFER to
display the information. SHOW uses the following steps to display its
information:
1. Erase the SHOW_BUFFER.
2. Write SHOW information to the SHOW_BUFFER.
3. Map INFO_WINDOW to SHOW_BUFFER.
Note that when writing your own interfaces, be sure to unmap the INFO_WINDOW
when this call is completed.
The following are uses of the SHOW (WORD) form where WORD is a nu/TPU keyword.
Parameter Return
BUFFER[S] Display in SHOW_BUFFER a comprehensive listing of the contents of BUFFER_LIST.
KEY_MAP[S] Display in SHOW_BUFFER all key-map-names.
KEY_MAP_LIST[S] Display in SHOW_BUFFER all defined key-map-lists, their associated key-maps,
and the number of keys defined in each key-map-list.
KEYWORDS Display in SHOW_BUFFER all keywords known to nu/TPU.
PROCEDURES Display in SHOW_BUFFER the names of all currently defined procedures in the
nu/TPU system.
SCREEN Display in SHOW_BUFFER information regardingthe terminal currently running the
nu/TPU session.
SUMMARY Display in SHOW_BUFFER information regarding the current nu/TPU session.
VARIABLES Display in SHOW_BUFFER the names of all defined variables in the current
nu/TPU session.
WINDOW[S] Display in SHOW_BUFFER information regarding all windows currently available
to the editor.
The following are uses of SHOW when the parameter isn't a nu/TPU keyword. All
of the following uses of SHOW place information into the SHOW_BUFFER.
Parameter Return
Buffer Display in SHOW_BUFFER information about the specified buffer.
String Display in SHOW_BUFFER information about the specified string.
Window Display in SHOW_BUFFER information about the specifiedwindow.
Syntax:
SHOW ( { KEYWORD | buffer | string | window } )
Example:
The following information on the buffers is an actual example of what SHOW
returns.
SHOW (BUFFERS)
RETURN:
Name: MAIN Mapped to 1 window
Input file:
Output file:
Contains 0 lines Max_lines: 0 Maximum line size: 0
Left Margin: 1 Right Margin: 79
FORWARD INSERT
Key-map-list: TPU$KEY_MAP_LIST
Name: COMMANDS Mapped to 1 window
Input file:
Output file:
Contains 10 lines Max_lines: 0 Maximum line size: 0
Left Margin: 1 Right Margin: 80
SYSTEM MODIFIED REVERSE OVERSTRIKE
Key-map-list: EVE$COMMAND_MAP_LIST
Note that the above is only an example. Specific information will vary.
Errors:
TPU$_NOSHOWBUF Buffer variable SHOW_BUFFER must exist.
Related Builtins:
SHOW