summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/base/oztex.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/oztex.txt')
-rw-r--r--Master/texmf-dist/doc/latex/base/oztex.txt128
1 files changed, 128 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/base/oztex.txt b/Master/texmf-dist/doc/latex/base/oztex.txt
new file mode 100644
index 00000000000..9a78c38249b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/base/oztex.txt
@@ -0,0 +1,128 @@
+
+ LaTeX installation instructions for OzTeX
+ =========================================
+
+ March 2002
+
+NOTE: LaTeX is installed and ready to use in OzTeX 5.0 or later.
+If you have an older version of OzTeX then please upgrade; you can find
+download links at OzTeX's web site:
+
+http://www.trevorrow.com/oztex/
+
+This document assumes you have OzTeX 5.0 or later and wish to update
+the supplied version of LaTeX.
+
+
+SUMMARY
+=======
+
+Before reading this file, you should read install.txt which explains
+how the LaTeX installation works in more detail.
+
+The following sections describe:
+
+ * How to override the old version of LaTeX.
+ * How to unpack the LaTeX distribution.
+ * How to create the LaTeX format.
+ * How to check that the installation worked.
+ * Removing unnecessary files.
+
+
+OVERRIDING THE OLD VERSION OF LATEX
+===================================
+
+All LaTeX-related files are stored inside :TeX:Inputs:LaTeX: but it is
+best not to change anything in that folder because your changes will be
+clobbered if you upgrade to a new version of OzTeX. Instead, you can
+override the supplied version of LaTeX very easily by creating a new
+folder called something like "mylatex" and then adding a line like this
+in the OzTeX-only section of your Local config file:
+
+ input_folders = hd:mylatex:* $c
+
+This tells OzTeX to search your folder before the supplied folders.
+
+
+UNPACKING THE DISTRIBUTION
+==========================
+
+To unpack the LaTeX distribution:
+
+ * Put the files downloaded from tex-archive/macros/latex/base into
+ a base subfolder inside your new LaTeX folder.
+
+ * Start up OzTeX.
+
+ * Select "TeX..." from the TeX menu and use the open dialog to find
+ unpack.ins in the base folder, but do NOT open the file. Instead,
+ select Cancel. This sets OzTeX's current folder.
+
+ * Select INITEX from the TeX menu.
+
+ * Type "unpack.ins" in response to the ** prompt and hit Return.
+ This will start the unpacking process -- it shouldn't take too long.
+
+If you also downloaded new versions of tools, graphics, psnfss, etc.,
+you can easily unpack the various *.ins files by ticking the LaTeX
+format in the TeX menu and simply dropping a .ins file onto the
+OzTeX application.
+
+
+CREATING THE LATEX FORMAT
+=========================
+
+To create a new LaTeX format:
+
+ * Select INITEX from the TeX menu.
+
+ * Type "latex.ltx" in response to the ** prompt and hit Return.
+
+ * After a short while you will be asked to save the LaTeX format.
+ Save it as latex.fmt in a suitable location inside your new LaTeX
+ folder and make sure OzTeX searches that location before the Default
+ format folder by adding a line like this in your Local file:
+
+ format_folders = hd:mylatex:formats: $c
+
+You might discover at a later date that one or more TeX parameters need
+to be increased to typeset your documents. If so, make the parameter
+changes in your Local file. Depending on which parameters (see the notes
+in the Default file) you might also need to build a new format file.
+
+
+CHECKING THAT THE INSTALLATION WORKED
+=====================================
+
+To check that the installation worked:
+
+ * Move the file ltxcheck.ltx out of the base folder.
+ (It doesn't matter where you move it, just so long as it is not in the
+ same folder as the file article.cls. If this file is in the same
+ folder then LaTeX will definitely be able to read it and so cannot check
+ if it is possible to read files that are NOT in the current folder.)
+
+ * Tick the LaTeX format in the TeX menu.
+
+ * Drop the ltxcheck.ltx file onto the OzTeX application.
+ This will run a test of the LaTeX installation, and should produce "OK!"
+ to a number of tests. If it does not, see PROBLEMS in install.txt.
+
+ * Delete the .log and .aux files created (and move ltxcheck.ltx back to
+ the base folder if you like).
+
+You have now installed LaTeX.
+
+
+REMOVING UNNECESSARY FILES
+==========================
+
+After LaTeX has been successfully installed, you might want to delete some
+non-essential files to free up space on your hard disk. You can safely
+delete all files ending in:
+
+ .ins .dtx .fdd
+
+
+--- Copyright 2002 Andrew Trevorrow and the LaTeX3 project. ---
+--- All rights reserved. ---