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

This is file `README.w2c' describing how to re-create a master change
file containing the changes of
	e-TeX v1.1 (Oct 16, 1996) and
	Web2c v7.0

Please read `README.w2c70etex11' for a quick installation guide---a
ready-made master change file is already provided and these steps are
only needed if you want to incorporate own changes or want to update
these patches to newer e-TeX/Web2c versions.



How to remake the master change file
====================================
For: web2c v7.0 and e-TeX v1.1 (Oct 26, 1996)


List of files provided for a web2c based e-TeX implementation:

    * etex.ch   -- system independent changes for e-TeX
    * etex.adj  -- adjustments between `tex.ch' and `etex.ch'
    * etex.ech  -- undo the adjustments

    * webmerge.tex -- multiple change file merger (written in TeX)
    * makeetex.tex -- merge driver file

   The file `etex.ch' is available from the NTS team and contains
   the system independent changes for e-TeX 1.1.
   The same applies for the files `etex.adj' and `etex.ech', which are
   needed to avoid conflicts when applying the two change files
   `etex.ch' and `tex.ch' to `tex.web' at the same time.
   The files `webmerge.tex' and `makeetex.tex' realize a multiple
   change file merge program (written in TeX) and a merge driver file.


    * etex.html     -- copy of e-TeX reference site home page 
    * legal.html    -- legal status of e-TeX
    * etex_ref.html -- e-TeX reference manual, abridged version
    * etex_gen.tex  -- instructions for building e-TeX

   More documentation, macro source files, and the e-TRIP test to validate
   an e-TeX implementation can and should be obtained from the

	e-TeX reference site   http://www.vms.rhbnc.ac.uk/e-TeX/

   or the copy of this page on CTAN in systems/e-tex/.



Recreate a master e-TeX Web2c change file:


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. Get the changes of Web2c v7.0 for e-TeX v1.1 (if you read this, you
   should have these files already!):

	CTAN: systems/unix/web2c-e-tex/README.w2c70etex11
	CTAN: systems/unix/web2c-e-tex/w2c70etex11.tar.gz
	CTAN: systems/unix/web2c-e-tex/w2c70etex11.diff

   (a) Unpack the tar archive file:

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

   This will add two new subdirectories `web2c-7.0/web2c/e-tex-1.1/'
   and `web2c-7.0/web2c/etriptest/'.

   (b) Then apply the `diff'erences file using the `patch' utility:

	patch < w2c70etex11.diff

   This will change the files `web2c-7.0/web2c/Makefile.in',
   `web2c-7.0/web2c/web2c/convert', and
   `web2c-7.0/web2c/web2c/splitup.c'.


3. To recreate the master change file
   `web2c-7.0/web2c/e-tex-1.1/etex-w2c.ch' do the following steps:

   (a) change into the e-TeX directory:

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

   (b) (optional) if symbolic links to `../tex.web' and `../tex.ch'
   are missing, create these links:

	ln -s ../tex.web .
	ln -s ../tex.ch .

   (c) Recreate the master change file:
   If TIE is available:

	tie -c etex-w2c.ch tex.web etex.ch etex.adj tex.ch etex.ech

   If TIE (or PATCHWEB) is unavailable but you already have a TeX
   executable you can use `webmerge.tex' by

	tex makeetex

4. Continue reading `README.w2c70etex11'.

-br [97-02-18]
