summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/base/emtextds.txt
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
committerKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
commit007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch)
tree90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/base/emtextds.txt
parent950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff)
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/emtextds.txt')
-rw-r--r--Master/texmf-dist/doc/latex/base/emtextds.txt232
1 files changed, 232 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/base/emtextds.txt b/Master/texmf-dist/doc/latex/base/emtextds.txt
new file mode 100644
index 00000000000..31263d9c02d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/base/emtextds.txt
@@ -0,0 +1,232 @@
+ LaTeX installation instructions for
+ emTeX/TDS (OS/2), version 0.4 and above
+
+ 2001-09-04
+
+SUMMARY
+=======
+
+This file contains instructions on how to install LaTeX for emTeX/TDS,
+version 0.4 and above. Before reading this file, you should read
+install.txt, which will explain how the LaTeX installation works.
+
+This file describes:
+
+ * 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.
+
+
+
+REQUIREMENTS
+============
+
+These installation instructions assume that you have installed the
+emTeX/TDS system already and want to upgrade LaTeX to a newer version.
+
+The contents of the directories texmf\source\latex\base and
+texmf\tex\latex\base should be deleted before installing a new LaTeX
+version.
+
+
+
+SAVING YOUR OLD VERSION OF LaTeX
+================================
+
+Instead of deleting the contents of the above directories you may
+alternatively move the files to directories outside the texmf tree.
+
+
+
+UNPACKING THE DISTRIBUTION
+==========================
+
+Copy all the files from the CTAN directory macros/latex/base to the
+directory texmf\source\latex\base on your HD.
+
+Open an OS/2 window (aka command line) and make the above directory
+the current one, e.g., if the texmf tree resides on drive c:
+
+ c:
+ cd \texmf\source\latex\base
+
+Unpack the distribution by executing the command:
+
+ htex386 -i unpack.ins
+
+
+
+CREATING THE LaTeX FORMAT
+=========================
+
+Now execute the command
+
+ makelatex
+
+to create the LaTeX format file.
+
+
+
+PUTTING THE FILES WHERE LaTeX CAN READ THEM
+===========================================
+
+The next step in the installation of LaTeX is to move the files needed
+to run the system into the correct directories (or folders).
+
+You should move to the LaTeX input directory \texmf\tex\latex\base
+
+ * latexbug.tex, testpage.tex, lablst.tex, idx.tex, nfssfont.tex
+ small2e.tex, sample2e.tex, docstrip.tex and texsys.cfg
+
+and any files whose name ends with:
+
+ * .cls, document class files.
+
+ * .clo, document class options files.
+
+ * .sty, package files.
+
+ * .fd, font definition files.
+
+ * .def, files of definitions which may be read by LaTeX while
+ processing documents.
+
+ * .ltx, the files from which the format can be rebuilt.
+
+You should move to the MakeIndex input directory \texmf\makeindex
+all files whose name ends with:
+
+ * .ist, MakeIndex style files.
+
+Please, note that any files existing already in the target directories
+must be overwritten!
+
+Caution: Do NOT move the files preload.cfg, fonttext.cfg and
+fontmath.cfg to \texmf\tex\latex\base !
+
+The makelatex script has already moved the format file to the
+directory where it belongs.
+
+You have now installed LaTeX!
+
+
+
+CHECKING THAT THE INSTALLATION WORKED
+=====================================
+
+To make sure that the installation has worked, you should run the new
+LaTeX on the document `ltxcheck.tex'. Just type
+
+ latex ltxcheck
+
+This will produce a number of messages, each of which should be `OK'.
+If any of them are `BAD', then read the `PROBLEMS' section below.
+
+If all the messages are `OK' then you are finished!
+
+
+
+PROBLEMS
+========
+
+The installation should proceed smoothly. However, you may get some
+errors.
+
+`File missing': Some of the files from the LaTeX distribution are
+ missing. There are a number of possible reasons for this:
+
+ * The files really are missing.
+ You should get the missing files from the same place you got the
+ rest of the distribution. If you cannot do this then you should
+ complain to whoever gave you this distribution.
+
+ * The files are present, but in the wrong directory. See the
+ section above "Putting the files where LaTeX can read them"
+
+ * The files are present, and in the right directory. Did you alter
+ the REXX scripts makelatex.cmd or latex.cmd? Did you alter the
+ environment variable TEXMACROS?
+
+
+`Font missing': Some of the fonts (.tfm files) required by LaTeX are
+ missing. As above, either you have not got the required files,
+ they have been deleted or TeX is not able to find them. As long as
+ you did not alter the environment variable TEXTFM, this should not
+ happen.
+
+
+`Out of memory': In the file texmf\tex\latex\local\hyphen.cfg you may
+ have defined too many languages to be included. Try to increase
+ the value of the -mt option in the REXX scripts makelatex.cmd
+ and/or latex.cmd. If, however, TeX reports the "trie op size" to
+ have been exceeded, the number of languages loaded must be reduced.
+
+
+If you have any problems installing LaTeX, you should:
+
+ * read the Technical Manual texmf\doc\emtexTDS\manual.eng and the
+ description of the TeX program, texmf\emtex\book\english\tex.inf;
+
+ * if this fails, try asking the emTeX mailing list or a general TeX
+ mailing list;
+
+ * if this fails, send a bug report via email to the author of
+ emTeX/TDS; see the section "Support" in the file readme.eng or
+ install.eng.
+
+
+
+CLEARING UP
+===========
+
+You may now be wondering what to do with all the remaining files in
+the directory texmf\source\latex\base that are not needed to run
+LaTeX. This is, of course, a matter of personal taste and
+availability of disk space but here is some guidance.
+
+ * The files ltnews<xx>.tex contain the LaTeX newsletters. You should
+ run the latest one through LaTeX and nove the resulting dvi file to
+ the directory texmf\doc\latex\base
+
+ * The files with names of the form <xxx>guide.tex contain reference
+ information covering (amongst other things) those features new to
+ this version of LaTeX: they are not intended to be either a user
+ guide or a complete reference for the system. You should run them
+ through LaTeX and move the resulting dvi files to the directory
+ texmf\doc\latex\base, thus replacing the previous versions.
+
+ * The files with extension .dtx, together with source2e.tex,
+ can be used to typeset the documented source code (see texpert.txt
+ for further information).
+
+ * The files with extension .fdd contain the documented sources for
+ the font definition files.
+
+ * The file ltx3info.tex contains information about the LaTeX3 project
+ and how you can support it.
+
+ * The files with extension .txt contain information about (amongst
+ other things) copyright, installation, patches and bug-reports; and
+ those with extension .err contain errata lists for various
+ publications: see 00readme.txt for further details.
+
+ * The file ltxcheck.tex is used to test the format; therefore you
+ should keep it if you expect to remake the format before getting
+ the next full distribution.
+
+ * The files with extension .ins are used to unpack the code from the
+ .dtx and .fdd files.
+
+ * We recommend that you keep, in the formats directory
+ texmf\emtex\htexfmts, the transcript file that was produced whilst
+ creating the format; this file is called latex.log.
+
+
+ --- Copyright 1999--2001 Walter Schmidt and the LaTeX3 project ---
+
+ --- All rights reserved. ---
+