UNZIPPING .ZIP FILES ONTO MACINTOSH
For Visible Software's Source Code Sets

To simplify archiving and downloading, Visible Software supplies its Source
Code Sets in a form that can be read by Macintosh, MS-DOS, Windows, and
UNIX.  For the Macintosh, this document tells you how to unzip/unstuff them
so as to:

AVOID THESE PROBLEMS:

1. Problem: "This document is too large to be opened by Simpletext"
2. Problem: Each line of text files starts with a box; Pascal files have
    bad characters at the beginning of each line.
3. Problem: Files don't have appropriate icons.
4. Problem: Double-clicking a PDF file does not open Acrobat Reader. 
    Double-clicking a text file (like Read-Me.txt) does not open Simpletext.


BEFORE UNZIPPING OR UNSTUFFING:

Avoid problem 1 above by:
- If you haven't already, get a decent programmer's text editor. Simpletext 
  will work for smaller files (<32K), and if desperate a word processor
  can be used by saving the file as "text only".  The right tool is a
  programmer's editor.  We recommend BBEdit. If you want to try BBEdit,
  you can start with the free "lite" version, which has no annoying "Please
  register" messages and no time limit; it may be all you need (URL below).
  
Avoid problem 2 by:
- Get Stuffit Expander 5.1 or later (URL below).  Stuffit Deluxe or similar
  can also be used.  Run Stuffit Expander and Select File->Preferences, 
  then "Cross Platform".  Under "Convert Files to Macintosh Format", check
  the button "When file is known to contain text".
  
EITHER  Repair problems 3 and 4 by:
- After unzipping the .zip and the Macintosh .sit files, use a tool such
  as FileTyper, ResEdit, or "drop here" files (provided with Pascal-S), 
  any of which change file type and creator for the Finder.
  
OR  Avoid problems 3 and 4 now and in the future by the following:
- Open the File Exchange Control Panel, then the PC Exchange tab (pre-MacOS
  8.5, the Control Panel was called PC Exchange), If the option is available,
  check "Open unmapped files on any disk..."  Then...
- Check each of the following extensions in PC Exchange and create if not there. 
  For "(your editor)" below, choose BBEdit, Simpletext or whatever editor
  you plan to use.
  
    PC Suffix  File type  Application program 
     .PDF       PDF        Acrobat Reader
     .SIT       SITD       Stuffit Expander
     .ZIP       ZIP        Stuffit Expander
     .TXT       TEXT       (your editor)
     .PAS       TEXT       (your editor)


NOW UNZIP

- Drop the .zip file onto Stuffit Expander.
- Files should appear (with the appropriate icons, if you did "Avoid 3 & 4").
- Check that text and Pascal files have correct line delimiters.
- Unstuff the Macintosh.sit file.
- If Icons are incorrect, use the "drop here" file type fixers.
- If you want to make other changes to file types, try FileTyper (URL below) 

----------
URLs, verified as of 2002:

BBEdit and BBEdit Lite, Bare Bones Software:  http://www.barebones.com
Stuffit Expander & Stuffit Deluxe, Aladdin Systems: http://www.aladdinsys.com
FileTyper, from Dan Azuma:  http://www.ugcs.caltech.edu/~dazuma/filetyper/

Mac-Zip.txt, revised 20 April 2002