.de EX		\"Begin example
.ne 5
.if n .sp 1
.if t .sp .5
.nf
.in +.5i
\fC
..
.de EE
.fi
.in -.5i
.if n .sp 1
.if t .sp .5
\fR
..
.TH cle 1 "October 1999" 

.SH NAME
\fBcle\fP \-  \fBC\fRommand \fBL\fRine \fBE\fRditor

.SH SYNOPSYS
\fBcle\fP [options] <program> [\fB<arguments>\fP]

.SH DESCRIPTION
Cle is a Command Line Editor. It provides the
editing/history/completion commands of the \fBreadline(3)\fR package
to any line-oriented Unix command. For instance,
.EX 
$ cle ftp foo.bar.org
.EE
provides editing/history/completion commands to the ftp command.
.LP
Since most modern shells allow you to define aliases, you can define 
a simple alias such as 
.EX
$ alias ftp="cle \\ftp" (bash or zsh syntax)
.EE
or 
.EX
$ alias ftp cle ftp (tcsh or csh syntax)
.EE
to always uses cle with the ftp command.

.SH OPTIONS

The following options are recognized by \fBcle\fR:

.TP
\fB\-v\fR, \fB\-\-version\fR
output version information and exit.

.TP
\fB\-s\fR N, \fB--size=\fRN
set the size of the history to n lines. If n > 0 the history is saved
at program exit. Default size is 100.


.SH FILES

.IP \fI~/.inputrc\fR
Since cle uses the readline package, it can be customized by the file
"~/.inputrc". When cle is run it initializes the readline package and
gives it the name of the application it controls. This can be used to
define different bindings for different commands. An example is given
below:
.EX
$if ftp
"\\C-xl": "dir\\C-m"
$endif
$if stk
"\\C-xl": "(system \\"ls -ls\\")\\C-m"
$endif
$if ed
"\\C-x-l": "!ls -l\\C-m"
$endif
.EE
See the file "src/sample-inputrc" file for a more complete example.
See also standard readline documentation package for details on the
available "bindable" functions and on the format of this file.

.br 
\fIPARENTHESIS FLASHING\fR
.br
The readline version compiled with \fBcle\fR uses parentheses flashing
(i.e when you type a closing parenthesis, the corresponding opening
parenthesis flashes). Rebind the closing parentheses is with
"self-insert" to get rid of this feature.
.br
Example: 
.EX
$if ftp 
")": self-insert 
"]": self-insert 
"}": self-insert 
$end
.EE

.IP \fI~/.XXX-history\fR
When a cle'ed application leaves, the state of the history is saved in
a file whose name is ~/.XXX-history, where XXX is the name of the
application. If the size is of the history is 0, the history file 
is deleted. This avoids the accumulation of file in the 
user home directory.

.SH SEE ALSO
readline(3)