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
|
ePiX-1.2 -- INSTALL
Last Change: September 12, 2007
Please consult the following files as appropriate:
INSTALL (this file) -- Detailed installation instructions
NEWS -- Recent major changes (see ChangeLog for code changes)
README -- General overview and information
CONVENTIONS
Lines starting with a "%" denote commands typed at a shell prompt.
Lines starting with a "#" denote commands run as root.
Don't type the prompt characters "%" or "#". :)
"$(prefix)" stands for the complete path to the install directory,
e.g. "/usr/local" or "/home/pootle/epix".
DEPENDENCIES
The following software must be installed on your system in order for
you to use ePiX:
* The GNU shell, bash
* A C++ compiler and development libraries, preferably g++ (> 3.2)
* GhostScript, ImageMagick, and teTeX
* GNU binutils, textutils, and fileutils (ar, sed, grep, ln, rm...)
Please consult your system documentation for information on installing
these components. The POST-INSTALL file contains potentially helpful
information, as well. The manual contains more detailed instructions
for Windows (Cygwin) and Mac OS X (fink/fink commander) users.
INSTALLATION
--- Synopsis ---
(1) Unpack
(2) Configure:
% ./configure [options]
(3) Build:
% make
% make install (may require system privileges)
--- Step-by-step Instructions ---
(1) Unpack
Tarballs are available gzip or bzip2 compressed. To unpack, use the
appropriate version number and tar options (z for .gz, j for .bz2, v
to see filenames unpacked):
% tar -zxf epix-x.y.z.tar.gz
or
% tar -jxf epix-x.y.z.tar.bz2
If your "tar" doesn't understand decompression, do
% gunzip -c epix-x.y.z.tar.gz | tar -xf -
or
% bzcat epix-x.y.z.tar.bz2 | tar -xf -
Change to the source directory:
% cd epix-x.y.z
(2) Configure the package:
Most users can run the command
% ./configure
To change the installation directory from the default (/usr/local)
to (say) your home directory, do
% ./configure --prefix=${HOME}
To list all options, run
% ./configure --help
(3) Compile and install:
% make
Be sure you are using GNU make. If the build fails immediately with
an error about unexpected characters in the Makefile, speak to your
system administrator about availability of GNU make, or try running
the command "gmake".
If there are no build errors, you're ready to install.
You must have write permission in the install directory you selected
in step (2). If you have been logged on as yourself until now (a Very
Good Idea) and are installing in a system directory, do:
% su
Password: <your root password>
# make install
(The root prompt on many systems is # rather than %.) If the install
succeeds, you're done:
# exit
If you are installing somewhere in your HOME directory, just type
% make install
(4) Post-Install:
Documentation is installed in $(prefix)/share/doc/epix, as compiled
files (ps, pdf, info) and tarred LaTeX sources.
The directory $(prefix)/share/doc/epix/config contains two optional
files: Jay Belanger's emacs mode for working with ePiX files, and
completions for users of Ian MacDonald's bash completions package.
POST-INSTALL has instructions on installing and using these files.
From the source directory, do
% make clean
to clean the source tree of compiled files. This command removes the
top-level Makefile. Run ./configure to re-create the Makefile if
necessary.
(5) Uninstalling:
To remove a version of ePiX from your system, go to the directory
where the sources were unpacked, run ./config.status, log on as root
if necessary, and do:
# make uninstall
Alternatively, remove the following files and directories manually,
replacing $(prefix) with the install path, e.g. "/usr/local".
[] Shell scripts
$(prefix)/bin/{elaps,epix,flix,laps}
[] Static libraries and shell code
$(prefix)/lib/epix/
[] Header files
$(prefix)/include/epix.h (user header)
$(prefix)/include/epix/ (devel headers)
[] Configuration files, manuals, and samples
$(prefix)/share/doc/epix/
--- Contact Information ---
If you have questions, comments, suggestions, etc., please write to:
Andrew D. ("Andy") Hwang <rot 13 nujnat at zngupf dot ubylpebff dot rqh>
Dept. of Mathematics and Computer Science
College of the Holy Cross
Worcester, MA, 01610-2395, USA
|