man/man1/elvis.1

   1 .TH ELVIS 1
   2 .SH NAME
   3 elvis, ex, vi \- The editor
   4 .SH SYNOPSIS
   5 \fBelvis\fP [\fIflags\fP] [\fB+\fP\fIcmd\fP] [\fIfiles\fP...]
   6 .SH DESCRIPTION
   7 \fBElvis\fP is a text editor which emulates \fBvi\fP/\fBex\fP.
   8 .PP
   9 On systems which pass the program name as an argument, such as UNIX and MINIX 3,
  10 you may also install \fBelvis\fP under the names "ex", "vi", "view", and "input".
  11 These extra names would normally be links to elvis;
  12 see the "ln" shell command.
  13 .PP
  14 When \fBelvis\fP is invoked as "vi",
  15 it behaves exactly as though it was invoked as "elvis".
  16 However, if you invoke \fBelvis\fP as "view",
  17 then the readonly option is set as though you had given it the "-R" flag.
  18 If you invoke \fBelvis\fP as "ex",
  19 then \fBelvis\fP will start up in the colon command mode
  20 instead of the visual command mode,
  21 as though you had given it the "-e" flag.
  22 If you invoke \fBelvis\fP as "input" or "edit",
  23 then \fBelvis\fP will start up in input mode,
  24 as though the "-i" flag was given.
  25 .SH OPTIONS
  26 .IP \fB-r\fP
  27 To the real vi, this flag means that a previous edit should be recovered.
  28 \fBElvis\fP, though, has a separate program, called \fIelvrec\fP(1), for recovering
  29 files.
  30 When you invoke \fBelvis\fP with -r, \fBelvis\fP will tell you to run \fBelvrec\fP.
  31 .IP \fB-R\fP
  32 This sets the "readonly" option,
  33 so you won't accidentally overwrite a file.
  34 .IP "\fB-t\fP \fItag\fP"
  35 This causes \fBelvis\fP to start editing at the given tag.
  36 .IP "\fB-m\fP [\fIfile\fP]"
  37 \fBElvis\fP will search through \fIfile\fP for something that looks like
  38 an error message from a compiler.
  39 It will then begin editing the source file that caused the error,
  40 with the cursor sitting on the line where the error was detected.
  41 If you don't explicitly name a \fIfile\fP, then "errlist" is assumed.
  42 .IP \fB-e\fP
  43 \fBElvis\fP will start up in colon command mode.
  44 .IP \fB-v\fP
  45 \fBElvis\fP will start up in visual command mode.
  46 .IP \fB-i\fP
  47 \fBElvis\fP will start up in input mode.
  48 .IP "\fB-w\fR \fIwinsize\fR"
  49 Sets the "window" option's value to \fIwinsize\fR.
  50 .IP "\fB+\fP\fIcommand\fP or \fB-c\fP \fIcommand\fP"
  51 If you use the +\fIcommand\fP parameter,
  52 then after the first file is loaded
  53 \fIcommand\fP is executed as an EX command.
  54 A typical example would be "elvis +237 foo",
  55 which would cause \fBelvis\fP to start editing foo and
  56 then move directly to line 237.
  57 The "-c \fIcommand\fP" variant was added for UNIX SysV compatibility.
  58 .SH FILES
  59 .IP /tmp/elv*
  60 During editing,
  61 \fBelvis\fP stores text in a temporary file.
  62 For UNIX, this file will usually be stored in the /tmp directory,
  63 and the first three characters will be "elv".
  64 For other systems, the temporary files may be stored someplace else;
  65 see the version-specific section of the documentation.
  66 .IP tags
  67 This is the database used by the \fB:tags\fP command and the \fB-t\fP option.
  68 It is usually created by the \fBctags\fP(1) program.
  69 .IP ".exrc or elvis.rc"
  70 On UNIX-like systems, a file called ".exrc" in your home directory
  71 is executed as a series of \fBex\fR commands.
  72 A file by the same name may be executed in the current directory, too.
  73 On non-UNIX systems, ".exrc" is usually an invalid file name;
  74 there, the initialization file is called "elvis.rc" instead.
  75 .SH "SEE ALSO"
  76 .BR ctags (1),
  77 .BR ref (1),
  78 .BR elvrec (1),
  79 .BR elvis (9).
  80 .PP
  81 \fIElvis - A Clone of Vi/Ex\fP, the complete \fBelvis\fP documentation.
  82 .SH BUGS
  83 There is no LISP support.
  84 Certain other features are missing, too.
  85 .PP
  86 Auto-indent mode is not quite compatible with the real vi.
  87 Among other things, 0^D and ^^D don't do what you might expect.
  88 .PP
  89 Long lines are displayed differently.
  90 The real vi wraps long lines onto multiple rows of the screen,
  91 but \fBelvis\fP scrolls sideways.
  92 .SH AUTHOR
  93 .nf
  94 Steve Kirkendall
  95 kirkenda@cs.pdx.edu
  96 .fi
  97 .PP
  98 Many other people have worked to port \fBelvis\fP to various operating systems.
  99 To see who deserves credit, run the \fB:version\fP command from within \fBelvis\fP,
 100 or look in the system-specific section of the complete documentation.
 101 .\" ref to virec chnaged to elvrec -- ASW 2004-12-13