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

This is file `README.w2cetrip' describing the steps to e-TRIP test an
e-TeX implementation based on
	e-TeX v1.1 (Oct 16, 1996) and
	Web2c v7.0

Please read `README.w2c70etex11' for a quick installation guide.


List of files:
=============

Implementation independent files:

    * etripman.tex  -- the e-TRIP manual
    * etrip.tex     -- macro source of the e-TRIP test
    * etrip.pl      -- pl file of the e-TRIP font
    * etripin.log   -- contents of log file of e-IniTeX run
    * etrip.log     -- contents of log file of e-VirTeX run
    * etrip.fot     -- log output of e-VirTeX run

Web2c v7.0 dependent files:

    * texmf.cnf     -- special e-TRIP Kpathsea configuration file
    * trip1.in      -- *.in file are fed to e-TeX as standard input
    * etrip1.in
    * etrip2.in
    * etripc.diffs  -- *.diffs show examples of allowed diffs
    * etripe.diffs
    * eetrip.diffs



1. Compile e-TeX 1.1 as described in `README.w2c70etex11'.

2. For the following steps make sure that

   (a) the provided `texmf.cnf' is used otherwise e-TeX will probably
   fail with an error to increase POOLSIZE.

   (b) the e-TRIP test runs aren't run in the same file as the sample
   *.log files, otherwise you will overwrite them.

3. Run complete e-TRIP test needing three separate ``TRIP'' test runs.
   Change to the directory `web2c-7.0/web2c/' and use the Makefile
   `web2c-7.0/web2c/Makefile'.

   (a) Run TRIP test in compatibility mode:

	make etripc

   There should be no differences except the "usual" differences between
   Knuth's TeX and a web2c TeX, i.e.:
    - slightly different "glue set" values (causing also small
      differences of the dvi output in file `trip.typ')
    - differences in the maximal number of the hyphenation trie ops,
      multiletter control sequences and hyphenation exceptions

   NOTE: Because of the new file name handling code in web2c v7.0,
   there will be additional differences in the string usage
   statistics:  The usage should be lower than the TRIP original.

   There will be these differences because of the additional e-TeX
   code:
    - different banner line ("This is e-TeX ..." instead of
      "This is TeX ...")
    - an additional line "entering compatibility mode" after the
      banner line (and the first line of input)
    - statistics with about 89 additional strings and an additional
      length of about 995 characters in the first pass
      (and -10 strings with -64 characters in the second pass, because
      of the new filename handling routines in web2c v7.0 it uses
      _less_ strings than the original TeX, it's not an e-TeX feature!)

   Compare with
	web2c-7.0/web2c/etriptest/etripc.diffs
   for an example of these diffs.


   (b) Run TRIP test in extended mode:

	make etripe

   NOTE: Because of the new file name handling code in web2c v7.0,
   there will be additional differences in the string usage
   statistics:  The usage should be lower than the TRIP original.

   Additional(!) differences between web2c TeX and web2c e-TeX:

    * first TeX pass (the IniTeX pass):

      - different banner line ("This is e-TeX ..." instead of
        "This is TeX ...")
      - an additional line "entering extended mode" after the
        banner line (and the first line of input) and the "*" at the
        beginning of the first input line
      - statistics with about 89 additional strings and an additional
        length of about 995 characters
      - 34 additional multiletter control sequences
        for the 34 additional e-TeX csnames

    * second TeX pass (the VirTeX pass):

      - different banner line and an additional line saying "entering
        extended mode"
      - two "Memory usage" differences with values _less_ than the
	original values
      - two additional log lines showing the group stack (i.e., the
	cause of the "end occurred" warnings) at the end of the job
      - in `trip.log' only:
	+  6 lines with "{restoring \predisplaydirection=0}"
	+ 10 lines showing the contents of a box with an additional
	  ", display" for \hbox
	+ 34 additional multiletter control sequences
	+  7 additionally needed save stack positions

   Compare with
	web2c-7.0/web2c/etriptest/etripe.diffs
   for an example of these diffs.


   (c) Run e-TRIP test in extended mode:

	make eetrip

   There should be no differences except the "usual" differences between
   the e-TRIP log files provided by the e-TeX team and the one you will get:
    - slightly different "glue set" values (causing also small
      differences of the dvi output in file `trip.typ')
    - differences in the maximal number of the hyphenation trie ops,
      multiletter control sequences and hyphenation exceptions

   NOTE: Because of the new file name handling code in web2c v7.0,
   there will be additional differences in the string usage
   statistics:  The usage should be lower than the TRIP original.

   Additional differences for e-TeX web2c v7.0:
    * first TeX pass (the IniTeX pass):
      none.
    * second TeX pass (the VirTeX pass):
      none (except some differences in empty lines)

   Compare with
	web2c-7.0/web2c/etriptest/eetrip.diffs
   for an example of these diffs.


4. If the whole e-TRIP test passes: Enjoy your e-TeX v1.1!

   Please read the e-TeX reference manual which can be found in

	texk/web2c/e-tex-1.1/

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

-br [97-02-18]
