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
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
|
Elvis 1.4 VERSIONS Page 12-1
E12. VERSIONSF
Elvis currently works under BSD UNIX, AT&T System-V UNIX, SCO
XENIX, Minix, Coherent, MS-DOS, Atari TOS, and OS9/68k. This
section of the manual provides special information that applies to
each particular version of Elvis.
For all versions except MS-DOS, the file "Makefile.mix" should
be copied to "Makefile", and then edited to select the correct set
of options for your system. There is more information about this
embedded in the file itself.
E12.1 BSD UNIXF
Temporary files are stored in /tmp.
Elvis doesn't have an "expreserve" program yet. Instead, you
should modify /etc/rc so that the temp files are not deleted when
the system is rebooted. Find a line in /etc/rc which reads
rm -rf /tmp/*
or something like that, and change it to read
rm -rf /tmp/[^e]* /tmp/e[^l]* /tmp/el[^v]* /tmp/elv_*
If you do not have permission to modify /etc/rc, don't fret.
The above modification is only needed to allow you to recover your
changes after a system crash. You can still run Elvis without that
modification, and you can still recover your changes when Elvis
crashes or when your dialup modem looses the carrier signal, or
something like that. A system crash is the only thing that could
hurt you.
Both Elvis and the real Vi read initialization commands from a
file called ".exrc", but the commands in that file might work on
one but not the other. For example, "set keywordprg=man" will work
for Elvis, but Vi will complain because it doesn't have a
"keywordprg" option. If the warning messages annoy you, then you
can edit the config.h file to change the name of the initialization
file ".exrc" to something else, such as ".elvisrc".
If you use X windows, you may wish to add "-DCS_LATIN1" to
CFLAGS. This will cause the digraph table and the flipcase option
to have default values that are appropriate for the LATIN-1
character set. That's the standard character set for X.
E12.2 System-V UNIXF
If your system uses terminfo instead of termcap, then you will
have to edit the LIBS setting in the Makefile. Currently it says
"LIBS=-ltermcap", but you may have to change it to
"LIBS=-lterminfo" or "LIBS=-lterm" or something like that.
Elvis 1.4 VERSIONS Page 12-2
The /etc/rc file should be modified as described for BSD
systems, above. The potential trouble with ".exrc" described above
for BSD UNIX applies to System-V UNIX as well.
Elvis uses control-C as the interrupt key, not Delete.
E12.3 SCO XenixF
For Xenix-386, you can use the generic System-V settings. You
may wish to add "-DCS_IBMPC" to CFLAGS, to have the digraph table
and flipcase option start up in a mode that is appropriate for the
console.
There is a separate group of settings for use with Xenix-286. It
already has "-DCS_IBMPC" in CFLAGS.
Because Xenix is so similar to System-V, everything I said
earlier about System-V applies to the Xenix version too.
E12.4 MinixF
There are separate settings in Makefile.mix for Minix-PC and
Minix-ST. The differences between these two are that the ST
version uses ".o" for the object file extension where the PC
version uses ".s", and the PC version has some extra flags in
CFLAGS to reduce the size of Elvis. The PC version also uses
tinytcap (instead of the full termcap) to make it smaller.
Minix-PC users should read the CFLAGS section of this manual
very carefully. You have some choices to make...
The temporary files are stored in /usr/tmp. The /usr/tmp
directory must exist before you run Elvis, and it must be
readable/writable by everybody. We use /usr/tmp instead of /tmp
because after a system crash or power failure, you can recover the
altered version of a file from the temporary file in /usr/tmp. If
it was stored in /tmp, though, then it would be lost because /tmp
is probably located on the RAM disk.
Elvis uses control-C as the interrupt key, not Delete.
E12.5 CoherentF
Elvis was ported to Coherent by Esa Ahola.
Elvis is too large to run under Coherent unless you eliminate
some features via the CFLAGS setting. The recommended settings, in
Makefile.mix, produce a working version of elvis which emulates Vi
faithfully, but lacks most of the extensions. You should read the
CFLAGS section of this manual carefully.
You can probably reduce the size of Elvis by using tinytcap.c
instead of -lterm. This would allow you to keep most features of
Elvis, at the expense of terminal independence. (Tinytcap.c has
ANSI escape sequences hard-coded into it.) To use tinytcap, just
add "tinytcap.o" to the "EXTRA=" line in the Makefile, and remove
Elvis 1.4 VERSIONS Page 12-3
"-lterm" from the "LIBS=" line.
The temporary files are stored in /tmp. You should modify your
/etc/rc file as described for BSD earlier.
E12.6 MS-DOSF
Elvis was ported to MS-DOS by Guntram Blohm and Martin Patzel.
Dave Lord also deserves a big "thank you" for exploring a
compatibility glitch between DOS 4.01 and Elvis.
Ideally, Elvis should be compiled with Microsoft C 5.1 and the
standard Microsoft Make utility, via the command "make elvis.mak".
This will compile Elvis and all related utilities.
If you have Turbo-C, then you can 4almost5 use the "Elvis.prj"
file to compile Elvis. EYou must explicitly force Turbo-C to
compile it with the "medium" memoryF Emodel, and you must increase
the stack size to 16k.F Most of the related programs (ctags, ref,
virec, refont, and wildcard) are only one file long, so you should
have no trouble compiling them. The "alias.c" file is meant to be
compiled once into an executable named "ex.exe". You should then
copy "ex.exe" to "vi.exe", and "view.exe".
Elvis stores its temporary files in C:\tmp. If this is not
satisfactory, then you should edit the CFLAGS line of your Makefile
to change TMPDIR to something else before compiling. You can also
control the name of the temp directory via an environment variable
named TMP or TEMP. The directory must exist before you can run
Elvis.
Normally, the TERM environment variable should not be set, or
else it should be set to "pcbios". This way, Elvis will make calls
to BIOS to update the screen. (If you don't like the colors that
the BIOS interface uses, then edit the attr[] table in pc.c. A
":color" command will be added eventually.)
You may prefer to use a device driver such as ANSI.SYS or
NNANSI.SYS, for speed; or you may NEED to use a device driver for
compatibility. If so, you should install one of these drivers by
adding "driver = ansi.sys" (or whatever) to your CONFIG.SYS file,
and then you should define TERM to be either "ansi" or "nansi" by
adding a line such as "set TERM=ansi" to your AUTOEXEC.BAT file.
You must then reboot for these changes to take effect. After that,
Elvis will notice the "TERM" setting and use the driver.
Under MS-DOS, Elvis has an extra ":set" option called "pcbios"
which indicates whether the BIOS is being used directly. This is a
"read only" option; you can't use it to switch your interface style
in the middle of an edit session.
An extra program, called "wildcard", is needed for MS-DOS. It
expands wildcard characters in file names.
Elvis 1.4 VERSIONS Page 12-4
E12.7 Atari TOSF
Elvis was ported to Atari TOS by Guntram Blohm and Martin
Patzel. It is very similar to the MS-DOS version. It has only
been tested with the Mark Williams C compiler.
The TERM environment variable is ignored; the ST port always
assumes that TERM=vt52. The SHELL (not COMSPEC!) variable should
be set to the name of a line-oriented shell.
A simple shell in included with elvis. Its source is in
"shell.c", and the name of the executable is "shell.ttp". This was
necessary because the standard Atari software doesn't offer any way
to set environment variables. The file "profile.sh" should contain
a set of instructions to be executed when the shell first starts
up. An example of this file is included, but you will almost
certainly want to edit it right away to match your configuration.
If you already have a command-line shell, then you'll probably
want to continue using it. The shell that comes with Elvis is very
limited.
Currently, character attributes cannot be displayed on the
screen. In other words, the "charattr" option doesn't work very
well. Its ironic -- the only system that always has a bitmapped
display is the only system that doesn't support multiple fonts!
E12.8 OS9/68kF
Elvis was ported to OS9/68k by Peter Reinig.
The Makefile is currently configured to install elvis and the
related programs in /dd/usr/cmds If this this is unacceptable, then
you should change the BIN setting to some other directory.
Similarly, it expects the source code to reside in
/dd/usr/src/elvis; the ODIR setting is used to control this.
Temporary files are stored in the /dd/tmp directory. Your
/dd/startup file may need to be modified to prevent it from
deleting Elvis' temporary files.
The program in alias.c is linked repeatedly to produce the "vi",
"view", and "input" aliases for elvis. Sadly, the "ex" alias is
impossible to implement under OS9, because the shell has a built-in
command by that name.
For some purposes, you must give `make' the "-b" option.
Specifically, you need this for "make -b clean" and "make -b
install".
|
