1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
|
<html><head>
<title>Elvis 2.1 Documentation</title>
</head><body>
<h1><a name="CONTENTS"></a>TABLE OF CONTENTS</h1>
<menu>
<li><a href="#WHATIS"> 1. What is elvis?</a>
<li><a href="elvisvi.html"> 2. Visual command mode</a>
<li><a href="elvisvi.html#GROUP"> 2.2 VI commands, grouped by function</a>
<li><a href="elvisvi.html#INDEX"> 2.3 VI commands, listed in ASCII order</a>
<li><a href="elvisinp.html"> 3. Input mode</a>
<li><a href="elvisex.html"> 4. EX command mode</a>
<li><a href="elvisex.html#GROUP"> 4.3 EX commands, grouped by function</a>
<li><a href="elvisex.html#INDEX"> 4.4 EX commands, listed alphabetically</a>
<li><a href="elvisre.html"> 5. Regular expressions</a> (searches and substitutions)
<li><a href="elvisopt.html"> 6. Options</a>
<li><a href="elvisopt.html#GROUP"> 6.1 Options, grouped by function</a>
<li><a href="elvisopt.html#INDEX"> 6.2 Options, listed alphabetically</a>
<li><a href="elvisdm.html"> 7. Display modes</a>
<li><a href="elvisgui.html"> 8. User interfaces</a>
<li><a href="elvisos.html"> 9. Operating systems</a>
<li><a href="elvisses.html"> 10. Sessions, initialization, and recovery</a>
<li><a href="elviscut.html"> 11. Cut buffers</a>
<li><a href="elvismsg.html"> 12. Messages</a>
<li><a href="elvisexp.html"> 13. Arithmetic expressions</a> (arithmetic, tests, and functions)
<li><a href="elvistag.html"> 14. Tags</a>
<li><a href="elvisnet.html"> 15. The Internet</a>
<li><a href="elvistip.html"> 16. Tips</a>
<li><a href="elvistrs.msg"> A. List of terse messages</a>
<li><a href="elvisqr.html"> B. Quick Reference</a>
<li><a href="elvis.man"> elvis(1) Man-page for elvis</a>
<li><a href="ctags.man"> ctags(1) Man-page for ctags</a>
<li><a href="ref.man"> ref(1) Man-page for ref</a>
<li><a href="fmt.man"> fmt(1) Man-page for fmt</a>
</menu>
<p><strong>HINT:</strong> If you're reading this via elvis' built-in
<a href="elvisex.html#help">:help</a>
command, then you should probably begin by reading about
<a href="elvisex.html#help">:help</a>
itself. To do that, move the cursor onto the word
"<a href="elvisex.html#help">:help</a>"
and press the <kbd>Enter</kbd> key.
<pre graphic>
.--------------------------------------------------------------.
| Copyright © 1995 by Steve Kirkendall. Permission is granted |
| to use and distribute this software in either source code |
| form, or executable form. This software is provided with no |
| warranty of any kind. The author is not liable for any |
| consequences arising from the use of this software. |
^--------------------------------------------------------------^
</pre>
<p>You can contact the author via e-mail at <em>kirkenda@cs.pdx.edu,</em>
or via postal mail at:
<blockquote><em>
Steve Kirkendall<br>
1500 SW Park Avenue, #326<br>
Portland OR 97201<br>
USA
</em> </blockquote>
<h1><a name="WHATIS"></a>1. WHAT IS ELVIS?</h1>
Elvis is a clone of vi/ex, the standard UNIX editor.
Elvis supports nearly all of the vi/ex commands,
in both visual mode and ex mode.
Elvis adds support for multiple files, multiple windows, a variety of
display modes, on-line help, and other miscellaneous extensions.
<p>Like vi/ex, Elvis stores most of the text in a temporary file,
instead of RAM.
This allows it to edit files that are too large to fit
in a single process' data space.
Also, the edit buffer can survive a power failure or crash.
<p>Elvis 2.1 runs under the following operating systems:
<ul>
<li>UNIX. If you have X-windows, elvis can use a graphical interface, in addition to the traditional text-based interface.
<li>MS-Windows/95 and Windows/NT. Both a console (text-based)
and a graphical version are available.
<li>MS-DOS. It can also run in a DOS window under Windows 3.1.
<li>OS/2. For now only a text-mode version is available. A graphical
interface is planned, though.
</ul>
<p>Elvis is freely redistributable, in either source form or executable form.
There are no restrictions on how you may use it.
<h2>1.1 About this manual</h2>
This document is written in HTML.
You should be able to view it with any Web browser, such as Mosaic or Netscape.
These browsers also allow you to print the manual, if you prefer.
<p>You can also use elvis to view it or print it;
elvis has a built-in HTML display mode.
To print this document using elvis, you must first set some
<a href="elvisopt.html#LPR">printer options.</a>
After that, you can just load any of these files,
maybe set the display mode to HTML via the command ":display html"
(if elvis doesn't set the display mode automatically),
and then give the command ":lp".
<p>Each chapter is stored in a separate file;
you'll need to print each one separately.
A shell script/batch file named <a href="printdoc.bat">printdoc.bat</a>
is provided to help you do this.
<h2>1.2 Overview of Elvis</h2>
The user interface of Elvis/vi/ex is weird.
There are two major command modes in Elvis, and a few text input modes as well.
Each command mode has a command which allows you to switch to the other mode.
<p> You will probably use the <a href="elvisvi.html">visual command mode</a>
most of the time.
This is the mode that Elvis normally starts up in.
<p> In visual command mode, the entire screen is filled with lines of text
from your file.
Each keystroke is interpreted as part of a visual command.
If you start typing text, it will <em>not</em> be inserted,
it will be treated as part of a command.
To insert text, you must first give an "insert text" command, such as
<a href="elvisvi.html#i">i</a>.
This will take some getting used to.
(An alternative exists.
Look up the <a href="elvisopt.html#initialstate">initialstate</a> option.)
<p> The <a href="elvisex.html">ex mode</a> is quite different.
Elvis displays a ":" character on the bottom line of the screen, as a prompt.
You are then expected to type in a command line and hit the <b>Enter</b> key.
The set of commands recognized in the ex mode is different from visual mode's.
<h2>1.3 Special features of Elvis</h2>
Compared to the traditional ex/vi, elvis supports the following
major new features:
<dl>
<dt>Multiple edit buffers
<dd>You can edit several file at the same time.
The <a href="elvisex.html#buffer">:buffer</a> lists the current edit buffers.
You can switch to a different buffer by typing
<a href="elvisex.html#OPEN">:(<var>buffer</var></a>.
<dt>Multiple windows
<dd>The <a href="elvisex.html#split">:split</a> ex command or
<a href="elvisvi.html#^Ws">^Ws</a> visual command will create a new window
showing the same edit buffer or a different buffer. Related commands
allow you to do things like search for a tag and display it in a new window,
or move among windows.
<dt>Multiple user interfaces
<dd>In addition to the traditional <a href="elvisgui.html#termcap">termcap</a>
user interface, elvis also supports graphical interfaces for
<a href="elvisgui.html#x11">X11</a> and
<a href="elvisgui.html#windows">Windows95</a>, plus some other
stripped-down interfaces.
<dt>A variety of display modes
<dd>The <a href="elvisex.html#display">:display</a> command lists the
available display modes, and can set the display to a particular mode.
The <a href="elvisvi.html#^Wd">^Wd</a> visual command toggles between
display modes.
<dt>Online help
<dd>This uses elvis' built-in "html" display mode to display the manual,
which uses multiple fonts and hypertext links to improve readability.
To access it, give the command <a href="elvisex.html#help">:help</a>.
(But you already figured that out, didn't you?)
<dt>Highly configurable
<dd>Elvis has a set of configuration scripts, each of which is run at a
specific time. For example, <a href="elvisses.html#elvis.ini">elvis.ini</a>
is run when elvis starts up, and <a href="elvisses.html#elvis.arf">elvis.arf</a>
is run after reading a file. See the chapter on
<a href="elvisses.html">sessions</a> for a discussion of these.
<p>There is also an <a href="elvismsg.html#elvis.msg">elvis.msg</a> file which
can be used to translate the built-in messages into another language.
<p>The <a href="elvisgui.html#x11.toolbar">X11 interface</a> has a fully
configurable toolbar.
<p>The <a href="elvisdm.html#elvis.syn">elvis.syn</a> file contains descriptions
of various languages, for use with the
<a href="elvisdm.html#syntax">syntax-coloring</a> display mode.
<dt>Enhanced tags
<dd>The tags feature has been extended to support overloaded tags,
which C++ tends to use a lot. See the <a href="elvistag.html">tags</a>
chapter.
<dt>Macro debugger
<dd>To help you develop keyboard macros (and also report incompatibilities
between elvis and vi), elvis has a built-in macro debugger. The the article
in the <a href="elvistip.html#DEBUG">Tips</a> chapter.
<dt>Network support
<dd>Elvis can read via the <strong>http</strong> protocol, and read/write
via the <strong>ftp</strong> protocol.
See the <a href="elvisnet.html">Internet</a> chapter.
<dt>Aliases
<dd>You can construct csh-style aliases for the ex commands, via the
<a href="elvisex.html#alias">:alias</a> command.
See the article in the <a href="elvistip.html#ALIAS">Tips</a> chapter.
<dt>New options
<dd>Elvis has nearly 200 different options. See the
<a href="elvisopt.html">Options</a> chapter for a list.
<dt>Built-in calculator
<dd>Elvis has a <a href="elvisex.html#calculate">:calc</a> command which
evaluates C-like expressions. These expressions are also used for some
other commands, such as <a href="elvisex.html#if">:if</a> and
<a href="elvisex.html#eval">:eval</a>, among other things.
See the <a href="elvisexp.html">Arithmetic expressions</a> chapter.
</dl>
</body></html>
|
