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!
