diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/pastex.txt')
| -rw-r--r-- | Master/texmf-dist/doc/latex/base/pastex.txt | 193 |
1 files changed, 193 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/base/pastex.txt b/Master/texmf-dist/doc/latex/base/pastex.txt new file mode 100644 index 00000000000..bfc28ff70af --- /dev/null +++ b/Master/texmf-dist/doc/latex/base/pastex.txt @@ -0,0 +1,193 @@ + + + LaTeX installation instructions for PasTeX + + 9 July 1996 + + +SUMMARY +======= + +This file contains instructions on how to install LaTeX for +PasTeX on the Amiga. 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 configure LaTeX. + (You can skip this part if you`re new to this.) + + * How to unpack the LaTeX distribution. + + * How to create the LaTeX format. + + * How to install the LaTeX files. + + * What to do if you have any problems. + + + +PRELIMINARIES +============= + +Most of the installation procedure is concerned with creating a so +called format file. This file contains essentially all the macros +that make up the LaTeX package in a format that can be read in very +quickly by virtex. + +This guide assumes that you have an unmodified installation of PasTeX +release 1.3 or higher. If you have made any changes you should be able +to figure out yourself where to deviate from this introduction. + +If you are using PasTeX 1.3 you should install the binaries from +TeX:Bigbin to TeX:bin now. The normal binaries cannot be used with +LaTeX2e. Alternatively you might want to install PasTeX release 1.4. +A "light" version is available on aminet as text/tex/pt14l.lha, +the full release is on the Meeting Pearls III CD-ROM. +As of writing (July 1996), the CD is online at +<URL:ftp://ftp.rz.uni-wuerzburg.de/pub/amiga/mpearls3/index.html>. + +First of all move all of the files that accompanied this document to +a directory that should be outside the TeX: hierarchy. DO NOT copy +them directly to TeX:macros! Most of the installation will take place +in this directory. If the installation was successful you can delete +this directory afterwards. + + +SAVING ANY OLD VERSION OF LaTeX +=============================== + +If you are currently using the old LaTeX version, 2.09, you may wish +to save it before installing the new version of LaTeX. + +The format file is located in the directory TeX:formats and is named +something like lplain.fmt or latex.fmt. If the name is latex.fmt you +should rename it to latex209.fmt. This installation procedure will +create a new file called latex.fmt that would overwrite the old one. + +Now you should save your old style files. Make a subdirectory latex209 +in the directory TeX:macros and copy all files #?.sty from TeX:macros +into this directory. + +If you want use LaTeX 2.09 again for some reason, set the environment +variable TEXINPUTS with something like + +setenv TEXINPUTS .,TeX:macros/latex209,TeX:macros + +Make sure that TeX:macros/latex209 comes before TeX:macros so that +the old style files are used. (The "." refers to the current directory. +If you omit it, files in the current directory will not be found!) +Then call LaTeX with "virtex &latex209" (or "virtex &lplain", if that +was the name of the old format file). + + +CONFIGURING LATEX +================= + +If you have PasTeX release 1.3, you may wish to edit the file +texsys.cfg to have LaTeX work around some quirks in the version +of virtex that comes with it. First find out the actual version +of virtex with the command "version TeX:bin/virtex". +Then edit the file texsys.cfg and insert a line right at the top +containing + +\def\@TeXversion{3.14} + +and, of course, insert your actual version number if it differs. +This change is however purely cosmetical and only affects the +format of warning messages. + + +If at some point TeX runs out of memory it will stop with an error +message. +You can try and make more memory available to TeX by editing the file +TeX:config/tex.cnf. Try to figure out which parameter might have caused +TeX to run out of memory. If the error message said e.g +"Font <foobar> not loaded: Not enough room left", you should look at +the parameter fontmax and/or fontmemsize. A good place to start is +always the pair memmax and memtop. Read the comment in the file for more +information. + +From TeX version 3.0 on you have the possibility to have more than one +set of hyphenation atterns available in a format file. See the file +texpert.txt for more details of how this can be achieved. + + +UNPACKING THE DISTRIBUTION +========================== + +Cd to the directory that contains the distribution files. Check if +there is a file called "latex.ltx". If there is you probably have +got a distribution that already has been unpacked and can skip this +part. If there is a problem with a missing file at some point during +the installation, try unpacking it again anyway. + +If latex.ltx does not exist, the command "initex unpack.ins" will +unpack the distribution. If you have an 68000 based Amiga, now is +the time to go and make some coffee. + + +CREATING THE LaTeX FORMAT +========================= + +When the unpacking procedure is complete type "initex latex.ltx". +This will create the format file. When this is finished, copy it to +TeX:formats. Make sure you do not overwrite an old latex.fmt, +especially if there have been any problems. + + +PUTTING THE FILES WHERE LaTeX CAN READ THEM +=========================================== + +Now you need to install the new style files and everything else LaTeX +needs. Copy the following files to TeX:macros: + + latexbug.tex testpage.tex docstrip.tex lablst.tex + idx.tex nfssfont.tex small2e.tex sample2e.tex + #?.cls #?.clo #?.sty #?.fd #?.def #?.cfg + +If you have MakeIndex installed, copy #?.ist to the MakeIndex inputs +directory. + + +CHECKING THAT THE INSTALLATION WORKED +===================================== + +Now you can check if the installation worked. First cd to another +directory that does not contain any of the distribution files. +Copy the file ltxcheck.tex here and type "virtex &latex ltxcheck" +to the shell prompt. TeX will report that it cannot find a syntax +for the current directory, but that is OK. (If you figure out a way +to refer to the current directory, like UNIX ./, please tell us.) + +It will then check if it can find the file article.cls in the current +directory and issue an error because it will find the file in +TeX:macros. This is actually a good sign. Simply press return to the +question mark. + +It will then check for the version of TeX currently installed. If +you have PasTeX release 1.3, which contained virtex version 3.14, +there will probably be some ^^Js cluttering up the output. + +You can edit texsys.cfg (in the distribution directory) and rebuild +the format file as suggested by the warning text (see the section on +configuring LaTeX). PasTeX release 1.4 cures this problem. See the +`PRELIMINARIES' section for information on availability. + + +PROBLEMS +======== + +If there is any problem during installation, read the section on +configuring LaTeX in this document. Some of the problems that may +occur are covered there. Carefully reread the rest of the document, +then read the document install.txt, especially the `PROBLEMS' section. + +If none of these can solve your problem, try to get some human help. + +--- Copyright 1994-1996 Christian Bauernfeind and the LaTeX3 project --- +--- All rights reserved. --- + + |