Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
ee(1)									 ee(1)

       ee - easy editor

       ee [-e] [-i] [-h] [+#] [file ...]
       ree [-e]	[-i] [-h] [+#] [file ...]

       The  command  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 ree is the same as ee, but restricted to editing the	 named
       file (no	file operations, or shell escapes are allowed).

       For  ee	to work	properly, the environment variable TERM	must be	set to
       indicate	the type of terminal being  used.   For	 example,  for	an  HP
       700/92  terminal, the TERM variable should be set to "70092".  See your
       System Administrator if you need	more information.

       The following options are available from	the command line:

       -e  Turns off expansion of tab character	to spaces.

       -i  Turns off display of	information window at top of terminal.

       -h  Turns off highlighting of borders of	windows	 and  menus  (improves
	   performance on some terminals).

       +#  Moves the cursor to line '#'	at startup.

   Control keys
       To  do  anything	 other than insert text, the user must use the control
       keys (the Control key, represented by a "^",   pressed  in  conjunction
       with  an	 alphabetic  key, e.g.,	^a) and	function keys available	on the
       keyboard	(such as Next Page, Prev Page, arrow keys, etc.).

       Since not all terminals have function keys, 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 ^u.

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

   EMACS keys mode
       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 settings	menu, or via the initialization	file (see below).  The
       mappings	are as follows:
	      ^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.

   Function Keys
	   Next	Page
		  Move to the next page.

	   Prev	Page
		  Move to the previous page.

	   Delete Char
		  Delete the character the cursor is on.

	   Delete Line
		  Delete from the cursor to the	end of line.

	   Insert line
		  Insert a newline at the cursor position.

	   Arrow keys
		  Move the cursor in the direction indicated.

       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	ESC key.  The same operations, and more	can be
       performed by obtaining the command prompt (^c) and typing in one	of the
       commands	below.

	   !cmd	  Execute cmd in a shell.

	   0-9	  Move to the line indicated.

	   case	  Make searches	case sensitive.

		  Display the ascii value of the character at the cursor.

	   exit	  Save the edited text,	and leave the editor.

	   expand Expand tabs to spaces.

	   file	  Print	the name of the	file.

	   help	  Display help screen.

	   line	  Display the current line number.

	   nocase Make searches	insensitive to case (the default).

		  Don't	expand tab to spaces when the TAB key is pressed.

	   quit	  Leave	the editor without saving changes.

	   read	file
		  Read the named file.

	   write file
		  Write	the text to the	named file.

   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,	or ^u for moving up and	^d for moving down to move  to
       the  desired  items in the menu,	then press return to perform the indi-
       cated task.

       To the left of each menu	item is	a letter, which	if  the	 corresponding
       letter is pressed on the	keyboard selects that menu entry.

       The main	menu in	ee 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.

	   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,  as
		  well	as  send the contents of the editor to a print command
		  (see the section Initializing	ee from	a file).

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

		  Shows	 the  current values of	the operating modes, and right
		  margin.  By pressing return when the cursor is on a particu-
		  lar  item,  the  value  can be changed.  To leave this menu,
		  press	the escape key.	 (See Modes below.)

		  Pops up a menu in which the  user  may  choose  to  enter  a
		  string  to  search  for,  or search for a string already en-

		  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.

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

	       o      Begin or end of file.

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

	       o      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 ee to automatically format para-
       graphs.	 The automatic mode may	be set via a menu, or via the initial-
       ization file.

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

       "Free-form" is best used	for things like	programming.  There are	no re-
       strictions on the length	of lines, and no formatting takes place.

       "Margins" allows	the user to type in text without having	to worry about
       going  beyond the right margin (the right margin	may be set in the set-
       tings menu, the default is for the margin to be the right edge  of  the
       terminal).  This	is the mode that allows	the format paragraph menu item
       to work.

       "Automatic formatting" provides word-processor-like behavior.  The user
       may  type  in  text,  while ee will make	sure the entire	paragraph fits
       within the width	of the terminal	every time the user  inserts  a	 space
       after typing or deleting	text.  Margin observation must also be enabled
       in order	for automatic formatting to occur.

       Although	ee is a	'modeless' editor (it is in text  insertion  mode  all
       the  time),  there  are modes in	some of	the things it does.  These in-

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

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

	   margins observed
		  Lines	can either be truncated	at the right margin, or	extend
		  on forever.

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

	   eightbit characters
		  Toggles whether eight	bit characters are displayed as	 their
		  value	in angle brackets (e.g.	"<220>") or as a character.

	   info	window
		  A  window  showing  the keyboard operations that can be per-
		  formed can be	displayed or not.  Control keys	may  be	 given
		  bindings similar to emacs, or	not.

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

   Spell Checking
       There are two ways to have the spelling in the text  checked  from  ee.
       One  is	by the traditional spell(1) command, the other is with the op-
       tional ispell(1)	command.

       Using spell, the	words that are not recognized will be  placed  at  the
       top  of	the file.  For the ispell option, the file is written to disk,
       then ispell run on the file, and	the file read back in once ispell  has
       completed making	changes	to the file.

   Printing the	contents of the	editor
       The  user  may select a menu item which prints the contents of the edi-
       tor.  ee	pipes the text in the editor to	the command specified  by  the
       initialization  command	printcommand  (see the section Initializing ee
       from a file below).  The	default	is to send the contents	to "lp".

       Whatever	the user assigns to printcommand must take input from standard
       input.  See your	system administrator for more details.

   Shell operations
       Shell  commands	can  be	executed from within ee	by selecting the shell
       command item in the miscellaneous menu, or by  placing  an  exclamation
       mark ("!") before the command to	execute	at the command:	prompt.	 Addi-
       tionally, the user may direct the contents of the edit buffer out to  a
       shell  operation	 (via  a  pipe)	by using the left angle	bracket	(">"),
       followed	by a "!" and the shell command to execute.  The	 output	 of  a
       shell  operation	 can  also be directed into the	edit buffer by using a
       right angle bracket ("<") before	the exclamation	mark.  These can  even
       be  used	together to send output	to a shell operation and read back the
       results into the	editor.	 So, if	the editor contained a list  of	 words
       to  be sorted, they could be sorted by typing the following at the com-
       mand prompt:


       This would send the contents of the editor to be	piped  into  the  sort
       utility and the result would be placed into the edit buffer at the cur-
       rent cursor location.  The old information would	have to	be deleted  by
       the user.

   Initializing	ee from	a file
       Since different users have different preferences, ee allows some	slight
       configurability.	 There are three possible locations for	an initializa-
       tion  file for ee:  the file /usr/share/misc/, the file
       in the user's home directory, or	the file in the  current  di-
       rectory (if different from the home directory).	This allows system ad-
       ministrators to set some	preferences for	the users on a system-wide ba-
       sis  (for  example,  the	print command),	and the	user to	customize set-
       tings for particular directories	(like one for  correspondence,	and  a
       different directory for programming).

       The  file  /usr/share/misc/  is read first, then $HOME/,
       then, with the settings	specified by the most recent file read
       taking precedence.

       The following items may be entered in the initialization	file:

	   case	  Sets searches	to be case sensitive.

	   nocase Sets searches	to be insensitive to case (default).

	   expand Causes ee to expand tabs to spaces (default).

		  Causes ee to insert tabs as a	single character.

	   info	  A  small  information	 window	is displayed at	the top	of the
		  terminal (default).

	   noinfo Turns	off the	display	of the information window.

		  Causes ee to truncate	lines at the  right  margin  when  the
		  cursor  passes  beyond  the  right margin as set by the user
		  while	text is	being inserted (default).

		  Allows lines to extend beyond	the right margin.

		  Causes ee to automatically try to format the	current	 para-
		  graph	while text insertion is	occurring.

		  Turns	off automatic paragraph	formatting (default).

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

		  The  user can	select a value for the right margin (the first
		  column on the	screen is zero).

		  Turns	on highlighting	border of information window and menus

		  Turns	 off  highlighting of border of	information window and

		  Turns	on display of eight bit	characters.

		  Turns	off display of eight bit  characters  (they  are  dis-
		  played  as  their decimal value inside angle brackets, e.g.,

	   emacs  Turns	on emacs key bindings.

		  Turns	off emacs key bindings.

   Save	Editor Configuration
       When using this entry from the settings menu, the user  may  choose  to
       save  the current configuration of the editor (see Initializing ee from
       a file above) to	a file named in the current directory or  the
       user's  home  directory.	  If  a	file named already exists, it
       will be renamed

       POSE.   Neither	Hewlett-Packard	nor Hugh Mahon shall be	liable for er-
       rors 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.

   International Code Set Support
       ee supports single-byte character code sets (eight-bit clean).

       The automatic paragraph formatting operation may	be too slow for	slower


       The software ee was developed by	Hugh Mahon.

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

       Copyright (c) 1990, 1991, 1992, 1993, 1995 Hugh Mahon.

       termcap(5), terminfo(5),	environ(7), spell(1), ispell(1), lp(1)



Want to link to this manual page? Use this URL:

home | help