1 files changed, 80 insertions, 0 deletions
diff --git a/doc/macintosh.htm b/doc/macintosh.htm
new file mode 100644
index 0000000..a6b39de
--- /dev/null
+++ b/doc/macintosh.htm
@@ -0,0 +1,80 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<HTML>
+<HEAD>
+  <TITLE>Icon on Macintosh</TITLE>
+  <LINK rel="STYLESHEET" type="text/css" href="istyle.css">
+  <LINK rel="SHORTCUT ICON" href="shortcut.gif">
+</HEAD>
+
+<BODY>
+  <P><A href="http://www.cs.arizona.edu/icon/">
+  <IMG src= "wwwcube.gif" alt="[Icon home]"
+  width="128" height="144" border="0" align="right"></A></P>
+
+  <H1>Icon on Macintosh</H1>
+
+  <P>Gregg M. Townsend<BR>
+  <SMALL>Department of Computer Science</SMALL><BR>
+  <SMALL>The University of Arizona</SMALL></P>
+
+  <P><SMALL>www.cs.arizona.edu/icon/v943/macintosh.htm<BR>
+  Last updated November 9, 2005</SMALL>
+  <!-- $Id: macintosh.htm,v 1.1 2005/11/09 18:03:59 gmt Exp $ --></P>
+
+  <H2>Introduction</H2>
+
+  <P>Because Mac OS X is based on Unix, it can run Icon. There is
+  no special Macintosh interface, so as a practical matter Icon on
+  the Mac is for those who are comfortable using a Unix shell in a
+  Terminal window.</P>
+
+  <P>The command-line interface to Icon is described by Unix
+  <CITE>man</CITE> pages. The <CODE><A href=
+  "icon.txt">icon</A></CODE> command executes a program from a
+  single source file. An Icon program in a simple text file
+  <CODE>prog.icn</CODE> is executed by typing <CODE>icon
+  prog.icn</CODE>. The more general <CODE><A href=
+  "icont.txt">icont</A></CODE> command, modeled after the Unix
+  <CITE>cc</CITE> command, supports multiple files, separate
+  compilation, and other features.</P>
+
+  <H2>Graphics</H2>
+
+  <P>For graphics, Icon uses the X Window System, generally called
+  <A href="http://www.apple.com/macosx/features/x11/">X11</A> in
+  Macintosh documentation. X11 is not normally installed as part of
+  OS X; it must be selected as part of a custom installation.
+  Alternatively, it can be
+  <A HREF="http://www.apple.com/support/downloads/x11formacosx.html">
+  downloaded</A> from Apple.</P>
+
+  <P>The X window system does not start automatically. To run an
+  Icon graphics program, you must first start the X11 application
+  and leave it running. The environment variable DISPLAY must be
+  set in the shell that runs an Icon graphics program. For
+  example:</P>
+
+  <BLOCKQUOTE>
+    <P><CODE>setenv DISPLAY :0.0</CODE></P>
+  </BLOCKQUOTE>
+
+  <H2>Building Icon</H2>
+
+  <P>Building Icon from source requires the <A href=
+  "http://www.apple.com/macosx/features/xcode/">Xcode</A> toolbox.
+  This comes in an extra folder on the OS X installation disc.
+  When installing XCode, be sure to select a custom
+  installation and add X11 to the default set.</P>
+
+  <P>Icon is built in a Terminal window. The process is the same as
+  on other platforms and uses the configuration named
+  <CODE>macintosh</CODE>. See
+  <A href="build.htm">Building Icon</A> for detailed instructions.</P>
+
+  <BLOCKQUOTE>&nbsp;
+    
+</BLOCKQUOTE>
+  <HR>
+</BODY>
+</HTML>