diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/oztex.txt')
-rw-r--r-- | Master/texmf-dist/doc/latex/base/oztex.txt | 128 |
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. --- |