ee.1

EE Text Editor in standard UNIX

.\"
.\"
.\"  To format this reference page, use the command:
.\"
.\"    nroff -man ee.1
.\"
.\"  $Header: /home/hugh/sources/old_ae/RCS/ee.1,v 1.22 2001/12/16 04:49:27 hugh Exp $
.\"
.\"
.TH ee 1 "" "" "" ""
.SH NAME
ee \- easy editor
.SH SYNOPSIS
.nf
ee [-e] [-i] [-h] [+#] [\fIfile\fR ...]
ree [-e] [-i] [-h] [+#] [\fIfile\fR ...]
.ta
.fi
.ad b
.SH DESCRIPTION
The command 
.I ee 
is a simple screen oriented text editor.  It is always in text insertion 
mode unless there is a prompt at the bottom of the terminal, or a 
menu present (in a box in the middle of the terminal).  The command 
.I ree 
is the same as 
.I ee, 
but restricted to editing the named 
file (no file operations, or shell escapes are allowed).
.PP
An editor with similar user-friendly qualities but more features is available 
and is called 
.I aee.
.PP
For 
.I ee
to work properly, the environment variable 
.SM TERM 
must be set to indicate the type of terminal being used.  For 
example, for an 
.SM HP 700/92 
terminal, the 
.SM TERM 
variable should be set to "70092".  See your System Administrator if 
you need more information.
.\"
.\"     options
.\"
.SS Options
The following options are available from the command line:
.PP
.TP 4
.B -e
Turns off expansion of tab character to spaces.
.TP 
.B -i
Turns off display of information window at top of terminal.
.TP
.B -h
Turns off highlighting of borders of windows and menus (improves 
performance on some terminals).
.TP
.B +#
Moves the cursor to line '#' at startup.
.br
.\"
.\"     control keys
.\"
.SS "Control keys"
To do anything other than insert text, the user must use the control 
keys (the 
.B Control 
key, represented by a "^",  pressed in conjunction with an 
alphabetic key, e.g., ^a) and function keys available on the keyboard 
(such as 
.BR "Next Page" ", " "Prev Page" ,
arrow keys, etc.).
.PP
Since not all terminals have function keys, 
.I ee
has the basic cursor movement functions assigned to control keys as 
well as more intuitive keys on the keyboard when available.  For 
instance, to move the cursor up, the user can use the up arrow key, 
or 
.BR ^u .
.RS 4
.nf
.ta 1.4i
.sp
^a 	Prompt for the decimal value of a character to insert.
^b 	Move to the bottom of the text.
^c 	Get the prompt for a command.
^d 	Move the cursor down.
^e 	Prompt for the string to search for.
^f 	Undelete the last deleted character.
^g 	Move to the beginning of the line.
^h 	Backspace.
^i 	Tab.
^j 	Insert a newline.
^k 	Delete the character the cursor is sitting on.
^l 	Move the cursor left.
^m 	Insert a newline.
^n 	Move to the next page.
^o 	Move to the end of the line.
^p 	Move to the previous page.
^r 	Move the cursor to the right.
^t 	Move to the top of the text.
^u 	Move the cursor up.
^v 	Undelete the last deleted word.
^w 	Delete the word beginning at the cursor position.
^x 	Search.
^y 	Delete from the cursor position to the end of line.
^z 	Undelete the last deleted line.
^[ (ESC)	Pop up menu.
.ta
.fi
.RE
.sp
.SS "EMACS keys mode"
.PP
Since many shells provide an Emacs mode (for cursor movement and other editing 
operations), some bindings that may be more useful for people familiar with 
those bindings have been provided.  These are accessible via the 
.B settings 
menu, or via the initialization file (see below).  The mappings are as follows:
.RS
.nf
.ta 1.4i
^a	Move to the beginning of the line.
^b	Back 1 character.
^c	Command prompt.
^d	Delete character the cursor is sitting on.
^e	End of line.
^f	Forward 1 character.
^g	Go back 1 page.
^h	Backspace.
^i	Tab.
^j	Undelete last deleted character.
^k	Delete line.
^l	Undelete last deleted line.
^m	Insert a newline.
^n	Move to the next line.
^o	Prompt for the decimal value of a character to insert.
^p	Previous line.
^r	Restore last deleted word.
^t	Move to the top of the text.
^u	Move to the bottom of the text.
^v	Move to the next page.
^w	Delete the word beginning at the cursor position.
^y	Prompt for the string to search for.
^z	Next word.
^[ (ESC)	Pop up menu.
.ta
.fi
.RE
.sp
.\"
.\"     function keys
.\"
.SS "Function Keys"
.RS 4
.IP "\fBNext Page\fR"
Move to the next page.
.IP "\fBPrev Page\fR"
Move to the previous page.
.IP "\fBDelete Char\fR"
Delete the character the cursor is on.
.IP "\fBDelete Line\fR"
Delete from the cursor to the end of line.
.IP "\fBInsert line\fR"
Insert a newline at the cursor position.
.IP "\fBArrow keys\fR"
Move the cursor in the direction indicated.
.RE
.\"
.\"     commands
.\"
.SS Commands
.PP
Some operations require more information than a single keystroke can 
provide.  For the most basic operations, there is a menu that can be 
obtained by pressing the 
.SM \fBESC\fR
key.  The same operations, and more can be performed by obtaining the 
command prompt (^c) and typing in one of the commands below.
.RS 4
.IP "!\fBcmd\fR"
Execute \fBcmd\fR in a shell.
.IP "\fB0-9\fR"
Move to the line indicated.
.IP "\fBcase\fR"
Make searches case sensitive.
.IP "\fBcharacter\fR"
Display the ascii value of the character at the cursor.
.IP "\fBexit\fR"
Save the edited text, and leave the editor.
.IP "\fBexpand\fR"
Expand tabs to spaces.
.IP "\fBfile\fR"
Print the name of the file.
.IP "\fBhelp\fR"
Display help screen.
.IP "\fBline\fR"
Display the current line number.
.IP "\fBnocase\fR
Make searches insensitive to case (the default).
.IP "\fBnoexpand\fR"
Don't expand tab to spaces when the TAB key is pressed.
.IP "\fBquit\fR"
Leave the editor without saving changes.
.IP "\fBread\fR \fIfile\fR"
Read the named \fIfile\fR.
.IP "\fBwrite\fR \fIfile\fR"
Write the text to the named \fIfile\fR.
.RE
.\"
.\"     menu operations
.\"
.SS "Menu Operations"
.PP
Pop-up menus can be obtained by pressing the 
.B escape 
key (or 
.B ^[ 
if no 
.B escape 
key is present).  When in the menu, the escape key can be 
used to leave the menu without performing any operations.  Use the up and 
down arrow keys, or 
.B ^u
for moving up and 
.B ^d 
for moving down to move to the desired items in the menu, then press 
.B return 
to perform the indicated task.
.PP
To the left of each menu item is a letter, which if the corresponding 
letter is pressed on the keyboard selects that menu entry.
.PP
The main menu in \fIee\fR is as follows:
.RS 4
.IP "\fBleave editor\fR" 
If changes have been made, the user will get a menu prompting whether or 
not the changes should be saved.
.IP "\fBhelp\fR"
Displays a help screen, with all of the keyboard operations and commands.
.IP "\fBfile operations\fR"
Pops up a menu for selecting whether to read a file, write to a file, or 
save the current contents of the editor, as well as send the contents of 
the editor to a print command (see the section \fBInitializing ee from a 
file\fR).
.IP "\fBredraw screen\fR"
Provides a means to repaint the screen if the screen has been corrupted.
.IP "\fBsettings\fR"
Shows the current values of the operating modes, and right margin.  By 
pressing return when the cursor is on a particular item, the value can be 
changed.  To leave this menu, press the \fBescape\fR key.  (See \fBModes\fR 
below.)
.IP "\fBsearch\fR"
.br
Pops up a menu in which the user may choose to enter a string to search 
for, or search for a string already entered.
.IP "\fBmiscellaneous\fR"
Pops up a menu that allows the user to format the current paragraph, 
execute a shell command, or check the spelling of the text in the editor.
.RE
.\"
.\"     paragraph formatting
.\"
.SS "Paragraph Formatting"
.PP