1
- HOW TO COMPILE & INSTALL ELVIS 2.1_4
1
+ HOW TO COMPILE & INSTALL ELVIS 2.2
2
2
3
3
Separate sets of instructions are provided below for UNIX, Windows-NT,
4
4
MS-DOS, and OS/2.
@@ -10,25 +10,22 @@ development environment if you prefer. Separate instructions are given
10
10
for both compilation methods, for both operating systems.
11
11
12
12
All of these instructions assume that you have already unpacked the files
13
- from the source code archive, "elvis-2.1_4 .tar.gz". That's a gzipped tar
13
+ from the source code archive, "elvis-2.2* .tar.gz". That's a gzipped tar
14
14
archive. If you don't have the gzip and tar utilities, then the easiest
15
15
way for you to unpack them is to compile the "untar.c" program (available
16
16
via anonymous FTP from ftp://ftp.cs.pdx.edu/pub/elvis/untar.c). The files
17
- will be placed in a subdirectory named "elvis-2.1_4 ". The MS-DOS *.MAK files
17
+ will be placed in a subdirectory named "elvis-2.2* ". The MS-DOS *.MAK files
18
18
assume that you've unpacked them while in C:\MSVC, so the files themselves
19
- should end up in C:\MSVC\elvis-2.1_4 .
19
+ should end up in C:\MSVC\elvis-2.2* .
20
20
21
21
Under MS-DOS, the name of the archive will be mangled. It will probably
22
22
be "elvis-~1.gz", but it may be something else; the exact name depends on
23
23
how you downloaded it, and whether you already had an old version of that
24
24
archive in the same directory. The MS-DOS version of the "untar" program
25
25
needs to be passed the mangled name, whatever that turns out to be. The
26
- Win32 version, on the other hand, can handle the full "elvis-2.1_4 .tar.gz"
26
+ Win32 version, on the other hand, can handle the full "elvis-2.2* .tar.gz"
27
27
file name.
28
28
29
- Also under MS-DOS, you may see complaints about some OS/2 files. You can
30
- ignore that; you don't need those files to compile elvis for MS-DOS.
31
-
32
29
================================================================================
33
30
34
31
UNIX
77
74
--bindir=directory
78
75
This value is incorporated into the Makefile. The
79
76
command "make install" will copy the executables into
80
- this directory. The default is /usr/local/ bin.
77
+ this directory. The default is /usr/bin.
81
78
82
79
--datadir=directory
83
80
This is incorporated into both the Makefile and the
84
81
config.h file. It is the directory where elvis' support
85
82
files will reside after a "make install". The default is
86
- /usr/local/lib/elvis.
83
+ /usr/share/elvis.
84
+
85
+ --docdir=directory
86
+ This is incorporated into both the Makefile and the
87
+ config.h file. It is the directory where elvis' manual
88
+ will reside after a "make install". The default is
89
+ /usr/share/elvis/doc.
90
+
91
+ --prefix=directory
92
+ This value is incorporated into the Makefile. It supplies
93
+ leading part of the datadir, docdir, and bindir values.
94
+ Its default value is /usr, which is why those directories
95
+ all have values starting with "/usr".
87
96
88
97
--libs=string
89
98
This option allows you to specify which library to use
@@ -98,23 +107,19 @@ UNIX
98
107
header files in /usr/include.
99
108
100
109
2) Give the command "make". This should eventually produce programs
101
- named "elvis" and "ref". Source code is also included for "ctags"
102
- and "fmt" but these aren't normally compiled because your UNIX system
103
- probably already has better versions of them. If you want to use
104
- elvis' versions of "ctags" and "fmt" then you should edit the Makefile
105
- to add those programs to the definition of the ALL macro.
106
-
107
- Exception: Linux gets all four programs by default, because the
108
- versions of "ctags" and "fmt" distributed with Linux actually came
109
- from elvis 1.8, so the 2.1 versions are newer.
110
+ named "elvis", "ref", "elvtags", and "elvfmt". (elvtags and elvfmt
111
+ are elvis' own versions of the standard ctags and fmt programs. The
112
+ names of elvis' versions were changed so they wouldn't clash with the
113
+ standard ones.)
110
114
111
115
3) You should be able to run "elvis" in the source code directory now.
112
116
Try "e2 README.html" or "e2 config.h".
113
117
114
118
Note that we're running the e2 shell script instead of the elvis
115
119
executable. e2 simply runs elvis in such a way that it looks for
116
- its support files in the "lib" subdirectory, instead of the usual
117
- directory.
120
+ its support files in the "data" subdirectory, instead of the usual
121
+ directory. We do this because the support files haven't been
122
+ installed into their usual directory yet.
118
123
119
124
4) If all goes well, you can install elvis by becoming the superuser and
120
125
running the command "make install". (Later, if you decide to uninstall
@@ -192,11 +197,11 @@ MS-Windows/NT (or Windows95?), with Visual C++ 2.0 or later (Method #2):
192
197
MS-DOS, using Visual C++ 1.5 (Method #1):
193
198
REMINDER: MSVC++ 1.5 always puts the complete pathnames of all files
194
199
into its NMAKE files. Because of this, you *MUST* install the
195
- source code into a directory named "C:\MSVC\elvis-2.1_4 ". The
196
- "elvis-2.1_4 " component of that directory name is stored in the
197
- "elvis-2.1_4 .tar.gz" archive file, so you should be in the C:\MSVC
200
+ source code into a directory named "C:\MSVC\elvis-2.2* ". The
201
+ "elvis-2.* " component of that directory name is stored in the
202
+ "elvis-2.2* .tar.gz" archive file, so you should be in the C:\MSVC
198
203
directory when you extract the files. After extracting the files,
199
- do a "cd elvis-2.1_4 "
204
+ do a "cd elvis-2.2* "
200
205
201
206
1) Run the "makmsdos.bat" file
202
207
@@ -216,19 +221,19 @@ MS-DOS, using Visual C++ 1.5 (Method #1):
216
221
MS-DOS, using Visual C++ 1.5 (Method #2):
217
222
REMINDER: MSVC++ 1.5 always puts the complete pathnames of all files
218
223
into its NMAKE files. Because of this, you *MUST* install the
219
- source code into a directory named "C:\MSVC\elvis-2.1_4 ". The
220
- "elvis-2.1_4 " component of that directory name is stored in the
221
- "elvis-2.1_4 .tar.gz" archive file, so you should be in the C:\MSVC
224
+ source code into a directory named "C:\MSVC\elvis-2.2* ". The
225
+ "elvis-2.2* " component of that directory name is stored in the
226
+ "elvis-2.2* .tar.gz" archive file, so you should be in the C:\MSVC
222
227
directory when you extract the files.
223
228
224
- 1) Copy all of the "C:\MSVC\elvis-2.1_4 \OSMSDOS\*.MAK" files into the
225
- "C:\MSVC\elvis-2.1_4 " directory.
229
+ 1) Copy all of the "C:\MSVC\elvis-2.2* \OSMSDOS\*.MAK" files into the
230
+ "C:\MSVC\elvis-2.2* " directory.
226
231
227
232
c:
228
- cd \msvc\elvis-2.1_4
233
+ cd \msvc\elvis-2.2*
229
234
copy osmsdos\*.mak
230
235
231
- 2) Copy the "\MSVC\elvis-2.1_4 \OSMSDOS\OSCONFIG.H" file to
236
+ 2) Copy the "\MSVC\elvis-2.2* \OSMSDOS\OSCONFIG.H" file to
232
237
"\MSVC\elvis-2.1\CONFIG.H" Note that the "OS" is dropped from the
233
238
filename.
234
239
0 commit comments