READ ME FIRST!

The distribution disk contains the following:

CMDS      This is the directory on which to perform the CMDPATH command or
          copy to the CMDPATH directory as instructed by the opening section
          of the Proton Command Reference Manual.  This directory contains all
          of the 8-bit Apple commands.

GS.CMDS   This contains supplementary commands specifically for the IIGS.
          Copy them or use them as instructed by the opening of the IIGS sup-
          plement manual.

DEMOS     This contains demonstration programs written the Proton programming
          language.  These demo programs merely perform screen display
          acrobatics of some sort:
               HGR.BLIPS - Demos Hi-Res screen memory access
               GR.PATTERN - Demos Lo-Res graphics
               DOUBLE.PATTERN - Same as GR.PATTERN but with Double Lo-Res
               COLOR.STATIC - Demos Lo-Res graphics with block moves.
          The program MAKE.MAZE accepts one file name parameter.  It requests
          a size (number of ASCII lines), builds a maze to fit, and writes the
          maze to the given file, in ASCII character form.
          The program TRANS.UPPER takes two file name parameters: an input
          file and an output file.  It copies the first file to the second; as
          it copies, it converts each lower case character to upper case.

GS.DEMOS  These demo programs utilize the GS Toolbox and are described in the
          GS supplement.

SOURCE    The text files in here contain the source for all of the programs in
          the DEMOS directory.

GS.SOURCE The text files in here contain the source for a couple of the pro-
          grams in the GS directory.

PICS      The BIN files in here contain GIF graphics.  Use the following IIGS
          commands to view a GIF file (the TEMP files may need to go on a
          separate disk). These commands may take several minutes.
               EXPANDGIF gif.file TEMP.EXP
               MAKEPNT   TEMP.EXP TEMP.PNT
               VIEWPNT   TEMP.PNT
          Try the MAKEPNT -ca option for the DIABLO gif file.
          The PNT files can be view with VIEWPNT directly.

DOCS      Documentation for the system.  PROTON.TXT contains installation
          instructions and a summary of the PCS commands.  PROTLANG.TXT
          contains information about programming in the Proton programming
          language.  GS.SUPP.TXT contains information about additional GS
          specific features.

The source directories contain include library files (in a subdirectory called
LIB) that are used by the demos.  These library files may be useful to you as
well.  Browse the LIB files; the comments in them describe how to use the var-
ious routines.

Error alert:  Under rare conditions (and unknown conditions) the editor (i.e.
the EDIT command) may crash (with a Proton run time error) when selecting text
for copy or deletion.  Specifically this can happen when marking the origin at
the end of the selection, moving the cursor to a previous point in the text file
and then performing a copy or paste.  Recommendation:  Select the beginning
of the desired text with the Mark Origin command (control-O) and then use
the copy or paste command at the end of the selection (rather than the other
way around).

If you can reproduce the above error, or any other, let me know.  Comments are
welcome too.

Brian D. Campbell   Internet: brian.campbell@worldnet.att.net