Dear Macaulay User: (12 September 94)

This note explains how to obtain and install the latest version of the
computer algebra package Macaulay, which we are making freely
available to the mathematical community. This note is also the
"readme" file for the directory "~ftp/Macaulay" on "math.harvard.edu"
(128.103.28.10), and the directory "~ftp/pub/bayer/Macaulay" on
"math.columbia.edu" (128.59.209.11).

Macaulay can be obtained self-service, using the "ftp" file transfer
protocol. We are maintaining up-to-date copies of Macaulay on the
Harvard mathematics department ftp server. We would like to thank the
Harvard math department, and Richard Silverman, for providing this
service.

    Dave Bayer (Barnard Coll.)    Mike Stillman (Cornell Univ.)

    Department of Mathematics     Department of Mathematics
    Columbia University           Cornell University
    New York, NY 10027            Ithaca, NY 14853
    (212)854-2643, 864-4235       (607)255-7240, 257-5320
    dab@math.columbia.edu         mike@math.cornell.edu

Please send any bug reports, proposed code changes, etc. to BOTH
of us! You never know who's watching the horses from month to month.

*******************************************************************
TABLE OF CONTENTS:

Recent changes
To download Macaulay components
Summary of available components
Msource.tar
Mscripts.tar
Mdocs.tar
MacaulaySIOW.hqx
MacaulayTOOL.hqx
MacaulayDOCS.hqx
MacaulaySCRIPTS.hqx
Unix installation guide

*******************************************************************
Recent changes:

As of 12 Sep 94, three new commands have been added: "binoms",
"monoms", and "monprimes". The first two construct binomials and
monomials from matrices, and the third computes the isolated primes of
monomial ideals. These commands are described in the latest version of
"release_notes.tex". Many changes have also been made to the scripts
in "scriptsde". Also, a bug fix for the ring_sum command, and improved
code respecting signs for the wedge command were contributed by
John Dalbec of Cornell University. Thanks!

*******************************************************************
To download Macaulay components:

The following input sequence to a Unix machine hooked up to internet
should succeed in downloading the Unix components of Macaulay:

ftp math.harvard.edu
ftp
name@email.address
binary
cd Macaulay
ls -l
get Msource.tar
get Mscripts.tar
get Mdocs.tar
quit

In other words, one obtains these files by "anonymous ftp".  One
invokes the "ftp" command with the address of the Harvard mathematics
department, giving "ftp" as the login name and one's email address as
the password. "ftp" MUST then be put into binary mode to insure all
bits of these files are transferred!

Now, "cd" to the directory Macaulay, and use "ls" to see what files
are available, and which files have changed since you were last
there. You should first get the most current version of this file,
"readme", then get whatever other files you want. If neither
math.harvard.edu nor 128.103.28.10 answers, try again later.

You may also check the directory "pub/bayer/Macaulay" on
"math.columbia.edu" (128.59.209.11), which is a mirror site for
the Macaulay distribution.

*******************************************************************
Summary of available components:

We are distributing Macaulay in a modular fashion, which minimizes ftp
site disk usage, and eases our updating the different components at
different rates. The complete Unix version consists of

readme
Msource.tar
Mscripts.tar
Mdocs.tar

Once you have downloaded these files to your Unix machine, use the tar
command to unpack them, e.g. "tar xf Msource.tar".

The complete stand-alone Macintosh version consists of

readme
MacaulaySIOW.hqx
MacaulayDOCS.hqx
MacaulaySCRIPTS.hqx

The complete Macintosh "MPW Tool" version consists of:

readme
MacaulayTOOL.hqx
MacaulayDOCS.hqx
MacaulaySCRIPTS.hqx

The MPW Shell is required to use this version, and must be obtained
separately from Apple. We may get a license to distribute the MPW
Shell freely, but we don't have such a license at present.

Each of these Macintosh files is a bin-hexed self-extracting archive.
Get help and tools via anonymous ftp from sumex-aim.stanford.edu if
you don't know what to do with such files.

Other files posted in this directory are not current or documented.
Current versions of Macaulay for other platforms will be posted and
described here as they become available.
	
*******************************************************************
Msource.tar:

Macaulay.help		src/

This component contains the complete source code for Macaulay, the
latest release notes, and the Macaulay.help file. Macaulay.help is
somewhat out of date; it needs to be found somewhere in Macaulay's
file search path to be used.
	
*******************************************************************
Mscripts.tar:
	
scriptsde/	scriptsmj/	scriptsms/

These scripts directories, arranged by author, also need to be
included in Macaulay's file search path.

*******************************************************************
Mdocs.tar:

Tutorial.hqx		man/
biblioreference.tex	release_notes.tex
	
These are various documents associated with Macaulay. The "man"
directory contains a lengthy latex manual. The Tutorial is a Macintosh
bin-hexed self-extracting archive, which is shorter and more current.
The release notes give documentation specific to the latest version of
Macaulay.  Please use the bibliographic reference, or something like
it, to cite Macaulay in published work which it assists.

*******************************************************************
MacaulaySIOW.hqx:

This is the Macintosh stand-alone version of Macaulay, as a bin-hexed
self-extracting archive. It requires scripts, available separately.
	
*******************************************************************
MacaulayTOOL.hqx:
	
This is the Macintosh MPW Shell version of Macaulay, as a bin-hexed
self-extracting archive. It requires scripts, available separately.
It also requires the MPW Shell, available from Apple.

*******************************************************************
MacaulayDOCS.hqx:

This contains some documents associated with Macaulay. The full set of
documents can be found in Mdocs.tar.
	
*******************************************************************
MacaulaySCRIPTS.hqx:

This is a duplicate of the contents of Mscripts.tar, as a bin-hexed
self-extracting archive. It is required with each Macintosh version of
Macaulay.
 	
*******************************************************************
Unix installation guide:

To make Macaulay on a Unix machine equipped with the GNU C compiler,
type "make" from within the "src" directory of Msource.tar. If this
doesn't work, or you need to use a different C compiler, edit the
makefile and try again; the makefile includes further directions.
Rename Macaulay.bin to Macaulay and put it somewhere public, on every
user's Unix search path.

You may want to localize "mac.c" by hard-wiring a definition of
MclyPath which cites the current directory, the location of
"Macaulay.help", and the locations of the script directories, for your
installation. Read the section on path handling in the release notes,
to better understand this issue.
	
*******************************************************************