summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/base/pastex.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/pastex.txt')
-rw-r--r--Master/texmf-dist/doc/latex/base/pastex.txt193
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. ---
+
+