help.ae

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

                                   Main Menu

	Aee allows you to move through the file and execute commands without
having to toggle through different modes.  The following are the topics 
available in this help file:

	commands	keys	init.ae

Please enter the entire word you are interested in learning more information
about.  If you would like to return to this menu later while still in this 
help facility, enter a TAB (press the TAB key, then the RETURN key).  To 
learn about a topic, enter the topic at the prompt (type the entire topic 
just as it is in the list, then press RETURN).

The man (reference) page for aee contains additional information, such as 
configuration information, which is not contained in this on-line help file.

To exit the help facility, simply press the RETURN key without entering other 
information.

Copyright (c) 1987, 1988, 1989, 1991, 1992, 1994, 1995, 1997, 1999 Hugh Mahon.

commands

	Aee uses word commands to perform several functions.  The following are
the commands used:

   !            eight        line          nooverstrike  save
   +-           exit         literal       nostatus      show
   autoformat   expand       noautoformat  nowindows     spacing
   binary       file         nocase        overstrike    status
   case         height       noeight       print         tabs
   cd           help         noexpand      pwd           text
   character    indent       noindent      quit          untabs
   define       info         noinfo        read          windows
   delete       justify      nojustify     resequence    write
   edit         leftmargin   noliteral     rightmargin


binary

	Files read while in binary mode will be read in as is, only the 
new line (also called the line-feed) character has special meaning 
(terminating a line).  

	The command line option '-binary' may be used to ensure the 
editor is in the binary mode when starting.

	The 'binary' command may also be used in the file 'init.ae'.

	See also 'text'.

text

	Files read while in the text mode will be checked whether or 
not they contain carriage-return characters immediately before new-line 
(also called line-feed) characters.  

	If the file does contain carriage-returns before new-lines, the 
file is deemed a DOS file.  When it comes time to write the file, if 
the editor has set a flag and will write the file with 
carriage-returns.  

	If no carriage-return characters are found, the file is deemed 
a UNIX file.

	The 'text' mode is the default.  See 'binary' for non-text mode 
behavior.

	It is possible to change the mode between DOS and UNIX in the 
menu (which can by default be accessed by pressing the Escape key, or 
control-[).

	The command line option '-text' can be used to ensure that the 
editor starts in text mode.

character

	To have the ascii code for the character the cursor is currently
pointing to displayed, type 'character' at the command prompt.  The decimal 
form of the number is the one displayed.

cd

	The command 'cd' will change the current working to the one 
specified, for example:

	cd ..

will cause the working directory to be changed to the directory above the 
current directory.  

file

	Entering the command 'file' at the command prompt causes the name
of the file being edited to be displayed.  The file is the name entered
on the command line when the editor is invoked.

height

        The command 'height' is used to set or display the number of lines 
that are to be displayed in the info window.  By providing a numeric 
argument for the command, like so:

                height 8

the number of lines will be set according to the value of the argument.  If 
no argument is provided, the current value will be displayed.  

        See the commands 'info' and 'noinfo' to learn how to turn on or off 
the display of the info window.

info
noinfo

        The command 'info' turns on the display of an information window at 
the top of the screen.  This window displays the keys associated with the 
control keys (keys pressed at the same time as the CONTROL key).  

        The command 'noinfo' turns off the display of this window.

	These commands may be used in the file init.ae. See 'init.ae' for 
more information.

        The info window is by default displayed.  It can be turned off 
automatically by putting 'noinfo' in an init.ae file, or by specifying the 
'-i' option when invoking aee.

        See the command 'height' to learn how to change the size of the 
info window.

line

	Entering the command 'line' at the command prompt will cause the
number of the line the cursor is currently on to be displayed.

read

	You may read other files into the current buffer by using the command
'read', as in the example below:

		read file.c

The file named 'file.c' will be read into the buffer you are currently
operating in.  This may be any buffer you create or in 'main', the initial
buffer created at the start of aee.  You may read in as many files as you wish
as often as you wish.  


write

	You may write out the buffer you are currently operating in to a file
using the command 'write', as in the example:

		write file.c

The file name is then compared to the current file name.  If the named file is
not the same as the current file, aee checks if it already exists.  If the file
does already exist, you are asked if you want to write over it.  If you decide 
to write over the file, answer 'y'.  This will cause aee to delete the 
existing file.  If the file does not already exist, it will be created without 
prompting for any more information.


save

        The command 'save' will save the contents of the buffer 'main' to the 
file named when the editor was invoked.


edit

        You may edit another file within the same edit session by using 
the command 'edit', as in the example:

                edit file.c

A new buffer named 'file.c' will be created and the file (if it exists) 
will be read into the buffer.  If journalling was not turned off at the 
beginning of the edit session (either with a command line option or 
command in the file .init.ae) then a journal file will also be created 
for this file.

The buffer will be deleted by the 'delete' command, or when the editor 
is exited.  If changes have been made to the contents of an edit buffer, 
the user will be prompted whether or not to save the contents of the buffer.

buffer

	The command 'buffer' performs three functions.  Entered with no 
argument, 'buffer' will display the name of the current buffer.  Entered with 
an argument, 'buffer' will move to the buffer with the argument as the name of 
the buffer.  If the buffer does not exist, it is created.  If the buffer 
exists, the cursor is placed at the last position it occupied in that buffer.


delete

	The command 'delete' deletes the buffer you are currently operating in.
You cannot delete the buffer named 'main', since this is the buffer containing
the file you read in upon entering aee.


exit

	The command 'exit' causes you to leave the edit session and write the
buffer 'main' out to the file named when you invoked aee.  If you have created
any other buffer(s) in the session, you will be prompted if you are sure you
wish to exit without doing anything with the data in the other buffer(s).

	An optional exclamation mark ('!') after the command allows you to 
leave aee without going through the rest of the list of files you entered when 
invoking the edit session.  


quit

	The command 'quit' allows you to leave the edit session without saving
the changes you made during the edit session.  If you have created other 
buffers during the session, you will be prompted if you are sure you wish to 
exit without doing anything with the data in the other buffer(s).

	An optional exclamation mark ('!') after the command allows you to 
leave aee without going through the rest of the list of files you entered when 
invoking the edit session.  


+-

	Entering a '+' or '-' and then a number will move the cursor forward
or backward in the text that number of lines.


!

	The exclamation point ('!') at the beginning of the line followed by a 
shell command allows you to execute the shell command without having to exit 
or quit the edit session.

	You may read data into a buffer by typing a '<' and then the name of a 
buffer (if different from the current buffer) before the !command, as follows:

		<inbuff !ls

	You may also send data out to be processed by a shell command by 
typing a '>' and the name of a buffer (if different from the current buffer) 
before the !command, as follows:

		>outbuff !sort

	You may output data and read from a shell command at the same time, as 
follows:
		<sorted >list !sort

which will send data from buffer 'list' to be sorted, and then place the 
sorted data in a buffer named 'sorted'.


pwd

	Prints the working (current) directory.

case
nocase

	The command 'case' tells aee to discriminate between upper and lower 
case during a search or replace command.  The default condition is that aee
does not discriminate between upper and lower case (nocase).  You may tell
aee to be case sensitive in the file 'init.ae' (see topic init.ae).

	The command 'nocase' tells aee not to discriminate between upper and 
lower case during search and replace operations.  This command is used to
return to the default condition after using the command 'case'.


literal

	The command 'literal' tells aee to match characters one to one during
the search operation, i.e., to match an 'a' in the search string to an 'a' in
the text, or a '*' to a '*'.  When in literal mode, aee matches exactly what is
in the search string to the text through which it is searching.  In literal 
mode, no characters have special meaning.

	The command 'noliteral' tells aee that certain characters in the 
search string may be metacharacters, that is, characters which have special 
meaning.  See topic 'noliteral'.  

	'literal' and 'noliteral' may be used in the initialization file.  See
'init.ae'.

noliteral

	The command 'noliteral' tells aee that some characters (described 
below) have special meaning.  Noliteral mode is the default.  The 
following characters have special meaning in noliteral mode of 
search/replace operations:

	\x	match character x verbatim
	[a-z]	match character in text in range a to z
	[^a-z]	match character in text as anything but in range a to z
	.	match any single character
	*	match any string
	^	match beginning of line
	$	match end of line

	To search for an 'a' at the beginning of a line, type '^a' for the 
search string at the prompt.  To search for a backslash (\), a dollar sign ($),
a period (.), or any of the other characters that have special meaning when in
noliteral mode, precede them with a backslash (\).  To search for a backslash, 
enter "\\" in the search string.


windows
nowindows

	The command 'windows' allows multiple buffers to exist on the screen.
When you use the command 'buffer' with an argument, a buffer is created with
the argument as the name of that window.  If you haven't entered the command
'nowindow', aee will put the new buffer on the screen along with the current
window reduced in size.  You may have several windows on your screen at the 
same time.  This is the default condition.  

	The command 'nowindows' tells aee that you do not want buffers to 
co-exist on the screen.  When you use the command 'buffer' and an argument, the
new buffer replaces the previous buffer on the screen.  The old buffer still
exists, but simply will not be visible until you move back to that buffer.  You
may turn off windowing in the file 'init.ae' (see topic init.ae).


show

	The command 'show' is used to display the function(s) assigned to the
specified key.  Example:

		show ^g

displays:

		key defined as gold

Note that the carat ('^') is typed by the user.  Both control keys (^x) and 
function keys  (f#) may be displayed.  


define

	The command 'define' is used to assign a function or set of functions
to a key.  Example:

		define ^L dl

assigns the function 'delete line' to the key combination control-L using the 
symbol 'dl'.  Note that the '^' is typed by the user.  More than one function 
may be assigned to a key, as long as each function is separated by one or more 
spaces.  You may also assign a string to be inserted by executing a control or 
function key by using delimiters:

		define f8 /insert this string/