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
|