PubliC (e)TeX/METAFONT/MetaPost, and the Dos-TP implementations of the utilities (for MS Dos, in Turbo Pascal) 1. Files This distribution consists of quite a few .zip files grouped as follows: SRCxxx sources EXExxx precompiled programs RUNxxx documentation plus a few support files where xxx indicates the components (individual programs or groups of programs). You will always need the RUNxxx files for whatever components you select to install. In addition, if you have a Turbo Pascal compiler (Version 5.0, 5.5, 6.0, or 7.0) and want to compile the programs --- possibly with some parameter values modified --- you need the SRCxxx files. Otherwise, if you can't or don't want to compile the programs yourself, you need the EXExxx files. You can choose from the following components more or less independently (where yyy is SRC, EXE, or RUN): yyyDOSTP basic support, includes a utility program dostpqry that allows to interrogate the Dos-TP file search mechanism. Always required, SRCDOSTP required for all SRCxxx. SRCASM sources for various assembler subroutines (mainly for TeX, METAFONT, and MetaPost). In order to generate the .obj files from their sources you need a suitable assembler (preferably tasm, masm might work as well). All .obj files are contained in SRCDOSTP, thus SRCASM is optional! yyyWEB web system programs tangle and weave; yyyPATCH slightly modified version of tangle and weave plus patchtgl, patchweb, and patchwve. WEB or PATCH required for all SRCxxx, PATCH required for SRCETEX. yyyTEXWA TeXware programs dvitype, patgen, pltotf, pooltype, and tftopl. Required for (e)trip and (m)trap tests. yyyMFWAR MFware programs gftodvi, gftopk, gftype, mft, and pktype. Required in order to generate PK fonts and for trap test. yyyMPWAR MPware programs mptotex, dvitomp, and makempx. Required by MetaPost. yyyVFWAR programs related to virtual font (VF) files. yyyFONTU font conversion utilities (to and from PK format). yyyBIBTE BibTeX. yyyTEX TeX (virtex and initex). RUNTEX required for e-TeX, SRCTEX required for SRCETEX. yyyETEX e-TeX (evirtex and einitex). yyyMETAF METAFONT (virmf and inimf). yyyMETAP MetaPost (virmp and inimp). 2. Installation and the TeX Directory Structure (TDS) Let denote the root of the TDS as described in the draft `A Directory Structure for TeX Files' --- typically 'c:\texmf' or similar. And let be the directory where the .zip files are located. Make the current directory (on the current drive) and unpack all the .zip files, e.g., by the commands (from the command line, or replace '%i' by '%%i' in a .bat file): cd for %i in (\*.zip) do unzip -o %i 3. Generating the Programs from their Sources All SRCxxx file are installed in the directory \dostp\ (where is 'src22' for Dos-TP Version 2.2) and its subdirectories. In order to generate any of the programs you should change to the source directory: cd \dostp\ In that directory and its subdirectories there exists a system of MK.BAT batch files that provide a Unix make like functionality. You first have to configure them, in order to * tell them the location of your Turbo Pascal compiler TPC.EXE, * optionally tell them the name and location of your assembler, * select which among the installed components you want to generate and which tests you want to run on them. E.g., in order to generate e-TeX you must install SRCTEX and SRCETEX. It is, however, up to you whether you select to generate TeX and e-TeX or just e-TeX. Use: mk config and answer all questions. After that you can use: mk to generate all selected programs mk test to run all selected tests mk trip just the trip test for TeX mk etrip just the etrip test for e-TeX mk trap just the trap test for METAFONT mk mtrap just the mtrap test for MetaPost mk install to install the generated programs mx testx to run some additional tests (see below) mk clean to remove most temporary files mk realclean to remove all temporary files You can rerun 'mk config' at any time, you must rerun it after 'mk realclean'. All files created by 'mk' are in the \dostp\tmp directory, they are moved to their destination by 'mk install' and most are deleted by 'mk clean'. All files created by 'mk test(x)' are in the \dostp\tmp directory, most of them are deleted when a test has succeeded. Whereas most tests (those made by 'mk test') can be performed before or after the programs are installed (the executables are sought first in the \dostp\tmp and then in the \dostp\bin directory), some other tests (those made by 'testx') can only be performed successfully after the programs have been installed and the small executables 'tex' and 'mf' have been configured to invoke virtex/virmf with the plain format/base (see below) and are ready to be executed. 4. Configuring your System 4.1. The Dos-TP Configuration File You might wish to modify the Dos-TP configuration file \dostp\texmf.cnf that contains the file search paths for various classes of input files. You may also want to keep a copy of that modified file, since the original file gets replaced by the standard one during the installation procedure. 4.2. (e)TeX, METAFONT, and MetaPost You should use the TeXMFcnf utility in the \dostp directory to configure small executable files such as 'tex', 'plaintex', 'latex', etc. that invoke (e)virtex/virmf/virmp with a suitable default format/base/mem, e.g.: cd \dostp texmfcnf tex - tex % use format from input file (or plain) texmfcnf tex plain plaintex % use `plain' format texmfcnf etex - e-tex % use format from input file (or plain) texmfcnf etex etex etex % use `etex' format texmfcnf mf - mf % use base from input file (or plain) texmfcnf mf plain plainmf % use `plain' base texmfcnf mf cm cmmf % use `cm' base texmfcnf mp - mp % use mem from input file (or plain) texmfcnf mp plain plainmp % use `plain' mem 5. Running the Programs All executables are in the \dostp\bin directory, therefore you should add it to your Dos path. You SHOULD NOT, however, move all the executables from the \dostp\bin directory to another directory already in the Dos path; this will most probably fail. All programs accept command line parameters, the \dostp\doc directory contains detailed desriptions. In order to generate (e)TeX formats, METAFONT bases, and MetaPost mems run (e)INITEX, INIMF, or INIMP from the \dostp\ini directory, e.g.: cd \dostp\ini initex -cec850 plain.itx einitex -cec850 -fetex *etex.src \dump inimf -cec850 plain.imf inimf &plain cm.imf inimp -cec850 plain.imp You might have to get many (La)TeX, METAFONT and MetaPost source files and place them into the TDS tree, e.g., from one of the CTAN archives. If you wish to generate fonts, you can then, e.g., say: mf \mode=ibmtont; mag=1; scrollmode; input logo8 gftopk logo8 \fonts\pk\ibmtont\public\mflogo\dpi100\ cmmf \mode=cx; mag=1.2; scrollmode; input cmss8 gftopk cmss8 \fonts\pk\cx\public\cm\dpi360\ ***** Happy TeXing ***** --- Peter Breitenlohner (peb@mppmu.mpg.de) ------------ 06 Sep 98 ---