% 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]