Date: Thu, 9 Feb 1995 20:02:19 +1030 From: atrevorr@maths.adelaide.edu.au (Andrew Trevorrow) Subject: OzTeX 1.8; an implementation of the TeX typesetting system I've just put all the distribution files for OzTeX 1.8 in Incoming/oztex/. Here's some brief info about OzTeX (suitable for comp.sys.mac.digest): OzTeX is a shareware implementation of Donald Knuth's TeX typesetting system. All the important changes in version 1.8 are listed in the Read-Me file. The most significant new feature is the inclusion of dvips and Metafont (courtesy of Tom Kiffe). Happy OzTeXing, Andrew Trevorrow atrevorr@maths.adelaide.edu.au Installation notes for OzTeX 1.8 ================================ Andrew Trevorrow, February 1995 atrevorr@maths.adelaide.edu.au ADVANCE NOTICE: A native PowerPC version of OzTeX should be available within a couple of months. At that time the shareware fees will increase (probably to $40 for an individual and $200 for a group). If you haven't paid for OzTeX yet then now would be a good time. Note that payment covers you for ALL future versions. CONTENTS: Introduction How to install OzTeX How to print the OzTeX User Guide Choosing an editor How to install dvips and Metafont Important changes The new LaTeX distribution A minimal OzTeX system Introduction ------------ OzTeX is a shareware implementation of TeX for the Macintosh. This file explains how to install OzTeX and print out a copy of the OzTeX User Guide. OzTeX is normally distributed as a set of hqx files. After decoding all the hqx files you should have the following set of StuffIt archives: oztex.sit -- Contains OzTeX, OzTools, Correct, and these folders: Configs, Help-files, TeX-docs and LaTeX-docs. oz68000.sit -- Contains OzTeX and OzTools for Macs with 68000 CPUs. inputs.sit -- Contains the TeX-inputs folder. formats.sit -- Contains the TeX-formats folder. fonts.sit -- Contains the TeX-fonts folder. vf.sit -- Contains the VF-files folder. ps.sit -- Contains the PS-files folder. pk.sit -- Contains the PK-files folder. dvips.sit -- Contains Tom Kiffe's dvips (requires System 7). mf.sit -- Contains Tom Kiffe's Metafont (requires System 7). bbedit.sit -- Contains Rich Siegel's BBEdit Lite. anagrams.sit -- Contains the Anagrams folder (an optional extra). register.sit -- Contains the Register folder. The Register program provides an alternative way to pay for OzTeX (and/or Anagrams). In particular, it allows for payment by credit card; this should be cheaper and easier for most people outside Australia. Current OzTeX users should note that the PK-files folder contains a minimal set of PK fonts suitable for previewing and printing the OzTeX User Guide at some common resolutions (144, 300 and 360 dpi). I no longer distribute a large selection of PK files because OzTeX can now call Metafont to build missing PK files on demand. People who use OzTeX under System 6 might want to keep their current TFM and PK files, but I recommend getting a Metafont program that runs under System 6 and building new TFM and PK files based on the latest Metafont input files. PLEASE NOTE: There is a separate shareware fee for Tom Kiffe's programs. Send US$25 for a single user, or US$100 for a site license, to Thomas R. Kiffe P.O. Box 516 College Station, Texas 77841 USA. For more information, send e-mail to tkiffe@math.tamu.edu. I hope all OzTeX users who make use of Metafont and/or dvips will support Tom's work. To save some space, I've created minimal versions of dvips and Metafont. The above shareware fee covers you for Tom's full CMacTeX distribution which is available at any CTAN site or mirror in /tex-archive/systems/mac/cmactex. (The main CTAN sites are ftp.shsu.edu, ftp.tex.ac.uk and ftp.dante.de.) CMacTeX contains a lot of other stuff that you might find useful, including native PowerPC versions of dvips and Metafont. How to install OzTeX -------------------- If you already have an older version of OzTeX then you should install this new version in a new folder to avoid clobbering any of your own fonts, config files, TeX input files, etc. Once you have the new version up and running you can merge in your own modifications. Assuming you have enough disk space, carry out the following steps: 1. Create an empty folder on your hard disk and call it anything you like. "OzTeX" would be a good choice! (If you used StuffIt Expander to unpack the hqx files then it should have already created such a folder.) 2. Use StuffIt or UnStuffIt to unpack all the *.sit files. (StuffIt Expander will have already done this.) 3. Make sure all the files and folders listed in the Introduction are at the same level as the OzTeX application. To check this, double-click on the "Correct" file. This is a TeachText/SimpleText document containing a picture of a correctly installed OzTeX folder. Make sure your new folder looks the same! OzTeX should now be ready to run. How to print the OzTeX User Guide --------------------------------- 1. Start up OzTeX by double-clicking on the application. It should load the Default configuration file stored in the Configs folder, and an encoding file. If you get any warning messages about unknown folders or files then you've made a mistake in the above installation. 2. OzTeX is set up to print on A4 paper. If your printer uses US Letter paper then select "US Letter" from the Config menu. 3. Select "Page Setup..." from the File menu and check that the paper size and orientation are correct. 4. If you are using a StyleWriter (or any 360 dpi printer) then select the "StyleWriter" item in the Config menu. If you have an ImageWriter (or any 144 dpi printer) then select the "ImageWriter" item. 5. Select "Print DVI..." from the File menu and open ozuser.dvi in the LaTeX-docs folder. 6. When the print dialog box appears, select suitable options (you might want to reverse the page order if your printer stacks pages face up) and click on the Print button. Once the User Guide is printed you might like to read it! Users of OzTeX 1.7 should note that the following sections have been added or substantially revised: - Configuration files - Printing a DVI file - Rotating TeX material (has changes for standard PostScript printing) - LaTeX - OzTeX and Metafont - OzTeX and Dvips Choosing an editor ------------------ OzTeX does not contain an integrated text editor. Instead, Rich Siegel's BBEdit Lite is supplied. The BBEdit Lite folder contains the application and its documentation. You might prefer to use another editor. Pete Keleher's Alpha is a popular editor for TeX/LaTeX input files. I decided to distribute BBEdit Lite because it is free, much smaller than Alpha, and does not require System 7. Another alternative for Unix fans is Eric Fisher's Mac Vim. Nearly all the text files distributed with OzTeX are created by MPW (that's the editor I prefer to use). Note that BBEdit Lite comes with a small application called TextChanger which lets you change the creator of all text files in a folder. If you are using System 7 then one of the first things you should do after starting up OzTeX is select "Choose Editor" from the Edit menu. Use the standard file dialog to select the application you'll be using to edit your TeX/LaTeX input files. If the application can receive Apple events then OzTeX will remember its name and location for later use. How to install dvips and Metafont --------------------------------- These programs require System 7. To call Metafont from OzTeX you will need about 1.5Mb of free memory (after OzTeX has started). To call dvips requires 1Mb of free memory, and for dvips to call Metafont then another 1.5Mb must be available. Of course, if you don't have access to a PostScript printer then you can forget about dvips. Before you can use dvips or Metafont you must carry out these steps: 1. Move the tex.config file from either the Dvips or Metafont folder and put it in your System's Preferences folder. Delete the other copy of tex.config (two copies are included in case people decide to get only one of the folders). 2. Edit dvips.env in the Dvips folder and change the HOME string from "/HD/OzTeX" to a string indicating the full path name of your OzTeX folder. Note the use of "/" rather than ":". 3. Edit texmf.env in the Metafont folder and change the HOME string from "/HD/OzTeX" to the same string used above. 4. Both .env files also contain a PASSWORD string. After you pay Tom's shareware fee he will send you the correct string to remove the reminder dialogs. 5. Like OzTeX, dvips needs to be told which fonts are PostScript fonts (and which ones must be downloaded to the printer). This information is obtained from a file called psfonts.map in the ps sub-folder of Dvips. I've set up psfonts.map so that it matches the list of PostScript fonts at the end of OzTeX's Default config file. If you use a different set of PostScript fonts (like the CM/PS fonts from Blue Sky Research) then you must carry out these steps: a. Edit psfonts.map and append (or prepend) the information I've provided in the files psfonts.CM/PS, psfonts.Lucida or psfonts.MathTime, depending on which fonts you have. b. Edit dvips.env and add the full path name for the location of your Mac printer fonts (LWFN files) to the DVIPSHEADERS variable. For example: DVIPSHEADERS .:~/Dvips/ps:~/PS-files:/HD/System/Fonts Important changes ----------------- Apart from the addition of dvips and Metafont to the OzTeX distribution, current users also need to be aware of these important changes: - You can now use the standard Mac print dialogs when printing a DVI file or text file to a PostScript printer. Just tick the new flag in the File menu called "Use Standard PostScript". If you do so, remember that the "Page Setup" dialog must be used to select the paper size and orientation. You can also select other handy features like 2-up printing if you have a LaserWriter 8.x print driver. Although there are significant advantages to using standard PostScript, there are some disadvantages. There is a limitation in LaserWriter print drivers older than version 8 that causes a PostScript error when printing all but the simplest of DVI files. OzTeX is able to predict when this error is likely to occur and will display a suitable warning message. Standard PostScript code takes longer to print and saved PostScript files are a little bit larger. If you want to keep using OzTeX's more efficient low-level printing code then leave "Use Standard PostScript" unticked. - The "Force PostScript" and "Force Non-PostScript" flags have been removed from the File menu. - The "Copy to Clipboard" item has been renamed to "Copy OzTeX Window" and moved from the File menu to the Edit menu. The "Font" and "Size" items are also now in the Edit menu. - Substantial changes to the View menu items and their corresponding keyboard short cuts have been made: - Use Cmd-O rather than Cmd-W to select the "View foo.dvi" item. Hit "o" (instead of "w") to open the most recent page. - Cmd-W is now used to select the new "Close foo.dvi" item. You can also hit "w" (instead of "k") to close the view window. - Use Cmd-I rather than Cmd-G to select "Page Info". - "Select Page" is now called "Go to Page" and Cmd-S replaced by Cmd-G. Hit "g" (instead of "s") to go to a given page. - Cmd-I and Cmd-O no longer select "Zoom In" and "Zoom Out". These changes have been made for better compliance with Apple's user interface guidelines. I apologize for not making these changes earlier. (Note that ALL the changes can be reversed by using ResEdit to edit the appropriate MENU and STR resources in OzTeX.) - Use Option-Command-click in the view window to temporarily magnify a small area under the cursor (the scale factor is set to 1 in that region). The area remains magnified until the mouse button is released. - Users who have been creating PICTs at large sizes and then scaling them down in the \special command should stop doing so. OzTeX now uses the current printer resolution (rather than 72 dpi) to create bitmaps for printing PICTs. - A new version of boxedeps.tex is supplied; it contains a new definition of \SetOzTeXEPSFSpecial that works with both dvips and OzTeX, so you won't need to make any changes to your input files. - The search algorithm for EPSF/PICT/PNTG \special files is now the same as that for TeX input files: OzTeX looks in the current folder first, then in the TeX input folder(s). This matches the search algorithm used by epsf.tex and boxedeps.tex when TeX looks for an EPSF file. - The printer and viewing resolutions in a config file are now followed by strings specifying the mode that Metafont will use when making missing PK fonts. The Default config file sets both mode strings to "laserwriter". - The reserved parameter in the folders and files section of a config file is no longer reserved. It now specifies the name of the file in which OzTeX will append missing PK font information. The Default config file sets the name to ":PK-files:missfont.log" for compatibility with dvips. - The DVItoPS.ps and TEXTtoPS.ps files in the PS-files folder now end in ".pro" rather than ".ps". This agrees with Adobe's conventions for such prolog files. It also means that these files no longer appear in the open file dialog when you select "Send PostScript..." from the File menu. The Default config file has been updated to use these new file names. - Apart from the name change, DVItoPS.pro has been substantially revised. Various PostScript procedures have been rewritten and in some cases renamed: "@newfont" is now "newPKfont" and "PSfont" is now "newPSfont". OzTeX now calls the newPSfont procedure only ONCE for each PostScript font used in the DVI file (it used to be called once per font per page). This change should help people who want to implement an efficient font re-encoding scheme. - The PS-files folder contains a new file called OzTeXdict.pro that is used by OzTeX if "Use Standard PostScript" is ticked when printing a DVI file. The PostScript code in OzTeXdict.pro is very similar to DVItoPS.pro, but there are some subtle differences. I decided it would be unsafe to allow inclusion of a global.ps file when using standard PostScript, but I have allowed for similar tricks by making OzTeX look for OzTeXdict.pro in the current folder before looking in the PS folder(s). - OzTeX is now smarter about downloading a non-resident PostScript font. It downloads such a font at the start of the first DVI page that uses it. Previously, OzTeX would download ALL non-resident fonts used in the DVI file, even if you selected pages that didn't actually use any of them. - All the TFM files in the CM and LaTeX sub-folders in TeX-fonts have been rebuilt using Tom's up-to-date Metafont sources. This guarantees that any new PK files you build will have the same metrics as the TFM files. I recommend you delete ALL your old PK files and let Metafont build new versions as they are required. If you decide to keep your PK files then you should also keep the corresponding TFM files. - The old LaTeX 2.09 files and format are no longer distributed with OzTeX. The next section explains what you need to do if you want to use the old LaTeX system alongside the new version. - To cope with a few of the documents in the new LaTeX release, I've had to increase some TeX parameters in the Default config file. The pool_size has increased from 55000 to 60000, and mem_top has increased from 50000 to 60000. The latter change meant rebuilding all the format files. (If you have your own format files then you must also rebuild them, assuming they rely on the Default file's TeX parameters.) The OzTeX application's preferred memory size is now 1500K. Full details of what's new in version 1.8 can be found by selecting "Changes to OzTeX 1.7" from the Help menu. The new LaTeX distribution -------------------------- LaTeX2e is now called LaTeX, and the latest version is in this release. Because LaTeX2e.fmt is now called LaTeX.fmt, it is a good idea to delete ALL existing log files for your LaTeX documents so that OzTeX won't get the wrong format by looking in a log file. The old LaTeX 2.09 files and format are no longer distributed with OzTeX. LaTeX users should seriously consider switching to the new LaTeX (it can typeset LaTeX 2.09 documents in "compatibility" mode). If you must keep using the old LaTeX 2.09 format then carry out these steps: - Edit the new Default config file and insert "New LaTeX" and "Old LaTeX" anywhere in the list of config files. - Take the LaTeX sub-folder out of your OLD TeX-inputs folder, rename it "Old LaTeX" and put it next to (NOT inside) the new TeX-inputs folder. If you want to store the Old LaTeX folder somewhere else then you'll have to change the appropriate path in the Old LaTeX config file. - Build OldLaTeX.fmt (no space in the file name!): - Start up OzTeX and select Old LaTeX from the Config menu. - Run INITEX, type "lplain\dump" and hit Return. - Save the format as OldLaTeX.fmt in the TeX-formats folder. Before typesetting a LaTeX 2.09 document you must remember to select Old LaTeX from OzTeX's Config menu, and before typesetting a new LaTeX document you must select New LaTeX. NOTE: The LaTeX system included with OzTeX is NOT a full distribution (which is way too big for most OzTeX users). After installing the base files and a few important packages, I deleted all the .dtx, .ins and .fdd files, as well as a few other files that were irrelevant for OzTeX users. If you need a file or package not provided in OzTeX, then you can ftp it from any CTAN site or mirror. The following table should help: Sub-folder in TeX-inputs Corresponding CTAN directory LaTeX /tex-archive/macros/latex/unpacked Graphics /tex-archive/macros/latex/packages/graphics PSNFSS /tex-archive/macros/latex/packages/psnfss Tools /tex-archive/macros/latex/packages/tools If you only need one or two files then ask me first and I might have a copy I can send by e-mail, but you must be a registered OzTeX user! A minimal OzTeX system ---------------------- You may be running short of space on your hard disk, so let's consider the bare essentials needed for a working OzTeX system (before deleting any files it would be a good idea to save a backup copy of the complete OzTeX distribution): - You won't need both sets of OzTeX and OzTools in oztex.sit and oz68000.sit. Try the applications in oztex.sit first; if they start up then delete the 68000 versions. - If you won't be creating any TFM or VF files then delete OzTools. - TeX-docs and LaTeX-docs contain important documentation and example files, so don't remove any files from these folders until you've looked at them. - If you don't use LaTeX, delete the LaTeX sub-folder from TeX-inputs, as well as the Graphics, PSNFSS and Tools sub-folders. - Delete any format files that you don't intend using from TeX-formats. Don't delete TeX.pool though; it's needed by INITEX. - If you won't be using PostScript fonts then delete all files in the VF-files folder and delete the PS sub-folder in TeX-fonts. - The BBEdit Lite folder can be deleted if you use a different text editor. - Delete the Dvips folder if you don't have access to a PostScript printer, or you are still using System 6. - Delete the Metafont folder if you have a full set of TFM and PK files, or you are still using System 6. Happy OzTeXing!