% e-TeX is copyright (C) 1994-1996 by the NTS team; all rights are reserved.

This is file `README.w2c70etex11' describing how to integrate
	e-TeX v1.1 (Oct 16, 1996) into
	Web2c v7.0



How to integrate e-TeX v1.1 (Oct 26, 1996) into Web2c v7.0:
===========================================================

List of files provided:

  * README.w2c70etex11  -- this README file
  * w2c70etex11.tar.gz  -- installs additional subdirectories
  * w2c70etex11.diff    -- patches three files of Web2c v7.0

You can find these files on

	CTAN: systems/unix/web2c-e-tex/



INSTALLATION
============


1. Get the sources of web2c v7.0 ...
 
        CTAN: systems/unix/web2c/web-7.0.tar.gz
        CTAN: systems/unix/web2c/web2c-7.0.tar.gz
 
   ...and unpack the two gnuzip'ed tar file in a single directory with
 
        gzip -dc web2c-7.0.tar.gz | tar xpvf -
        ln -s web2c-7.0 web-7.0
        gzip -dc web-7.0.tar.gz | tar xpvf -
 
   This will create a directory called `web2c-7.0/', a symbolic link
   `web-7.0' and will unpack all files of both archives into the
   `web2c-7.0/' directory and subdirectories.


2. Unpack the file `w2cetex11.tar.gz' into `web2c-7.0':

	gzip -dc w2cetex11.tar.gz | tar xpvf -


   This will add two new subdirectories
 
        web2c-7.0/web2c/e-tex-1.1/
        web2c-7.0/web2c/etriptest/
 
   (It won't overwrite any files or directories!)  The directory
   `e-tex-1.1' contains the original e-TeX change file `etex.ch',
   additional change files and a basic set of e-TeX documentation.
   Directory `etriptest' contains the e-TRIP test.

3. Apply the `diff'erences file using the utility `patch':

	patch < w2c70etex11.diff


   This will change the files
 
	web2c-7.0/web2c/web2c/convert
	web2c-7.0/web2c/web2c/splitup.c
	web2c-7.0/web2c/Makefile.in

   adding code for a new `etex' target (and targets for the e-TRIP
   test).


4. Follow the instructions in Web2c's files

	web2c-7.0/README
	web2c-7.0/kpathsea/INSTALL

   (I.e., change to directory `web2c-7.0/', configure Web2c by calling
   `./configure', and use `make' to compile and install all programs
   and data files.)


   An e-TeX executable in addition to all the other TeX programs
   will be compiled by the usual call

	make

   If you want to compile e-TeX only, change into directory
   `web2c-7.0/', configure Web2c, and then change into subdirectory
   `web2c/' and call

	make etex

   This will create an `etex' executable and a new pool file
   `etex.pool'.


5. (Optional) Test your e-TeX using the e-TRIP test:
   Change into subdirectory `web2c-7.0/web2c/' and call

	make etrip

   or use `make etripc', `make etripe', and `make eetrip' for the
   three parts of the e-TRIP test.

   Compare the results with the files

	web2c-7.0/web2c/etriptest/{etripc,etripc,eetrip}.diffs

   the output I have got on my machine.  The file

	web2c-7.0/web2c/etriptest/README.w2cetrip

   describes the allowed and expected differences.


6. Install e-TeX (`etex' and `etex.pool'):
   e-TeX will get installed with all other Web2c programs using

	make install


   (a) If you install e-TeX using the name `etex', you probably have
   to change your `texmf.cnf' adding some lines for the program
   ".etex" (as it is already done for ".tex").


   (b) Because e-TeX in its default compatibility mode is a 100%
   compatible replacement of TeX, I have installed e-TeX using the
   name `tex'

	mv ${bindir}/tex ${bindir}/tex-orig
	ln -s ${bindir}/etex ${bindir}/tex

   and remade all formats thus using e-TeX in compatibility mode as my
   normally used TeX.

   NOTE: You can NOT use format files created by e-TeX with a standard
         TeX and vice versa---e-TeX dumps additional information to
         the format file.
         ==> Remake all format files afterwards!

   NOTE: Do NOT rename `etex.pool' even if you rename or link `etex'
         to `tex'---the pool files of e-TeX and TeX are different and
         incompatible!

   To switch to extended mode you have to create a format file by
   preceding the format soure file name by an asterisk 
   (e.g. "etex -ini \*plain" instead of "etex -ini plain").


7. Enjoy e-TeX v1.1!

   Please read the e-TeX documentation---a basic subset can be found
   in

	web2c-7.0/web2c/e-tex-1.1/

   Refer to the e-TeX reference site ftp://vms.rhbnc.ac.uk/e-TeX/
   or to CTAN, directory systems/e-tex/ for the complete e-TeX source
   and documentation.



Please report any bugs, improvements, etc. to

	etex-support@vms.rhbnc.ac.uk

or to

	raichle@informatik.uni-stuttgart.de


-br [97-02-20]