ePiX -- README-porting

May 16, 2006

As of Version 1.0.7, ePiX uses autoconf and automake, and installs
libraries, headers, scripts, and (especially) documentation in
standard locations. (Thanks to Julian Gilbey!)

  ./configure [options]
  make
  make install


The shell scripts are built by the top-level Makefile from pristine
files named, e.g., epix.in.

The configuration scripts helpfiles.sh, newbash.sh, pre-install.sh,
and post-uninst.sh are obsolete and have been removed.

Install paths are as indicated below, but the variable EPIX_ROOTDIR is
obsolete, replaced by the standard, "prefix".


January 12, 2005

In Version 1.0.3, the build process and install paths have changed.
Paths and variables are collected in the config file.

External Changes:

In the table below,

* Paths are relative to $EPIX_ROOTDIR, e.g. bin/ -> /usr/local/bin/

* Version number is x.y.z

* Packed = tarred and gzip-ed


		Version 1.0.0		        Version 1.0.3
----------------------------------------------------------------------
Scripts		bin/				bin/

Remarks:	elaps, laps static		all generated,
		epix, flix generated		see make_<script>
----------------------------------------------------------------------
Header		include/			include/

Remarks:	epix.h				epix-x.y.z.h
						epix.h is a symlink
----------------------------------------------------------------------
Library		lib/				lib/

Remarks:	libepix.a			libepix-x.y.z.a
						libepix.a is a symlink
----------------------------------------------------------------------
User manual	share/epix/tutorial/		share/doc/epix/

Remarks:	Unpacked sources, ps		Packed sources, ps, pdf
----------------------------------------------------------------------
Samples		share/epix/samples/		share/doc/epix/

Remarks:	Tarred sources			Packed sources, ps, pdf
----------------------------------------------------------------------
Contrib docs	share/epix/tutorial/contrib	share/doc/epix

Remarks:	Unpacked sources		Packed sources
----------------------------------------------------------------------
Man page	man/man1			share/man/man1
----------------------------------------------------------------------
Notes, config	share/epix/{notes,config}	Unchanged
----------------------------------------------------------------------


Internal Changes:

* If the shell is not /bin/bash in the config file, then newbash.sh is
  run at build. Pristine files are preserved with extension .orig.

* The Makefile uses /bin/sh, not /bin/bash

* helpfiles.sh builds the documentation, performs no installation

* "make test" = "make doc samples"


---
Andrew D. Hwang (rhymes with "song", not "sang")

<rot 13 nujnat at zngupf dot ubylpebff dot rqh>
