ELTCLSH(1)

NAME
eltclsh - interactive tcl interpreter

SYNOPSIS
eltclsh [filename]

DESCRIPTION

eltclsh (editline tcl shell) is an interactive shell for the TCL programming language. It provides command line editing, history browsing as well as variables and command completion thanks to editline features. The completion engine is programmable in a way similar to tcsh(1), and comes with an intelligent completion for the full tcl language by default.

SPECIAL TCL COMMANDS
eltclsh provides a few specific commands to configure interactive editing

el::history add string
Add string to the history of commands.

el::history event ?event?
Returns the value of the event given by event. If event is positive, it refers to the event with that number (all events are numbered starting at 1). If the number is negative, it selects an event relative to the current event (-1 refers to the previous event, -2 to the one before that, and so on). Event 0 refers to the current event. event defaults to -1.

el::history change ?string? ?event?
Replaces the value recorded for an event with string. Event specifies the event to replace, and defaults to the current event. This command is intended for use in commands that implement new forms of history substitution and wish to replace the current event (which invokes the substitution) with the command created through substitution. The return value is an empty string.

el::history file ?filename?
Load history from filename and sets the filename for future saves, or return current filename. Note that if ~/.eltclhistory exists and is readable it is automatically loaded at startup. If filename is the empty string, history loading and saving are disabled.

el::history save
Save history in ~/.eltclhistory by default, or in the filename configured by history file. History is automatically saved on exit.

el::history size ?length?
Set history length to length or return current length.

el::history clear
Erase the history list. The current keep limit is retained.

SEE ALSO
tclsh(1).