aee man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

aee(1)									aee(1)

NAME
       aee - another (easy) editor

SYNOPSIS
       aee [ options ... ] [file[s]]
       rae [ options ... ] file[s]
       xae [ options ... ] [file[s]]
       rxae [ options ... ] file[s]

DESCRIPTION
       aee  and	 xae 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 xae,  the  mouse  can
       also  be	 used  to  position the cursor, and perform text selection and
       pasting.

       rae and rxae are the same as aee and xae 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	opera‐
       tions be performed.

       The  arrow keys (up, down, left, right) may be used to move the cursor.
       If the keyboard is so equipped, the prev and next keys  will  move  the
       cursor to the previous and next pages, respectively.

       The  gold 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  (f7)	 may  be used for initiating a
       search, while pressing the gold key and then f7 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 f1 and control-g (^g)  are
       assigned the gold function.

       The rest of the keys by default will behave as described below.

OPTIONS
       The following are accepted as options when starting aee or xae:

	      -binary		    When  reading  in  the  file,  treat  as a
				    binary file (only special character	 is  a
				    new-line character).

	      -e		    Turn off echo from initialization file.

	      -i		    Turn off info window.

	      -j		    Turn off journaling.

	      -n		    Turn  off  highlighting  of	 menu and info
				    window borders.

	      -r		    Recover from failed	 edit  session	(using
				    journal file from that session).

	      -tab		    Expand tabs to spaces.

	      -text		    When reading in a file, treat as text only
				    (both  carriage-return  and	 new-line  are
				    special characters).

	      +number		    Move cursor to start of line number.

       The following additional options are available for xae only:

	      -fn font		    Specify a font for use with xae.  Resource
				    name BaseFont.

	      -fg color		    Specify  a	foreground  color  (color   of
				    text).  Resource name ForegroundColor.

	      -bg color		    Specify a background color.	 Resource name
				    BackgroundColor.

	      -geometry =columnsxlines
				    Specify a geometry for xae.	 Resource name
				    Geometry.

       The  xae	 specific options may be specified in the X-Windows Version 11
       defaults file for the user.  See your X-Windows documentation for  more
       details.

   Function Keys
       aee  uses  the  terminal's  function keys to perform editing tasks.  By
       default, only keys f1 through f8 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.)

		     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

   Control Keys
       Control	keys  are  the	regular alphabetic keys pressed in conjunction
       with the control key (sometimes	spelled	 CTRL).	  To  press  control-a
       (also  noted  as ^a), first press control, then press 'a', so that both
       keys are pressed at the same time.

		 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

   Menu Operations
       Pop-up menus can be obtained by pressing the escape key (or  ^[	if  no
       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,  ^u and ^d or the space or backspace keys to move to
       the desired items in the menu, then press return to perform  the	 indi‐
       cated task.

       The main menu in aee is as follows:

	   leave editor
		  If  changes have been made, the user will get a menu prompt‐
		  ing whether or not the changes should be saved.

	   help	  Displays a help screen, with all of the keyboard  operations
		  and commands.

	   edit	  Pops	up a menu to allow the user to mark, copy marked text,
		  cut marked text, or paste previously marked text.

	   file operations
		  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  sec‐
		  tion	Initializing  aee  from a file), as well as recovering
		  from a previous edit session (see Recovery below).

	   redraw screen
		  Provides a means to repaint the screen  if  the  screen  has
		  been corrupted.

	   settings
		  Shows	 the  current  values of the operating modes, and mar‐
		  gins.	 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 escape
		  key.	(See Modes below.)

	   search/replace
		  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.

	   miscellaneous
		  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.

   Commands
       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 command (^E or ^C or gold f8) key.  The
       line commands are:

	   autoformat *		 Turn automatic paragraph formatting on.

	   noautoformat *	 Turn	automatic   paragraph  formatting  off
				 (default).

	   binary*		 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 text.

	   buffer [name]*	 This  command will move from the current buf‐
				 fer 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.

	   case*‡		 Specifies that the case of each letter is  to
				 be  taken  into  account in the search opera‐
				 tion.

	   nocase*‡		 Specifies  that  there	 is   no   distinction
				 between  upper	 and  lower case during search
				 and replace operations (default).

	   cd directory		 Change directory

	   character		 Displays the ascii code of the character  the
				 cursor is on.

	   define [gold] key string*
				 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.

	   delete		 Deletes the current buffer (the initial  buf‐
				 fer may not be deleted).

	   diff			 Execute  the  diff command comparing the con‐
				 tents of the edit buffer with the  associated
				 file and place the results in a separate buf‐
				 fer.

	   echo string †	 Echoes the  string  to	 the  terminal	during
				 startup of aee.

	   edit filename	 Edit another file.  A new buffer will be cre‐
				 ated in which the named file can  be  edited.
				 If  no	 file is specified, a temporary buffer
				 name is created for use within aee.  If jour‐
				 nalling  is  on  for  the  initial file being
				 edited, journalling will occur	 for  the  new
				 edit buffer as well.

	   ee_mode*		 Have aee's main menu look more like ee's main
				 menu.

	   eight*		 If your terminal has an eight	bit  character
				 set,  then  use  this command to cause aee 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.

	   noeight*		 If  your  terminal does not have an eight bit
				 character set, use this command to cause  aee
				 to  display eight bit characters as the deci‐
				 mal value  of	the  character	between	 angle
				 brackets  (251	 is displayed as <251>).  This
				 is the default condition.

	   exit[!]‡		 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.

	   expand*‡		 Causes spaces to be inserted when the tab key
				 is pressed.  Spaces  fill  to	the  next  tab
				 stop.

	   noexpand*‡		 Tabs are not replaced with spaces (default).

	   file			 Display the name of the file being edited.

	   help‡		 Provides  the	user  with  information	 about
				 using the editor while in the editor.

	   height [number] *	 Set the height (number of lines) displayed in
				 the  info window.  If no number is specified,
				 the current value is displayed.

	   helpfile†		 The location and name of the file  containing
				 help information.

	   indent*‡		 When creating a new line by pressing the car‐
				 riage return, the new line will have the same
				 indentation  (number  of  spaces and tabs) as
				 the previous line.

	   noindent*‡		 Turns off the indent mode (default).

	   info *		 Turn info window on (default).

	   noinfo *		 Turn info window off.

	   journal		 Displays the journal file associated with the
				 current edit session buffer.

	   journaldir		 Specifies  the	 path  to  the directory where
				 journal files are to be created.

	   justify		 Justify the right side of the text when using
				 the format function to format a paragraph.

	   nojustify		 Turn  off  right justification of a paragraph
				 (default).

	   line			 Displays the current line number.

	   literal*‡		 Causes characters  in	search	string	to  be
				 matched  one-to-one  with  characters	in the
				 text.

	   noliteral*‡		 Allows metacharacters in  the	search	string
				 (default).

	   margins *‡		 Causes	 left and right margins to be observed
				 (set using leftmargin and rightmargin).

	   nomargins *‡		 Allows lines to be any length (disregards the
				 margin settings).

	   leftmargin [number] * Set  the left margin to number.  If no number
				 is specified, then the current value is  dis‐
				 played.

	   rightmargin [number] *
				 Set  the  right margin to number (nowrap must
				 be set for margin setting  to	be  observed).
				 If  no	 number is specified, then the current
				 value is displayed.

	   overstrike*‡		 Causes characters to  overstrike  or  replace
				 existing characters instead of inserting.

	   nooverstrike*‡	 Causes characters to be inserted into line at
				 current  cursor  position  without  replacing
				 existing characters (default).

	   print		 Sends	the  contents of the current buffer to
				 the printer.  The command that is used can be
				 specified  in	the  init.ae file, see section
				 Initializing aee From A File.

	   printcommand †	 Allows	 the  setting  of  the	print  command
				 (default: "lp").

	   pwd			 Display the current directory.

	   quit[!]‡		 Quit the current edit session without writing
				 a file.  The optional	exclamation  mark  has
				 the same meaning as for the exit command.

	   read file		 Read a file into the current buffer after the
				 cursor.

	   resequence		 Renumber the lines.

	   save			 Save the contents of the main buffer  to  the
				 file being edited.

	   show [gold] key	 Displays  the	function(s)  assigned  to  the
				 specified key.

	   status*‡		 A status line is displayed on the bottom line
				 of the screen.

	   nostatus*‡"		 Turns off the status line (default).

	   spacing number *	 Tabs  will  be	 spaced	 every	number spaces,
				 unless other tabs are set using the tabs com‐
				 mand.

	   tabs [stops ...] *	 Sets  tabs  to	 stops.	  After	 the last user
				 defined  tab  stop,  tabs  are	  the	normal
				 sequence  of  every  eight columns, or as set
				 using the stops command.  The first column is
				 0.

	   untabs stops ... *	 Removes the specified tab stops.

	   text*		 Turns	text  mode  (default) .	 Files read in
				 while in text mode are checked	 whether  they
				 are UNIX files or Windows files.  If carriage
				 return	 characters  are   found   immediately
				 prededing  a  new-line	 character, the editor
				 treats the file as a DOS  file	 and  discards
				 the  carriage-returns	on read, and carriage-
				 returns are inserted on file write.  The menu
				 may  be  used to toggle between DOS file mode
				 and UNIX file mode.  See also binary.

	   windows*‡		 This command specifies whether or not buffers
				 are  displayed	 on the screen simultaneously.
				 If windows (default) is specified, then  buf‐
				 fers exist on the screen together.

	   nowindows*‡		 This command specifies that there is only one
				 buffer on the screen at a time.

	   write file		 Write the current buffer out to the specified
				 file.

	   0123456789		 Enter	a number to go to the line correspond‐
				 ing to that number.

	   + or - number ‡	 Moves forward or back	the  number  of	 lines
				 specified.

	   [<inbuff] [>outbuff ] !command
				 Execute the command following the exclamation
				 mark in the UNIX shell.  The  shell  used  is
				 the one specified in the shell variable SHELL
				 in the	 user's	 environment,  or  /bin/sh  if
				 SHELL is not defined.	You may send data from
				 the buffer outbuff (or the current buffer  if
				 outbuff is not specified) out to the shell by
				 using the right angle bracket (>).   You  may
				 read  into  inbuff  (or the current buffer if
				 inbuff is not specified) by  using  the  left
				 angle bracket (<) as shown.  The data read in
				 from the command will	be  placed  after  the
				 current cursor location in the buffer

				 *  may be used in init file, see section Ini‐
				 tializing aee From A File
				 † only used in initialization file
				 ‡ may also be assigned to  a  key  using  the
				 define command

   Search and Replace
       aee's  search facility provides several abilities.  The user may choose
       for the search to be case sensitive,  or	 ignore	 the  case  (upper  or
       lower)  of  a  character	 (nocase  is  the default).  The user may also
       choose literal, or noliteral (the default) modes for the search	facil‐
       ity.   The  literal mode interprets the search string literally, nolit‐
       eral means that some characters (called	metacharacters)	 have  special
       meaning, as described below:

			 symbol	  meaning

			 ^	  beginning of line
			 $	  end of line
			 \\x	  interpret 'x' literally
			 [abc]	  match	 a  single character
				  in  the  text	 to  one  in
				  brackets
			 [a-z]	  match	 a  single character
				  in  the  text	 to  one  in
				  range a-z

			 [^abc]	  match	 a  single character
				  in the text  that  is	 not
				  within  the brackets after
				  '^' ('^' means 'not')
			 *	  match	 any   sequence	  of
				  characters, useful in mid‐
				  dle of string	 with  known
				  beginning   and  end,	 but
				  variable middle
			 .	  match any single character

       The carat (^) within the square brackets ([])  means  that  the	search
       will  match  any characters not within the brackets.  The carat must be
       the first character after the opening bracket.

       The asterisk (*) may be useful when searching for a string to which you
       know  the  beginning  and  end, but not what characters (if any) or how
       many may be in the middle.  The	first  character  after	 the  asterisk
       should not be a metacharacter (a character with special meaning).

       The  replace  facility uses the same modes as the search facility.  The
       prompt for the replace operation shows the syntax for the input:

	   /string1/string2/

       where the slash ('/') may be replaced by any character that is  not  in
       the  search  or	replacement string, and "string1" is to be replaced by
       "string2".  When in noliteral mode, the search string may be placed  in
       the replacement string by using the ampersand ('&'), like so:

	   /old/abc&123/

       Where "old" will be inserted between "abc" and "123".

   Recovery
       If  for	some  reason an edit session is interrupted, it is possible to
       recover the work done in the session.  This  is	accomplished  via  the
       information  stored  in	the  journal  file,  which  is a record of the
       changes made to the text in the buffer while in the editor.  To recover
       a session in which a file named foo was being edited, use the command:

	      aee -r foo

       This  is	 only  possible	 if  the  -j option was not used, since the -j
       option turns journaling off.

       It is also possible to start aee with no arguments, and then to	browse
       the journal files.  This is accomplished through the menus.  To perform
       this task, bring up the menu by pressing the Esc key, select file oper‐
       ations, then select recover from journal.  You should then be presented
       with a list of files to recover.

   Key Definitions
       The function keys and control sequences (alphabetic keys	 pressed  with
       the control key) may be defined by the user to perform any of the func‐
       tions described below.

       The user may assign more than one function to each key, as long as each
       one  is	separated  by one or more spaces.  The following describes the
       functions of the keys and how the user may redefine the keyboard during
       the  edit  session on the command line.	The same syntax is used in the
       initialization file.

       Note that the '^' is typed by the user in the following	examples,  and
       is not generated by pressing the control key and letter, and that f2 is
       entered by typing an 'f' and then a '2'.

       Examples:

		    define ^b dl

       will define the key control b to have the function delete line.

		    define gold ^b udl

       assigns the function undelete line to GOLD control b.

		    define f2 /this is an inserted string/ cr

       will cause the string between the delimiters (/) to  be	inserted  fol‐
       lowed by a carriage-return whenever the function key f2 is pressed.

       If  you	wish  to  have	a  key that deletes to the end of line without
       appending the next line to the end, you may make the following key def‐
       inition:

		    define f3 dl cr left

       This  set  of  functions	 will delete to the end of line and append the
       next to the end of the line, then insert a line at the cursor, and then
       move  the  cursor  back	to  the end of the previous line, the position
       where you started.  This may of course be assigned to any valid key.

   Symbols
       The following symbols, as well as the commands noted by (‡) in the list
       of commands may be assigned to keys using the define command.

	   Symbol   Description
	   ─────────────────────────────────────────────
	   menu	    pop up menu
	   dl	    delete line
	   dc	    delete character
	   dw	    delete word
	   und	    undelete  last thing deleted, keeps
		    last 128 things deleted
	   udl	    undelete line
	   udc	    undelete character
	   udw	    undelete word
	   eol	    end of line
	   bol	    begin of line
	   bot	    begin of text
	   eot	    end of text
	   np	    next page
	   pp	    previous page
	   nb	    next buffer
	   pb	    previous buffer
	   gold	    gold
	   il	    insert line
	   psrch    search prompt
	   srch	    search
	   prp	    replace prompt
	   rp	    replace
	   fwd	    forward (search forward of cursor)
	   rev	    reverse (search before cursor)
	   al	    advance line
	   aw	    advance word

	   pw	    previous word
	   format   format paragraph
	   mark	    mark text
	   prefix   mark text and place before existing
		    text in paste buffer
	   append   mark  text and place after existing
		    text in paste buffer
	   cut	    cut marked text
	   copy	    copy marked text
	   pst	    paste previously cut or copied text
	   unmark   unmark text, doesn't affect	 previ‐
		    ous paste buffer contents
	   ac	    ascii character
	   mc	    match (), {}, [], or <>
	   cmd	    command
	   up	    up arrow
	   down	    down arrow
	   left	    left arrow
	   right    right arrow
	   rd	    redraw screen
	   bck	    backspace
	   cr	    carriage return
	   /,.	    the	 first non-alpha character will
		    act as a  separator	 to  allow  for
		    single  line  text	insertion,  the
		    second occurrence of the same char‐
		    acter will end the insertion

   Initializing aee From A File
       aee  checks  for a file named init.ae in /usr/local/share/aee, .init.ae
       in the user's home directory, then for .init.ae in the  current	direc‐
       tory.   (This  file  may be created manually or by using the menu entry
       'save editor config' in the 'settings' menu.)  If the file  exists,  it
       is  read	 and initializes aee to the parameters as defined in the file.
       By having initialization files in multiple places, the user may specify
       settings	 for  global use, and then supplement these with customization
       for the local directory.	 The parameters allowed in  the	 init.ae  file
       are  key	 definitions, turning off windowing, case sensitivity, literal
       searching, eight bit characters, as well as the ability to echo strings
       to  the	terminal (see the Commands section for the commands allowed in
       the initialization file).  An example follows:

		    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

       The above example assigns the command replace to control-z, and replace
       prompt to gold control-z, as well as setting aee to be sensitive to the
       case of characters during search and replacement operations.   It  also
       defines	the  function keys f3 and f4 to be undelete and unmark respec‐
       tively.	The print command will send its output to the  device  'laser'
       through	the UNIX command lp.  A string is echoed to the terminal which
       will "turn on" the user function keys on an HP terminal.

       The user may wish to echo strings to the terminal when starting aee  to
       set up the terminal or other devices, so the echo facility is provided.
       Echo is applicable only 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 -e option on the	invok‐
       ing  command  line turns off the echo 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
       echoed.

       Operations allowed in the initialization file are noted in the list  of
       commands with an asterisk (*).

   Shell Escapes
       Sometimes it is desirable to execute shell commands outside of the edi‐
       tor.  This may be accomplished by pressing a key assigned to  the  com‐
       mand  function  (^E, or gold F8), 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:

		    <inbuff >outbuff !command

       where  inbuff is the name of the buffer to receive the data and outbuff
       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
       UNIX  command  sort.   If  you wished to view them while in the current
       edit session, you could use the following sequence:

		    <sorted >list !sort

       where list is the name of the  buffer  containing  the  unsorted	 list,
       sorted  is  the name of the buffer to contain the sorted list, and sort
       is the name of the UNIX 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 com‐
       mand  is entered, it will be created.  You should be sure of the spell‐
       ing of the name of the buffer to be the input of the command if you are
       specifying one.

   PRINT Command
       The print command allows you to send the contents of the current buffer
       to a command specified by using the printcommand operation in the  ini‐
       tialization file.  The default is 'lp', using the default device.

       If  you choose to specify something other than the default command, the
       command should be able to take its input from stdin, since aee will set
       up a pipe to feed the information to the command.

   Paragraph Formatting
       Paragraphs are defined for aee by a block of text bounded by:

	       ·      Begin or end of file.

	       ·      Line with no characters, or only spaces and/or tabs.

	       ·      Line starting with a period ('.') or right angle bracket
		      ('>').

       A paragraph may be formatted two ways:  explicitly by choosing the for‐
       mat  paragraph  menu  item,  or	by setting aee to automatically format
       paragraphs.  The automatic mode may be set via a menu, or via the  ini‐
       tialization file.

       There  are three states for text operation in aee: free-form, wrap, and
       automatic formatting.

       "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.

       "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 settings menu, the default is for the right margin to be the	 right
       edge  of	 the terminal).	 This is the mode that allows the format para‐
       graph menu item to work.	 The "observe margins" entry in the "settings"
       menu  allows  the  user to toggle this state, as well as the margin and
       nomargin commands (see Commands above).

       "Automatic formatting" provides word-processor-like behavior.  The user
       may  type  in  text, while aee 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	 "set‐
       tings"  menu  allows the user to toggle this state, as well as the com‐
       mands autoformat and noautoformat.

   Modes
       Although aee 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:

	   tabs to spaces
		  Tabs may be inserted as a single tab character, or  replaced
		  with spaces.

	   case sensitive search
		  The  search operation can be sensitive to whether characters
		  are upper- or lower-case, or ignore case completely.

	   literal search
		  Allows the user to specify whether regular  expressions  are
		  to be used for searching or not.

	   observe margins
		  The left and right margins can be observed, or not.

	   info window
		  A  window  showing  the keyboard operations that can be per‐
		  formed can be displayed or not.

	   status line
		  Display the file name, position in the  file,	 and  selected
		  status indicators.

	   auto indent
		  The  editor  can  be	set  to automatically indent the newly
		  inserted line the same as the previous line, or not (primar‐
		  ily useful for programming).

	   overstrike
		  Toggle text insertion or overstrike modes.

	   auto paragraph formatting
		  While	 typing in text, the editor can try to keep it looking
		  reasonably well within the width of the screen.

	   multi windows
		  Allow multiple buffers to be displayed at the same time,  or
		  only a single buffer at a time.

	   info window height
		  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.

	   save editor config
		  Used to save the current editor configuration to a file (see
		  the section Initializing aee from a file).  In  addition  to
		  the settings within the settings menu, tabs and key mappings
		  are saved.

       You may set these modes via the initialization file (see above), with a
       menu (see Menu above), or via commands (see Commands above).

   Mark, Cut, Copy, and Paste
       To  move large chunks of text around, use the control key commands mark
       (^U or f6), cut (^X or f7), and paste (gold ^V or gold f7).  These com‐
       mands  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  men‐
       tioned  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  buf‐
       fer,  you  may  move  your cursor wherever you wish and insert the text
       there, as many times you wish, anywhere you want.

       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 mark (^U or
       f6).  Move the cursor over the text you wish to place in the paste buf‐
       fer.   The  text	 between  the cursor position at which you pressed the
       mark 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 cut (^X or f7) or copy (^C or  gold  f6).   The	cut  operation
       deletes	the  text  from the buffer in which the text is contained, and
       the copy operation simply places the text in the paste  buffer  without
       deleting	 it.   Now  you	 may move to another section and use the paste
       function to insert it as many times as you wish.

       If you wish to copy several sections of text that are not  adjacent  to
       each  other,  you may use the append function (gold ^B) to put the text
       you will mark at the end of the current paste buffer contents,  or  the
       prefix  function	 (gold	^D)  to place the newly marked text before the
       current paste buffer contents when you copy or  cut.   The  prefix  and
       append functions are used in place of the mark function.

       Sometimes  you may start marking text, then decide to cancel the opera‐
       tion.  It is possible to do that by using the  unmark  operation.   The
       unmark operation is not assigned to any key by default.

   Buffer Operations
       aee  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 main.	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 nowindows.	To return to the default  con‐
       dition,	enter  the  command  windows, 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.  aee will remind
       you that you have buffers if you attempt to leave  the  editor  without
       deleting them.

       Buffers	are  created  when  you enter the command buffer 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 nb (gold ^N)
       and pb (gold ^P), short for next buffer and previous buffer.   This  is
       especially  useful if you mistype or forget the name of any of the buf‐
       fers you have created and have windowing turned off.

       The command buffer without any arguments displays the name of the  cur‐
       rent buffer.

       Buffers can be deleted by using the command delete.  Simply move to the
       buffer to be deleted and use the command delete.	 You cannot delete the
       first  buffer, called main.  Note that all commands operate in the buf‐
       fer in which your cursor is operating, so you may  use  the  write  and
       read commands to save or read a file into the current buffer.

On-Line Help
       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  /usr/local/share/aee/help.ae, but this file may be located
       in the user's home directory with the name .help.ae, or in the  current
       directory with the name help.ae.

WARNINGS
       A journal file will not be created if the user does not have write per‐
       mission to the directory in which the file is to reside.

       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, aee will exit with an
       error without editing the file.

       The automatic paragraph formatting operation may be too slow for slower
       systems.

       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.

CAVEATS
       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 PUR‐
       POSE.  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	 soft‐
       ware  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.

       Always make a copy of files that cannot	be  easily  reproduced	before
       editing.	 Save files early, and save often.

FILES
       /usr/local/share/aee/init.ae
       $HOME/.aeeinfo
       $HOME/.init.ae
       .init.ae

AUTHOR
       The software aee and xae was developed by Hugh Mahon.

       This  software and documentation contains proprietary information which
       is protected by copyright.  All rights are reserved.

       Copyright (c) 1986, 1987, 1988, 1991, 1992,  1993,  1994,  1995,	 1996,
       1997, 1998, 1999, 2002 portions Hugh Mahon and portions Hewlett-Packard
       Company.

									aee(1)
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net