History

    Template: LINES/N,START/K/N,LOAD/K,SAVE/K,SIZE/K/N,RUN/S,CLEAR/S,SHOW/S,NONUM/S


The HISTORY command is used to control the 2.04 console handler history features.  
This command allows you to review, load, save, clear, and change the size of the 
history buffer.  In addition, the command allows you to re-execute portions of the
history  buffer without using the cursor keys.

The history command can be used to display the current history buffer just
by using the command

history

To see the last N entries in the history buffer, you also the number, eg
history 10 will show you the last 10 entries. (You can also say
history LINES 10).

To see N entries in the history buffer, starting with entry X, you would specify 
both numbers, eg

history 8 start 20

which will display 20 history lines starting with history entry # 8.
(you can also say HISTORY LINES 8 START 20)

On the left margin of the history listing is the command histry number.  To supress
those numbers, use the NONUM keyword. (this is often useful when redirecting the 
output of the history cmmand into a file or a pipe.

The LOAD keyword allows you to preload the history buffer, up to the limits of the 
current size of the history buffer.

SAVE saves the current history buffer to a file.  NOTE: partial saves are possible,
following the same rules as partial listings of the history buffer.

The CLEAR keyword erases the contents of the history buffer.  It may be used by 
itself, or with one of the other keywords.

The SIZE keyword allows you to change the size of the history buffer of the
current console-handler.  You can change the size in 1K increments.  The initial
history buffer size is 2K.

The RUN keyword allows you to run one or more commands in the history buffer.

history run 5

will run the last 5 commands.

history run 3 start 5

will run 3 commands, starting with the 5th entry in the history buffer.

a useful alias is

alias ! history lines 1 run start 

which kind of gives that Unix csh effect.

When the RUN option is specified, if no START is specified, START defaults
to the last command.  If no LINES is specified, LINES defaults to one.


The SHOW option is there as a default; it can be combined with other options,
however.