


ELVIS(1)						 ELVIS(1)


NNAAMMEE
       elvis, ex, vi, view, input - The editor

SSYYNNOOPPSSIISS
       eellvviiss [_f_l_a_g_s] [++_c_m_d] [_f_i_l_e_s...]

DDEESSCCRRIIPPTTIIOONN
       _E_l_v_i_s is a text editor which emulates _v_i/_e_x.

       On  systems  which  pass	the program name as an argument,
       such as Unix and Minix, you may also install  _e_l_v_i_s  under
       the  names  "ex",  "vi", "view", and "input".  These extra
       names would normally be links to elvis; see the "ln" shell
       command.

       When  _e_l_v_i_s  is	invoked	as  "vi",  it behaves exactly as
       though it was invoked as "elvis".  However, if you  invoke
       _e_l_v_i_s as "view", then the readonly option is set as though
       you had given it the "-R" flag.	If you	invoke	_e_l_v_i_s  as
       "ex",  then  _e_l_v_i_s will start up in the colon command mode
       instead of the visual command  mode,  as	though	you  had
       given it the "-e" flag.	If you invoke _e_l_v_i_s as "input" or
       "edit", then _e_l_v_i_s will start up in input mode, as  though
       the "-i" flag was given.

OOPPTTIIOONNSS
       --rr     To  the  real  vi,  this flag means that a previous
	      edit should be recovered.	_E_l_v_i_s,  though,  has	a
	      separate	program, called _e_l_v_r_e_c_(_1_), for recovering
	      files.  When you invoke _e_l_v_i_s with -r,  _e_l_v_i_s  will
	      tell you to run _e_l_v_r_e_c.

       --RR     This sets the "readonly" option, so you won't acci-
	      dentally overwrite a file.

       --tt _t_a_g This causes _e_l_v_i_s to start  editing  at  the  given
	      tag.

       --mm [_f_i_l_e]
	      _E_l_v_i_s  will  search through _f_i_l_e for something that
	      looks like an error message from	a  compiler.   It
	      will then begin editing the source file that caused
	      the error, with the  cursor  sitting  on	the  line
	      where the error was detected.  If you don't explic-
	      itly name a _f_i_l_e, then "errlist" is assumed.

       --ee     _E_l_v_i_s will start up in colon command mode.

       --vv     _E_l_v_i_s will start up in visual command mode.

       --ii     _E_l_v_i_s will start up in input mode.

       --ww _w_i_n_s_i_z_e
	      Sets the "window" option's value to _w_i_n_s_i_z_e.



								1





ELVIS(1)						 ELVIS(1)


       ++_c_o_m_m_a_n_d or --cc _c_o_m_m_a_n_d
	      If you use the +_c_o_m_m_a_n_d parameter, then  after  the
	      first  file  is loaded _c_o_m_m_a_n_d is executed as an EX
	      command.	A typical example would	be  "elvis  +237
	      foo",  which would cause _e_l_v_i_s to start editing foo
	      and then move directly to line 237.  The	"-c  _c_o_m_-
	      _m_a_n_d"  variant  was added for UNIX SysV compatibil-
	      ity.

FFIILLEESS
       /tmp/elv*
	      During editing, _e_l_v_i_s stores text	in  a	temporary
	      file.   For  UNIX, this file will usually be stored
	      in the /tmp directory, and the first three  charac-
	      ters  will be "elv".  For other systems, the tempo-
	      rary files may be stored someplace  else;	see  the
	      version-specific section of the documentation.

       tags   This  is the database used by the _:_t_a_g_s command and
	      the --tt  option.	It  is	usually	created  by  the
	      _c_t_a_g_s_(_1_) program.

       .exrc or elvis.rc
	      On UNIX-like systems, a file called ".exrc" in your
	      home directory is executed as a series of	_e_x  com-
	      mands.   A file by the same name may be executed in
	      the current directory, too.  On  non-UNIX	systems,
	      ".exrc" is usually an invalid file name; there, the
	      initialization file is called "elvis.rc" instead.

EENNVVIIRROONNMMEENNTT
       TERM   This is the name of your terminal's  entry  in  the
	      termcap  or  terminfo  database.	The list of legal
	      values varies from one system to another.

       TERMCAP
	      Optional.	If your system	uses  termcap,	and  the
	      TERMCAP variable is unset, then
	       will   read   your   terminal's	definition  from
	      //eettcc//tteerrmmccaapp.  If TERMCAP is set to the full  path-
	      name  of	a  file	(starting with a '/') then  will
	      look in the named file instead of //eettcc//tteerrmmccaapp.  If
	      TERMCAP  is set to a value which doesn't start with
	      a '/', then its value is assumed	to  be	the  full
	      termcap entry for your terminal.

       TERMINFO
	      Optional.	If  your  system uses terminfo, and the
	      TERMINFO variable is unset, then
	       will read  your	terminal's  definition	from  the
	      database	in  the	//uussrr//lliibb//tteerrmmiinnffoo  database.  If
	      TERMINFO is set, then its	value	is  used  as  the
	      database	name to use instead of //uussrr//lliibb//tteerrmmiinnffoo.




								2





ELVIS(1)						 ELVIS(1)


       LINES, COLUMNS
	      Optional.	These variables, if set,  will	override
	      the   screen   size   values  given  in  the  term-
	      cap/terminfo for your terminal.  On windowing  sys-
	      tems  such as X,	has other ways of determining the
	      screen size, so you  should  probably  leave  these
	      variables unset.

       EXINIT Optional.	This variable can hold EX commands which
	      will be executed before any .exrc files.

       SHELL  Optional.	The  SHELL  variable  sets  the  default
	      value  for  the  "shell"	option,	which determines
	      which shell program is  used  to	perform	wildcard
	      expansion	in file names, and also which is used to
	      execute filters or external programs.  The  default
	      value on UNIX systems is "/bin/sh".

	      Note: Under MS-DOS, this variable is called COMSPEC
	      instead of SHELL.

       HOME   This variable should be set to  the  name	of  your
	      home directory.
	       looks  for  its initialization file there; if HOME
	      is unset then the initialization file will  not  be
	      executed.

       TAGPATH
	      Optional.	This variable is used by the "ref" pro-
	      gram, which is invoked by the  shift-K,  control-],
	      and :tag commands.  See "ref" for more information.

       TMP, TEMP
	      These optional environment variables are only  used
	      in non-UNIX versions of .	They allow you to supply
	      a directory name to be used for  storing	temporary
	      files.

SSEEEE AALLSSOO
       ctags(1), ref(1), virec(1)

       _E_l_v_i_s  _-	_A  _C_l_o_n_e _o_f _V_i_/_E_x, the complete _e_l_v_i_s documenta-
       tion.

BBUUGGSS
       There is no LISP	support.   Certain  other  features  are
       missing, too.

       Auto-indent mode is not quite compatible with the real vi.
       Among other things, 0^D and ^^D don't do	what  you  might
       expect.

       Long  lines  are displayed differently.	The real vi wraps
       long lines onto multiple rows of	the  screen,  but  _e_l_v_i_s



								3





ELVIS(1)						 ELVIS(1)


       scrolls sideways.

AAUUTTHHOORR
       Steve Kirkendall
       kirkenda@cs.pdx.edu

       Many  other  people  have  worked to port _e_l_v_i_s to various
       operating systems.  To see who deserves	credit,	run  the
       _:_v_e_r_s_i_o_n command from within _e_l_v_i_s, or look in the system-
       specific section of the complete documentation.















































								4


