HISTORY — Manage the command-line recall

Synopsis

HISTORY [/?] [WRAP] [NOWRAP] [APPEND] [NOAPPEND] [MATCH] [NOMATCH] [LIST] [CLEAR] [READFROM file]

Options

/?

Display command syntax information.

WRAP

Enable wrap-around at the end of the history list when using the arrow keys.

NOWRAP

Disable wrap-around at the end of the history list when using the arrow keys.

APPEND

Enable unconditional append of all commands entered to the bottom of the history list.

NOAPPEND

Disable unconditional append of all commands entered to the bottom of the history list.

MATCH

Enable prefix matching during history recall.

NOMATCH

Disable prefix matching during history recall.

LIST

Display all lines in the history list. (Default)

CLEAR

Clear the history list.

READFROM

Append the contents of file, line by line, to the history list (without executing them).

Note

The HISTORY command is only built in to TEXTCMD.

Description

The HISTORY command manages the behaviour of command line recall in interactive mode, and manages and displays the history of command lines that are available.

Various options correspond to toggle options that can be given on the command line to TEXTCMD. The WRAP and NOWRAP options correspond to the /WRAPHISTORY option; and the APPEND and NOAPPEND options correspond to the /APPENDHISTORY option.

To replace the command line history entirely, use the CLEAR and READFROM options in succession in a single HISTORY command.

The READFROM option is useful if invoking the HISTORY command via the contents of the CMD_TEXTCMD_INIT environment variable in order to pre-populate the command line history list.