Mac OS X

k There are now two ways to install Macaulay2 under Mac OS X:

• installing using brew
• downloading a disk image

We describe both of them below.

---

Installing using brew

Mahrud Sayrafi has created a homebrew tap containing a binary distribution of Macaulay2, which makes installation of Macaulay2 easy, once you've installed "brew" according to the instructions at homebrew. Install Macaulay2 with the following command.

  brew install Macaulay2/tap/M2

You will now find the program M2 on the path `brew --prefix M2`/bin/M2. You may need to use this long form once to evaluate setup(), in case the command M2 runs a previously installed version; the settings take effect the next time you log in.

If there are any problems with this procedure, please check the "issues" at homebrew-tap/issues, and create a new one if you don't see a discussion of the problem you're having.

---

Downloading a disk image

Here are the downloadable disk images and their corresponding signature files (see PublicKeys); the name of the file incorporates the architecture and Mac OS version number. Starting with Macaulay2 version 1.18, we no longer make all of these disk images, since the homebrew installation (above) is available.

Installation

After downloading, mount the disk image by clicking on it in your browser or by double-clicking on it in a Finder window. Then drag the Macaulay2 folder in it to somewhere else on your disk. One good location is your system Applications directory, at the top level on your main disk, and we include a convenient link to that directory within the disk image. Downloaded executable files are put into "quarantine" by Mac OS, so we must release the files from quarantine with the following command (where "1.xxx" is replaced by the number of the version you downloaded.

        xattr -rc /Applications/Macaulay2-1.xxx

---

Getting emacs

There are various options for getting emacs, with which Macaulay2 can be run.

• Use "emacs for Mac OS X", available at http://emacsformacosx.com/. This is a native Mac application, with support for fonts, drag and drop, and cut and paste.
• Use "aquamacs", available at http://aquamacs.org/. This is a native Mac application, with support for fonts, drag and drop, and cut and paste.
• Use /usr/bin/emacs: the problem with it is that it is not X aware, and thus must be run in a terminal window, and that is not good enough. (Running it in xterm, however, will be better than running in Mac OS X Terminal.)
• Compile emacs yourself from the source code available at ftp://ftp.gnu.org/gnu/emacs. You will also need to install X11, available, for example at https://www.xquartz.org/.
• Use "homebrew" to install emacs: http://brew.sh/. You will also need to install X11.

Set up

Now arrange for Macaulay2 to set up your .emacs files and your command shell init files so that M2 will be on the path.

The easiest way to set up these files is to do the following in a Terminal window (the Terminal application is found in the Utilities folder inside the Applications folder. You might want to drag this application to your dock too).

First run the 'setup' command in Macaulay2 this way, replacing the path /Applications/Macaulay2-1.xxx appropriately:

    /Applications/Macaulay2-1.xxx/bin/M2
          setup()  -- Type these lines inside Macaulay2.
                   -- Answer any questions.
          exit

After you log out and in again, your PATH will have Macaulay2's bin directory on it. The 'setup' routine will modify (some of) your shell command init files (such as .profile, .bashrc, .login, .cshrc), and your .emacs file. The existing files are backed up first. It also creates files .profile-Macaulay2, .emacs-Macaulay2, and .login-Macaulay2 in your home directory (making no backups of old versions), which do the actual work, including putting M2 on your path.

This allows you to run Macaulay2 by typing:

      M2

at a terminal command line, to access the info and man pages, and to use the Macaulay2 emacs interface.

See also setting up the Macaulay2 emacs interface.

Try it out

See the file ReadMe-MacOSX.txt for further installation instructions.