Capsule Summary:
----------------

	setenv CAD_HOME /a/new/empty/directory
	make config
	make install

Notes to Magic maintainers:
--------------------------

    This directory contains all the sources for the Magic system and related
    programs.  The system runs on a number of machines.  You should read the
    Magic Maintainer's manual as well as the introduction to Magic before
    compiling the system.  These documents are in the "doc" subdirectory in
    ditroff/gremlin format as well as in Postscript.
    
    The compilation process happens in three steps.  
    
    (1) To configure the system for a particular machine, set your
    CAD_HOME environment variable to where you would like to install
    magic and then run "make config" and answer the questions.  This
    sets up compile flags in misc/CFLAGS and misc/DFLAGS.

    (2) To then compile the system, type "make force".  If you are
    porting magic to a new system, your first step should be to set up
    the constants at the end of misc/magic.h.  If you have partially
    compiled magic, you can use "make everything" in order to just
    recompile what is needed.  If there are problems, however, it is
    best to do a "make force" to ensure that everything indeed gets
    recompiled.

    (3) When you are happy with it, do a "make install" to set up a
    tree stucture in the directory described by your CAD_HOME
    environment variable.

    See Maintainer's Manual #1 for more information on how the sources
    are organized and what compile-time options are available.

Utility programs and libraries (ext2sim, magicusage, prleak):
    In addition to Magic, this directory contains several additional utility
    programs.  These are described briefly in Maintainer's Manual #1, and
    more fully in their respective man pages.  Each programs resides in a
    different subdirectory of this one.  If you want to recompile any of these
    programs, you'll need to re-make the rest of Magic, since they use modules
    from Magic.

Updates on the Net:
-------------------
Use your World Wide Web browser to read:

	http://www.research.digital.com/wrl/magic/magic.html

If you don't have web access, use FTP to following site:

        machine:    gatekeeper.dec.com   (16.1.0.2)
        account:    anonymous
        password:   guest
        directory:  pub/DEC/magic/6.4/notes

What's new in 6.4:
------------------
This release, magic 6.4, contains the following modifications:

	1) A number of bug fixes from the 6.3 notes.

	2) A version numbering facility for tech files.  Please add a new 
	   section to each tech file after the "tech" section, following 
	   this example:

		version
		    version 2.0.3
		    description "MOSIS CMOS 0.13u Nano-nano technology."
		end
		    
	   Older versions of magic will complain about the new section, but
	   no harm will be done.

	4) Various comments describing dates and versions, including the
	   above tech file information, are not written to the CIF file.

	3) Support for patches and versioning:  A new command called "version"
	   lists out the version number and patches that are installed.
	   A header file called patchlevel.h keeps track of a PATCHLEVEL 
	   integer and a string in patchlevel.c keeps track of the names of
	   each installed patch.  When posting patches to the net please be
	   sure your patch updates variables.  See the files for details.

	4) Ports to Alpha AXP OSF/1, SGI/IRIX (courtesy of Stefanos 
	   Sidiropoulos) and Linux (courtesy of Harold Levy).

	5) A change in the extractor algorithm to provide shielding for
	   perimeter capacitances. Also a change in ext2sim to maintain
	   information about the area and perimeter of diffusion and
	   the bulk connection of the fets (written by Stefanos
	   Sidiropoulos).
