diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/yandytex.txt')
-rw-r--r-- | Master/texmf-dist/doc/latex/base/yandytex.txt | 181 |
1 files changed, 181 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/base/yandytex.txt b/Master/texmf-dist/doc/latex/base/yandytex.txt new file mode 100644 index 00000000000..1f7c88402c0 --- /dev/null +++ b/Master/texmf-dist/doc/latex/base/yandytex.txt @@ -0,0 +1,181 @@ + + LaTeX installation instructions for Y&Y TeX + + 1996 January 1 + +SUMMARY +======= + +This file contains instructions for installing LaTeX 2e for Y&Y TeX. +It describes: + + * How to install LaTeX 2e from the diskette that comes with Y&Y TeX. + + * How to unpack a new LaTeX distribution obtained from CTAN. + + * How to check the LaTeX installation. + + * What to do if you have any problems. + +INITIAL INSTALLATION OF LaTaX 2e: +================================= + +The Y&Y TeX System comes with a LaTeX 2e diskette that includes an +installation batch file. Included is the LaTeX 2e `format' file as +well as the class files. Just type + + a:install (or b:install) + +with the LaTeX 2e diskette in the diskette drive after installing Y&Y TeX +itself. This will put the files in the standard places. Type a:install -? +to see how you can control where the files are installed. + +The Y&Y TeX System also includes a second diskette with LaTeX 2e packages, +which you can install in toto using the batch file on that diskette. +Alternatively, just unzip the files for individual packages as needed. + +REFRESHING YOUR INSTALLATION OF LaTeX 2e: +======================================== + +If you do at some later time want to refresh your LaTeX 2e installation +using the latest files from CTAN, do the following: + +Find the directory on your machine with the LaTeX 2e files --- in the +standard installation this would be c:\yandytex\latex2e. + +(i) Make this `LaTeX 2e directory' the current directory. + +(ii) FTP the files in directory tex-archive/macros/latex2e/base on CTAN + and put them into your `LaTeX 2e directory' (overwriting older + versions of the files in the process). + +(iii) Run TeX on `unpack.ins.' That is, type `tex unpack.ins.' + This will create around 230 files (in perhaps five minutes or so). + +(iv) Now run ini-TeX on `latex.ltx.' That is, type `tex -i latex.ltx'. + +(v) Finally, move the new `latex.fmt' file to the TEXFORMATS directory --- + in the standard installation this would be c:\yandytex\fmt. + +* You now have an up-to-date LaTeX 2e installation! + +You can, if you prefer, call TeX on `unpack.ins' and ini-TeX on `latex.ltx' +directly from the `TeX Menu' in DVIWindo. But then: + +(i) If you use a common working directory for your DVI files, first disable + this by removing the check mark on the `Working Directory' menu item. + This is to make sure files written by TeX and ini-TeX go right back into + the `LaTeX 2e' directory, rather than into the common working directory. + +(ii) You may need to temporarily change the TEXINPUTS environment variable + (in the [Environment] section of `dviwindo.ini' in the Windows directory) + so that it lists the directory with your LaTeX 2e files first. Otherwise + you run the risk of getting complaints about old versions of files like + `docstrip.tex' being picked up from other directories. + +Note: if you have an old installation this may not work correctly because +the ini-TeX call has some LaTeX 2e names hard-wired in, and these names have +changed. In this case call ini-TeX directly from the DOS prompt as above. + +SOME OTHER HANDY TIPS: +====================== + +Creation of the LaTeX 2e format by ini-TeX requires a hyphenation file. For +English, use the file `hyphen.tex' supplied with the system (in the `LaTeX' +directory, which is typically c:\yandytex\latex). If ini-TeX complains that +it can't find `hyphen.tex,' either make sure that it is in one of the +directories listed in TEXINPUTS, or copy it to the `LaTeX 2e' directory. +(By the way, for multilingual use consider the `babel' package). + +It us useful to create `format specific' TEXINPUTS environment variables. +This is handy when you regularly used several different TeX `formats' +(for example, when you need to run both LaTeX 2.09 and LaTeX 2e for some +reason). Use variables named PLAIN, LPLAIN, and LATEX for plain TeX, LaTeX +2.09, and LaTeX 2e respectively (These go into the [Environment] section +of the `dviwindo.ini' file in your Windows directory). + +Note that in the semicolon-separated list specified for TEXINPUTS (or format +specific variable as described above), you can add \ or \\ to the end of a +directory name in order to get one level or recursive directory searching +respectively. This can be convenient if you have many TeX source files in a +hierarchical directory structure, as for example, the LaTeX 2e packages. + +ADDING LaTeX 2e TO AN OLDER INSTALLATION: +========================================= + +Proceed as above, but make sure to add the `LaTeX 2e' directory to the +list of directores in the TEXINPUTS environment variable. For example, + + TEXINPUTS=c:\yandytex\latex2e;c:\packages\psnfss;c:\texinput + +or create an environment variable called LATEX for this purpose (see above). + +Also, create a new `TeX Menu' entry for LaTeX 2e by holding down the +`Control' key and selecting `LaTeX 2.09' from the `TeX Menu.' Edit the +`Menu Item Name' field to read `LaTeX 2e|F7' (or whatever `hot key' +you want to use), and edit the `Application Call Pattern' to read + + tex &latex @.tex + +(in Windows NT, use + or ^& instead of &). Then click `Add.' + +CHECKING THAT THE INSTALLATION WORKED +===================================== + +To check that the installation worked, run the new LaTeX 2e on the file +`ltxcheck.tex'. You can do this from DVIWindo's `TeX Menu.' Simply select +`LaTeX 2e,' and navigate to `c:\yandytex\latex2e\ltxcheck.tex' (or wherever +you placed your LaTeX 2e source files) in the `Open File' dialog. + +It is highly recommended that you run this test before going on! +The test file will check some basic features of your TeX setup and +either say they are OK or complain and say they are BAD. + +After this, you may also wish to process `usrguide.tex' and print the +result, unless you have already done so (and perhaps `fntguide.tex'). +Also note that LaTeX 2e `packages' each come with their own documentation +(which is likely to be more up to date than `The LaTeX Companion'). + +PROBLEMS +======== + +If you have a very old Y&Y TeX System, then it may be set up for the LaTeX 2e +beta test file names. In this case run ini-TeX from the DOS command line. + +If you have other problems with the LaTeX installation, see the `PROBLEMS' +section in `install.txt'. + +If `ltxcheck' produces a `BAD' message, you will typically be able to +figure out from the message what is wrong. For example, you may not +have the environment variable TEXINPUTS set up to include the new +LaTeX 2e files. If it is not obvious what caused the `BAD' message, +then please consult the section on `ltxcheck' in `texpert.txt'. + +WARNING: When using fonts other than Computer Modern, look out for + font naming problems. For example, with LucidaBright + + LucidaNewMath, \usepackage{lucidbry} will use the actual font + names, while \usepackage{lucidbrb} will use Karl Berry names. + +WARNING: When using fonts other than Computer Modern, look out for font + encoding (character layout) problems. LaTeX 2e directly supports + the old `TeX text' encoding (OT1 -- textext.vec), and the new + `Cork' encoding (T1 -- tex256.vec). Use `\input texnansi' for + TeX 'n ANSI encoding, or `\input ansiacce' for Windows ANSI etc. + +Like LaTeX 2e itself, auxiliary files supplied by Y&Y are at times revised +and improved. Check out the `What's New' section on http://www.YandY.com. + +If you have any problems not resolved by the above, please contact Y&Y at: + +tech-help@YandY.com (email) +(508) 371-2004 (fax) +(508) 371-3286 (voice) + +Y&Y, Inc. +45 Walden Street (snail mail) +Concord, MA, 01742, USA + +--- Copyright 1994, 1995, 1996 (C) Y&Y, Inc. and the LaTeX3 project --- +--- All rights reserved. --- + + |