Chapter I: INTRODUCTION
 |
Macintosh Installation |
 |
Macintosh users must run System 7 or later.
Electric compiles best under Metrowerks version 1.7, although it has been
built with MPW 3.0 and THINK_C 5.0.
A Metrowerks project file is included.
The Electric distribution is a single file in UNIX "tar" format, GNU-zipped.
You will have to find a Macintosh program that can read this file
("MacGzip" and then "tar" or "SunTAR", for example).
See http://www.gzip.org for
more information.
To install Electric, follow this procedure:
- Extract the contents of the "tar" file.
This will create a top-level directory called electric-VERSION with four subdirectories:
src, lib, examples, and html.
- Beware of Macintosh line-feed conventions, which are different from those on other
operating systems.
You may need to set the "Convert Newlines" option before extracting the "tar" file.
To be sure that the extraction has worked properly, examine the file cadrc, which
is in the top level directory.
This file should have about 10 lines of text.
If the file appears as a single line, or if there are spurious unprintable characters
at the start or end of each line, then the text conversion has been done
incorrectly and you will have to try again.
- The Metrowerks project can be found in electricproject.sea.hqx
which is a Stuffed and BinHex'ed file.
Simply drag this file onto "Stuffit Expander" to extract the project file,
which is called Electric.u (where the "u" is actually a Greek "mu").
Keep this file in the top level (alongside the src directory).
- Double-click the Metrowerks project file and compile Electric.
This will create the application Electric.
Note that the program is rather big, so you may have to increase the size
of the Metrowerks partition to get it to compile.
- Double-click the Electric application to run the system.
Here are some detail on the Electric distribution:
- The src directory contains the source code.
It is hierarchically organized by function.
- The html directory contains one subdirectory, manual, which is
this manual in HTML format.
To see the document, point your browser to the file index.html
inside of the manual directory.
Note, however, that the subdirectory images in the manual
directory contains all of the image files, which are binary and probably
did not survive the tar extraction process.
Therefore, all of these files are duplicated in the file AllImages.sea.hqx,
which is a Stuffed and BinHex'ed file.
Simply drag this file onto "Stuffit Expander" to extract proper versions of
the image files.
The resulting images folder should replace the existing one.
- Electric makes use of an initialization file (cadrc) and a
library directory (lib) with other necessary files.
The file cadrc can be located in the same place as the Electric
application, or in the library directory.
If the file cadrc cannot be found, Electric will have
no graphical user interface and will function only in its native command-line mode
(just type "-quit" to kill it).
Therefore, if you move the cadrc file,
you must change the #define of "LIBDIR" in the source file
src:include:config.h to tell Electric where to find it.
If you wish to move the library directory, you must edit
the cadrc file and correct the "library default-path" command
(this command overrides the "LIBDIR" define).
When Electric is being used in a shared environment,
the lib directory should be in a shared location which is
coded into the "LIBDIR" define, and
the cadrc file should be inside of this directory.
You can then remove the "library default-path" command from the cadrc
file, or set it to the current location.
- The examples directory has some demo files.