aee.1

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

	define ^z rp
	define gold ^z prp
	define f3 und
	define f4 unmark
	define k0 srch
	define gold k0 psrch
	case
	printcommand lp -dlaser
	echo \\033&jB
.RE
.sp
.fi
.ad b
The above example assigns the command \fBreplace\fR to control-z, and 
\fBreplace prompt\fR to gold control-z, as well as setting \fIaee\fR to be 
sensitive to the case of characters during search and replacement 
operations.  It also defines the function keys \fBf3\fR and \fBf4\fR to be 
\fBundelete\fR and \fBunmark\fR respectively.  The \fBprint\fR command will 
send its output to the device 'laser' through the \s-1UNIX\s+1 command 
\fBlp\fR.  A string is \fBecho\fRed to the terminal which will "turn on" 
the user function keys on an HP terminal.  
.PP
The user may wish to \fBecho\fR strings to the terminal when 
starting \fIaee\fB to
set up the terminal or other devices, so the \fBecho\fR facility is
provided.  \fBEcho\fR is applicable \fIonly\fR in the initialization file.
No quotes are required around the string to be echoed.  Characters may be
literal or escaped (using the backslash convention).  The \fB-e\fR option on
the invoking command line turns off the \fBecho\fR operation.  This may be
useful if you normally use one type of terminal (and echo strings for its
use), but occasionally use another terminal and do not wish the strings to
be \fBecho\fRed.
.PP
Operations allowed in the initialization file are noted in the 
list of commands with an asterisk (*).
.\"
.\"
.\"
.SS Shell Escapes
.PP
Sometimes it is desirable to execute shell commands outside of the editor.  
This may be accomplished by pressing a key assigned to the \fBcommand\fR
function (\fB^E\fR, or \fBgold F8\fR), and then entering an 
exclamation mark (!) followed by the shell command(s) to be executed.  It 
is possible to send data from the editor to be processed by a shell 
command and/or read data from a shell command into a buffer in the 
editor.  The format for this is as follows:
.na
.nf
.sp
.RS
	<\fIinbuff\fR >\fIoutbuff\fR !\fIcommand\fR
.RE
.sp
.ad b
.fi
where \fIinbuff\fR is the name of the buffer to receive the data and 
\fIoutbuff\fR is the name of the buffer to output to the shell command.  By
omitting the name of the buffer, the current buffer will be used.  For example,
if you have a list of names and wish them sorted, you could use the \s8UNIX\s0
command \fIsort\fR.  If you wished to view them while in the current edit 
session, you could use the following sequence:
.sp
.na
.nf
.RS
	<sorted >list !sort
.RE
.ad b
.fi
.sp
where \fIlist\fR is the name of the buffer containing the unsorted list, 
\fIsorted\fR is the name of the buffer to contain the sorted list, and 
\fIsort\fR is the name of the \s8UNIX\s0 command to be executed.  The data 
read in from the
command will be placed after the current cursor location in the receiving 
buffer.  If the specified buffer does not exist when the command is entered, 
it will be created.  You should be sure of the spelling of the name of the 
buffer to be the input of the command if you are specifying one.  
.\"
.\"
.\"
.SS PRINT Command
.PP
The \fBprint\fR command allows you to send the contents of the current buffer 
to a command specified by using the \fBprintcommand\fR operation in the 
initialization file.  The default is '\fBlp\fR', using the default device.  
.PP
If you choose to specify something other than the default command, the 
command should be able 
to take its input from \fIstdin\fR, since \fIaee\fR will set up a pipe to feed 
the information to the command.
.\"
.\"     paragraph formatting
.\"
.SS Paragraph Formatting
.PP
Paragraphs are defined for \fIaee\fR by a block of text bounded by:
.sp 
.RS 8
.IP \(bu 
Begin or end of file.
.IP \(bu
Line with no characters, or only spaces and/or tabs.
.IP \(bu
Line starting with a period ('.') or right angle bracket ('>').
.RE
.PP
A paragraph may be formatted two ways:  explicitly by choosing the 
\fBformat paragraph\fR menu item, or by setting \fIaee\fR to automatically 
format paragraphs.  The automatic mode may be set via a menu, or via the 
initialization file.
.PP
There are three states for text operation in \fIaee\fR: free-form, wrap, 
and automatic formatting.
.PP
"Free-form" is best used for things like programming.  There are no 
restrictions on the length of lines, and no formatting takes place.  Margins 
are not enabled for this state.
.PP
"Wrap" allows the user to type in text without having to worry about going 
beyond the right margin (the right and left margins may be set in 
the \fBsettings\fR 
menu, the default is for the right margin to be the right edge of the 
terminal).  This is the mode that allows the \fBformat paragraph\fR menu 
item to work.  The "observe margins" entry in the "settings" menu allows the 
user to toggle this state, as well as the \fBmargin\fR and \fBnomargin\fR 
commands (see \fBCommands\fR above).
.PP
"Automatic formatting" provides word-processor-like behavior.  The user 
may type in text, while \fIaee\fR will make sure the entire paragraph fits 
within the margins every time the user inserts a space after 
typing or deleting text.  Margins must also be enabled in order for 
automatic formatting to occur.  The "auto paragraph format" item in the 
"settings" menu allows the user to toggle this state, as well as the commands 
.B autoformat
and \fBnoautoformat\fR.
.\"
.\"     modes
.\"
.SS Modes
.PP
Although \fIaee\fR is a 'modeless' editor (it is in text insertion mode all the 
time), there are modes in some of the things it does.  These include:
.RS 4
.IP "\fBtabs to spaces\fR"
Tabs may be inserted as a single tab character, or replaced with spaces.
.IP "\fBcase sensitive search\fR"
The search operation can be sensitive to whether characters are upper- or 
lower-case, or ignore case completely.
.IP "\fBliteral search\fR"
Allows the user to specify whether regular expressions are to be used for 
searching or not.
.IP "\fBobserve margins\fR"
The left and right margins can be observed, or not.
.IP "\fBinfo window\fR"
A window showing the keyboard operations that can be performed can be 
displayed or not.
.IP "\fBstatus line\fR"
Display the file name, position in the file, and selected status indicators.
.IP "\fBauto indent\fR"
The editor can be set to automatically indent the newly inserted line the same 
as the previous line, or not (primarily useful for programming).
.IP "\fBoverstrike\fR"
Toggle text insertion or overstrike modes.
.IP "\fBauto paragraph formatting\fR"
While typing in text, the editor can try to keep it looking reasonably well 
within the width of the screen.
.IP "\fBmulti windows\fR"
Allow multiple buffers to be displayed at the same time, or only a single 
buffer at a time.
.IP "\fBinfo window height\fR"
Displays and allows the user to change the height of the information window 
displayed at the top of the terminal (window) with key mappings and commands.
.IP "\fBsave editor config\fR"
Used to save the current editor configuration to a file (see the 
section \fBInitializing aee from a file\fR).  In addition to the 
settings within the settings menu, tabs and key mappings are saved.
.RE
.PP
You may set these modes via the initialization file (see above), with a 
menu (see \fBMenu\fR above), or via commands (see \fBCommands\fR above).
.\"
.\"
.\"
.SS Mark, Cut, Copy, and Paste
.PP
To move large chunks of text around, use the control key 
commands \fBmark\fR (^U or f6), \fBcut\fR (^X or f7), 
and \fBpaste\fR (gold ^V or gold f7).  These commands allow you to 
mark the text you wish to use so that it may be put in the paste buffer.  The 
paste buffer differs from the buffers mentioned below in that you may not move
to it, and that it is only used for these operations.  Once the text has been 
placed in the paste buffer, you may move your cursor wherever you wish and 
insert the text there, as many times you wish, anywhere you want.  
.PP
Simply move the cursor to the start of a section of text you wish to mark, and
press the key assigned the control key function \fBmark\fR (^U or f6).  Move 
the cursor over the text you wish to place in the paste buffer.  The text 
between the cursor position at which you pressed the \fBmark\fR key and the 
current position will be highlighted.  Once you have marked all of the text 
you wish to place in the paste buffer, press the key for \fBcut\fR (^X or f7)
or \fBcopy\fR (^C or gold f6).  The
\fBcut\fR operation deletes the text from the buffer in which the text is 
contained, and the \fBcopy\fR operation simply places the text in the paste
buffer without deleting it.  Now you may move to another 
section and use the \fBpaste\fR function to insert it as many times as you 
wish.  
.PP
If you wish to copy several sections of text that are not adjacent to each 
other, you may use the \fBappend\fR function (gold ^B) to put the text you 
will mark at the end of the current paste buffer contents, or the 
\fBprefix\fR function (gold ^D) to 
place the newly marked text before the current paste buffer contents when you 
\fBcopy\fR or \fBcut\fR.  The \fBprefix\fR and \fBappend\fR functions are 
used in place of the \fBmark\fR function.
.PP
Sometimes you may start marking text, then decide to cancel the operation.  
It is possible to do that by using the \fBunmark\fR operation.  The 
\fBunmark\fR operation is not assigned to any key by default.
.\"
.\"	Buffer operations
.\"
.SS Buffer Operations
.PP 
\fIaee\fR allows you to examine more than one file in the editor during
one edit session.  This mechanism is known as buffers, and the first
buffer is called \fBmain\fR.  Buffers may or may not be viewed
simultaneously on the screen depending upon the wishes of the user.  The
default condition allows for the buffers to co-exist on the screen, but
this may be changed by using the command \fBnowindows\fR.  To return to
the default condition, enter the command \fBwindows\fR, and buffers will
co-exist on the screen.  You may switch between having windows and not
having windows at any time without losing information in the buffers.
\fIaee\fR will remind you that you have buffers if you attempt to leave
the editor without deleting them.
.PP
Buffers are created when you enter the command \fBbuffer\fR with a single
argument, which is used as the buffer's name.  This command not 
only creates the new buffer, but it moves 
the cursor to the new buffer.  This is also the way
to move to a buffer which already exists.  Buffer movement is also
facilitated by the control key commands \fBnb\fR (gold ^N) and \fBpb\fR 
(gold ^P), short for \fBnext buffer\fR 
and \fBprevious buffer\fR.  This is especially useful if you mistype or forget 
the name of any of the buffers you have created and have windowing turned off.
.PP
The command \fBbuffer\fR without any arguments displays the name of the 
current buffer.  
.PP
Buffers can be deleted by using the command \fBdelete\fR.  Simply move to the 
buffer to be deleted and use the command \fBdelete\fR.  You \fBcannot\fR 
delete the first buffer, called \fBmain\fR.  Note that all 
commands operate in the 
buffer in which your cursor is operating, so you may use the \fBwrite\fR and
\fBread\fR commands to save or read a file into the current buffer.
.\"
.\"	On-Line Help
.\"
.SH On-Line Help
.PP
On-line help is provided through the 'help' command or menu item.  This 
command uses a file with help information.  By default the help file is 
located in \fB/usr/local/lib/help.ae\fR, but this file may be located 
in the user's home directory with the name \fB.help.ae\fR, or in the 
current directory with the name \fBhelp.ae\fR.
.\"
.\"	Warnings
.\"
.SH WARNINGS
.PP
A journal file will not be created if the user does not have write 
permission to the directory in which the file is to reside.
.PP
If the file to edit does not exist, and is to be 
created in a directory to which the user does not have write permission, 
\fIaee\fR will exit with an error without editing the file.
.PP
The automatic paragraph formatting operation 
may be too slow for slower systems.
.PP
Writing the information to the journal during some operations may be 
rather disk I/O intensive, which may impact performance noticably on 
slower systems.  Journal files may also grow considerably during an edit 
session, which may be a concern if there is little disk space available.  
Turning off journaling may be useful if performance is slow, but turning 
off journaling will mean the loss of data should a system or network 
failure occur while using the editor.
.\"
.\"
.\"
.SH CAVEATS
.PP
THIS MATERIAL IS PROVIDED "AS IS".  THERE ARE 
NO WARRANTIES OF ANY KIND WITH REGARD TO THIS 
MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND 
FITNESS FOR A PARTICULAR PURPOSE.  Neither 
Hewlett-Packard nor Hugh Mahon shall be liable 
for errors contained herein, nor for 
incidental or consequential damages in 
connection with the furnishing, performance or 
use of this material.  Neither Hewlett-Packard 
nor Hugh Mahon assumes any responsibility for 
the use or reliability of this software or 
documentation.  This software and 
documentation is totally UNSUPPORTED.  There 
is no support contract available.  Hewlett-Packard 
has done NO Quality Assurance on ANY 
of the program or documentation.  You may find 
the quality of the materials inferior to 
supported materials. 
.PP
Always make a copy of files that cannot be easily reproduced before 
editing.  Save files early, and save often.
.\"
.\"
.\"
.SH FILES
.PP
.I /usr/local/lib/init.ae
.br
.I $HOME/.aeeinfo
.br
.I $HOME/.init.ae
.br
.I .init.ae
.\"
.\"
.\"
.SH AUTHOR
.PP
The software 
.I aee
and 
.I xae
was developed by Hugh Mahon.
.PP
This software and documentation contains 
proprietary information which is protected by 
copyright.  All rights are reserved. 
.PP
Copyright (c) 1986, 1987, 1988, 1991, 1992, 1993, 1994, 1995, 1996, 
1997, 1998, 1999 portions 
Hugh Mahon and 
portions Hewlett-Packard Company.