ePiX -- INSTALL

Last Change: July 5, 2002

This file contains detailed installation instructions for epix-0.8.x.

Lines starting with a "%" denote commands typed at a shell prompt. 
Don't type the "%". :)


--- Synopsis ---

(1) Unpack
(2) Edit the Makefile if installing somewhere other than /usr/local
(3) Edit and run newbash.sh if bash is not /bin/bash
(4) Build:

% make [contrib] test 
% make install


--- Step-by-step Instructions ---

(1) Unpack the tarball (replace version number 0.8.x as appropriate):

% tar -zxvf epix_src.tar.gz

  If your "tar" doesn't understand decompression, do

% gunzip -c epix_src.tar.gz | tar -xvf -

  Change to the source directory:

% cd epix-0.8.x


(2) To install in /usr/local, skip to step (3). Otherwise, edit the
  following line of the Makefile as desired:

  prefix=/usr/local


(3) As already noted, ePiX is strongly bash-dependent.
  Hacks for zsh, ksh, tcsh, etc. are welcome! :)

  If bash is in /bin/bash on your system, please skip to step (4).

  If bash is NOT in /bin/bash on your system, then edit the file
  newbash.sh, replacing "/usr/local/bin/bash" in the indicated line
  with the path to bash on your system, then run the script:

% ./newbash.sh

  When the script finishes, you may safely remove the ".orig" files left 
  behind. If the script fails, something is seriously wrong, e.g., you
  don't have write permission in the source directory, or "sed" is not
  installed. Speak to your sysadmin for assistance. The action of the 
  script can be accomplished manually (but painfully) as follows: For
  each file listed in the script, replace each occurrence of "/bin/bash"
  with the full path to bash on your system (about 10 changes in all).


(4) Compile:

% make

  This builds several object files, and the following files for
  installation:
  * A static library (libepix.a)
  * A shell script (epix)
  * A header file (epix.h)

  If desired, build the (separately documented, see the contrib/ directory)
  contributed package:

% make contrib

  If LaTeX and dvips are installed, you may test the build before installing:

% make test

  If all goes well, you'll have a dvi file "sample.dvi" and a Postscript
  file "sample.ps" that you can preview or print. 

  If one of these steps fails, run "make clean" before proceeding.


(5) 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 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 in your HOME directory, just type

% make install


(6) Post-Install:

  From the source directory, do
  
% make clean

  to clean the source tree of compiled files and sample output. It is
  safe to run "make clean" repeatedly.

  The sample files are installed in $EPIX_ROOTDIR/share/epix. For users'
  convenience, they are available both unpacked and tarred up in the file

  $EPIX_ROOTDIR/share/epix/epix_samples.tar

  This tar file does not create a subdirectory when unpacked. To look at
  the sample .eepic files, create a directory, say "samples", then do:

% cd samples
% cp /usr/local/share/epix/epix_samples.tar .
% tar -xvf epix_samples.tar
% ./makefigs

  These commands assume ePiX is installed under /usr/local, of course.


  To remove ePiX from your system (should it come to this), "su root"
  if necessary and do:

% make uninstall


--- Contact Information ---

If you have questions, comments, suggestions, etc., please write to:

Andrew D. ("Andy") Hwang                  <ahwang@mathcs.holycross.edu>
Dept. of Mathematics and Computer Science
College of the Holy Cross
Worcester, MA, 01610-2395, USA