LaTeX installation instructions for emTeX 11 June 1995 SUMMARY ======= This file contains instructions on how to install LaTeX for emTeX on DOS; users of emTeX on OS/2 will need to make the standard small changes, such as `.cmd' instead of `.bat'. Before reading this file, you should read install.txt, which will explain how the LaTeX installation works. This file describes: * How to save any old version of LaTeX. * How to unpack the LaTeX distribution. * How to create the LaTeX format. * How to install the LaTeX files. These instructions assume that you are using the standard directory set up supplied by the emTeX distribution. We hope that, if your system's set up differs from this then you will be sufficiently familiar with your system to make the necessary amendments to these instructions. SAVING ANY OLD VERSION OF LATEX =============================== If you have a copy of LaTeX 2.09, you may wish to save it before installing the new LaTeX. You should make a subdirectory called latex209 in the emtex directory. Then copy any files called *.sty from the TeX inputs directory (normally emtex\texinput) into this latex209 subdirectory. You should also rename the LaTeX format file which you use for LaTeX 2.09, usually lplain.fmt, to latex209.fmt. You should then create a batch file latex209.bat, which temporarily resets the TEXINPUT environment variable to a path which includes the latex209 subdirectory before the TeX inputs directory, and then calls TeX with the file latex209.fmt as the format file. Check that this batch file works before proceeding. UNPACKING THE DISTRIBUTION ========================== To unpack the LaTeX distribution, you should change to the directory reserved for the installation and run iniTeX on the file unpack.ins. To run iniTeX you use the option /i so this is typically done by typing: tex /i unpack.ins CREATING THE LATEX FORMAT ========================= To create the LaTeX format, you should run iniTeX on the file latex.ltx. This will create a file latex.fmt. You should copy this to the directory where TeX looks for its format files, normally the texfmts or btexfmts subdirectory of emtex. Make sure that you put it in the correct directory: the one that is used by the version of the TeX program you are using. PUTTING THE FILES WHERE LATEX CAN READ THEM =========================================== You should move the following files to the TeX inputs directory (usually emtex\texinput): latexbug.tex testpage.tex docstrip.tex *.cls *.clo *.sty *.fd *.def *.cfg If you use the MakeIndex program (called makeindx.exe) then you should move the *.ist files into the MakeIndex inputs directory (normally emtex\makeindx). CHANGING THE BATCH FILE ======================= You should edit the file latex.bat (if you do not have one then you may wish to create it) so that it calls TeX with the file latex.fmt as the format file. CHECKING THAT THE INSTALLATION WORKED ===================================== You should now run LaTeX on ltxcheck.tex. This should produce a number of `OK' messages. If it produces any warnings, please consult the `Problems' section of the file install.txt. MEMORY PROBLEMS =============== If you have an old version of emTeX, or you are using a PC with a CPU less powerful than an 80386, then you will need to increase that part of the memory known as `string characters' or as `pool size'. This should be set to its maximum value by using the option: /mp:65500 either on the command line or via the EMTEXOPT environment variable. You will probably be able to compensate for this increased requirement by reducing the `font info' memory using the option `/mf:'. When using several packages or when processing complex documents, especially if they contain lots of cross-references, citations, etc., you may run out of the memory known as `multiletter control sequences' or as `hash table'. Unfortunately, the only cure for this is to get a newer version of emTeX. --- Copyright 1995 the LaTeX3 project --- --- All rights reserved. ---