aee.1

aee是一种易使用的文本编辑器。你可以不用说明书来使用它。它提供终端接口和本地的X-windows接口。它的特性包括即弹的菜单

.\"
.\" Reference page for aee, rae, and xae.
.\"
.\" Format this page with one of the following commands:
.\"
.\"	tbl aee.1 | nroff -man 
.\" or
.\"	tbl aee.1 | troff -man
.\"
.\"  Copyright (c) 1991, 1992, 1994, 1995, 1996, 1997, 1998, 1999 Hugh Mahon.
.\"
.TH aee 1 "" "" "" ""
.SH NAME
aee - another (easy) editor
.SH SYNOPSIS
.B aee 
[ options ... ] [file[s]]
.br
.B rae
[ options ... ] file[s]
.br
.B xae 
[ options ... ] [file[s]]
.br
.B rxae
[ options ... ] file[s]
.sp
.SH DESCRIPTION
.PP
\fIaee\fR and \fIxae\fR are non-modal editors, that is, the user does not need 
to switch from one mode to another to insert and delete text.  The editor is 
always in text mode.  Control sequences and function keys are used to perform 
the editing functions.  In the case of \fIxae\fR, the mouse can also be used 
to position the cursor, and perform text selection and pasting.
.PP
\fIrae\fR and \fIrxae\fR are the same as \fIaee\fR and \fIxae\fR 
respectively, except that they are restricted to editing 
the file(s) named on the invoking command line.  No other files may be opened 
or written, nor may shell operations be performed.
.PP
The arrow keys (up, down, left, right) may be used to move the cursor.  If 
the keyboard is so equipped, the \fBprev\fR and \fBnext\fR keys will move 
the cursor to the previous and next pages, respectively.
.PP
The \fBgold\fR key is a key that is used to provide alternate behavior for 
a key, much like a gold function key on a calculator keyboard.  So, for 
example, function key number 7 (\fBf7\fR) may be used for initiating a 
search, while pressing the \fBgold\fR key and then \fBf7\fR will produce 
a prompt for the string to be searched for.  The gold function can be 
assigned to any assignable key.  By default, the keys \fBf1\fR and 
\fBcontrol-g\fR (\fB^g\fR) are assigned the gold function.
.PP
The rest of the keys by default will behave as described below.
.\"
.\"
.\"
.SH OPTIONS
The following are accepted as options when starting \fIaee\fR or \fIxae\fR:
.RS
.IP -binary 22
When reading in the file, treat as a binary file (only special character is 
a new-line character).
.IP -e 22
Turn off echo from initialization file.
.IP -i 22
Turn off info window.
.IP -j 22
Turn off journaling.
.IP -n 22
Turn off highlighting of menu and info window borders.
.IP -r 22
Recover from failed edit session (using journal file from that session).
.IP -tab 22
Expand tabs to spaces.
.IP -text 22
When reading in a file, treat as text only (both carriage-return and new-line 
are special characters).
.IP +\fInumber\fR 22
Move cursor to start of line \fInumber\fR.
.RE
.sp
The following additional options are available for \fIxae\fR only:
.RS
.IP "-fn \fIfont\fR" 22
Specify a font for use with \fIxae\fR.  Resource name \fBBaseFont\fR.
.IP "-fg \fIcolor\fR" 22
Specify a foreground color (color of text).  Resource name 
\fBForegroundColor\fR.
.IP "-bg \fIcolor\fR" 22
Specify a background color.  Resource name \fBBackgroundColor\fR.
.IP "-geometry \fI=columns\fBx\fIlines\fR"
Specify a geometry for \fIxae\fR.  Resource name \fBGeometry\fR.
.RE
.PP
The \fIxae\fR specific options may be specified in the \fBX-Windows 
Version 11\fR defaults file for the user.  See your X-Windows 
documentation for more details.
.\"
.\"
.\"
.SS Function Keys
.PP
\fIaee\fR uses the terminal's function keys to perform editing tasks.  By 
default, only keys \fBf1\fR through \fBf8\fR are defined.  (Although a 
terminal may have function keys, the keys may not send unique sequences 
that can be recognized by software, or may require particular settings in 
order to be useful.  If in doubt, ask your system administrator.)
.sp 1
.TS
center;
l l l.
KEY NAME	NORMAL FUNCTION	GOLD FUNCTION

F1	GOLD	GOLD
F2	undel character	undel line
F3	delete word	undel word
F4	advance word	begin of line
F5	search	search prompt
F6	mark	copy
F7	cut	paste
F8	advance line	command
.TE
.\"
.\"	Control keys
.\"
.SS Control Keys
.PP
Control keys are the regular alphabetic keys pressed in conjunction with 
the \fBcontrol\fR key (sometimes spelled \fBCTRL\fR).  To press control-a 
(also noted as \fB^a\fR), first press \fBcontrol\fR, then press '\fBa\fR', so 
that both keys are pressed at the same time.
.RS 4
.TS
center;
l l l.
KEY NAME	NORMAL FUNCTION	GOLD FUNCTION

Control A	ascii code	match
Control B	bottom of text	append
Control C	copy	clear to eol
Control D	begin of line	prefix
Control E	command
Control F	search	search prompt
Control G	GOLD	GOLD
Control H	backspace
Control J	carriage-return
Control K	delete character	undelete char
Control L	delete line	undelete line
Control M	carriage-return
Control N	next page	next buffer
Control O	end of line
Control P	prev page	prev buffer
Control R	redraw screen	reverse
Control T	top of text
Control U	mark
Control V	paste	forward search
Control W	delete word	undelete word
Control X	cut	format
Control Y	advance word	prev word
Control Z	replace	replace prompt
Control [ (Escape)	menu	
.TE
.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, 
.B ^u
and 
.B ^d 
or the 
.B space
or 
.B backspace
keys to move to the desired items in the menu, then press 
.B return 
to perform the indicated task.
.PP
The main menu in \fIaee\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 "\fBedit\fR"
Pops up a menu to allow the user to \fBmark\fR, \fBcopy\fR marked text, 
\fBcut\fR marked text, or \fBpaste\fR previously marked text.
.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, send the contents of 
the editor to a print command (see the section \fBInitializing aee from a 
file\fR), as well as recovering from a previous edit session (see 
\fBRecovery\fR below).
.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 margins.  By 
pressing return when the cursor is on a particular item, the value can be 
changed.  Also within this menu is an entry to allow the user to save the 
current configuration of the editor to a file.  
To leave this menu, press the \fBescape\fR key.  (See \fBModes\fR 
below.)
.IP "\fBsearch/replace\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, or perform a replace string 
operation.
.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 current 
buffer.
.RE
.\"
.\"
.\"
.SS Commands
.PP
Some operations require more input than one key can provide, or do not
need to be so easily accessed.  These commands are entered using the prompt 
provided by pressing the \fBcommand\fR (^E or ^C or gold f8) key.  The line 
commands are:
.sp
.RS 4
.IP "\fBauto\fRformat * " 22
Turn automatic paragraph formatting on.
.IP "\fBnoauto\fRformat *" 22
Turn automatic paragraph formatting off (default).
.IP \fBbi\fRnary* 22
Turn on binary mode.  Files read into the current session will be 
treated as binary files, that is, the only special character is the 
new-line character.  See also \fBtext\fR.
.IP "\fBbuf\fRfer [\fIname\fR]*" 22
This command will move from the current buffer to the 
buffer with the name given by the user.  If the 
buffer did not previously exist, it is created.
If no parameter is given, then the name of the 
current buffer is displayed.  Note: a buffer created with this command 
is not associated with a file, nor is it journalled.
.IP "\fBca\fRse*\(dd" 22
Specifies that the case of each letter is to be
taken into account in the search operation.
.IP "\fBnoca\fRse*\(dd" 22
Specifies that there is no distinction between 
upper and lower case during search and replace operations (default).
.IP "\fBcd\fR \fIdirectory\fR" 22
Change directory
.IP \fBch\fRaracter 22
Displays the ascii code of the character the cursor is on.
.IP "\fBdef\fRine [gold] \fIkey string\fR*" 22
Assigns all of the string 
following the key definition to the key 
specified by the user.  The commands allowed 
in the string are described in the SYMBOLS 
section.
.IP \fBdel\fRete 22
Deletes the current buffer (the initial buffer 
may not be deleted).
.IP "\fBecho\fR \fIstring\fR \(dg" 22
Echoes the string to the terminal during startup of \fIaee\fR.
.IP "\fBed\fRit \fIfilename\fR" 22
Edit another file.  A new buffer will be created in which the named 
file can be edited.  If no file is specified, a temporary buffer name is 
created for use within \fIaee\fR.  If journalling is on for the initial 
file being edited, journalling will occur for the new edit buffer as 
well.
.IP \fBei\fRght* 22
If your terminal has an eight bit character set,
then use this command to cause \fIaee\fR to send the 
eight bit value to your terminal.  The default 
condition is to display the eight bit character
as the decimal value of the character between 
angle brackets.
.IP \fBnoei\fRght* 22
If your terminal does not have an eight 
bit character set, use this command to cause \fIaee\fR 
to display eight bit characters as the decimal 
value of the character between angle brackets 
(251 is displayed as <251>).  This is the default 
condition.
.IP "\fBexi\fRt[!]\(dd" 22
Exit the current edit session writing out the main buffer to the 
file name used in entering the editor.  The optional exclamation mark allows
you to leave without editing the rest of the files in the list of files
specified when the edit session was invoked.
.IP "\fBexp\fRand*\(dd" 22
Causes spaces to be inserted when the tab key is pressed.  Spaces fill to the 
next tab stop.
.IP "\fBnoex\fRpand*\(dd" 22
Tabs are \fInot\fR replaced with spaces (default).
.IP \fBfil\fRe 22
Display the name of the file being edited.
.IP "\fBhelp\fR\(dd" 22
Provides the user with information about using 
the editor while in the editor.
.IP "\fBheight\fR\ [\fInumber\fR] *" 22
Set the height (number of lines) displayed in the info window.  If no number 
is specified, the current value is displayed.
.IP "\fBhelpfile\fR\(dg" 22
The location and name of the file containing help information.
.IP "\fBind\fRent*\(dd" 22
When creating a new line by pressing the carriage return, the new line will
have the same indentation (number of spaces and tabs) as the previous line.
.IP "\fBnoind\fRent*\(dd" 22
Turns off the indent mode (default).
.IP "\fBinfo\fR *" 22
Turn info window on (default).
.IP "\fBnoinfo\fR *" 22
Turn info window off.
.IP \fBjournaldir\fR 22
Specifies the path to the directory where journal files are to be created.
.IP \fBjustify\fR 22
Justify the right side of the text when using the \fBformat\fR function to 
format a paragraph.
.IP \fBnojustify\fR 22
Turn off right justification of a paragraph (default).
.IP \fBli\fRne 22
Displays the current line number.
.IP "\fBlit\fReral*\(dd" 22
Causes characters in search string to be matched one-to-one with characters
in the text.
.IP "\fBnolit\fReral*\(dd" 22
Allows metacharacters in the search string (default).
.IP "\fBmarg\fRins *\(dd" 22
Causes left and right margins to be observed (set using \fBleftmargin\fR 
and \fBrightmargin\fR).
.IP "\fBnomarg\fRins *\(dd" 22
Allows lines to be any length (disregards the margin settings).
.IP "\fBleft\fRmargin [\fInumber\fR] *" 22
Set the left margin to \fInumber\fR.  If no number is specified, then the 
current value is displayed.
.IP "\fBright\fRmargin [\fInumber\fR] *" 22
Set the right margin to \fInumber\fR (\fBnowrap\fR must be set for margin 
setting to be observed).  If no number is specified, then the 
current value is displayed.
.IP "\fBover\fRstrike*\(dd" 22
Causes characters to overstrike or replace existing characters instead of