Debian Codegraph @

doc/macintosh.htm

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
3 <HTML>
4 <HEAD>
5 <META NAME=viewport CONTENT="width=device-width, initial-scale=1">
6 <TITLE>Icon on Macintosh</TITLE>
7 <LINK rel="STYLESHEET" type="text/css" href="istyle.css">
8 <LINK rel="SHORTCUT ICON" href="shortcut.gif">
9 </HEAD>
10
11 <BODY>
12 <P><A href="http://www.cs.arizona.edu/icon/">
13 <IMG src= "wwwcube.gif" alt="[Icon home]"
14 width="128" height="144" border="0" align="right"></A></P>
15
16 <H1>Icon on Macintosh</H1>
17
18 <P>Gregg M. Townsend<BR>
19 <SMALL>Department of Computer Science</SMALL><BR>
20 <SMALL>The University of Arizona</SMALL></P>
21
22 <P><SMALL>www.cs.arizona.edu/icon/uguide/macintosh.htm<BR>
23 Last updated October 17, 2014</SMALL>
24
25 <H2>Introduction</H2>
26
27 <P>Because Mac OS X is based on Unix, it can run Icon. There is
28 no special Macintosh interface, so as a practical matter Icon on
29 the Mac is for those who are comfortable using a Unix shell in a
30 Terminal window.</P>
31
32 <P>The command-line interface to Icon is described by Unix
33 <CITE>man</CITE> pages. The <CODE><A href=
34 "icon.txt">icon</A></CODE> command executes a program from a
35 single source file. An Icon program in a simple text file
36 <CODE>prog.icn</CODE> is executed by typing <CODE>icon
37 prog.icn</CODE>. The more general <CODE><A href=
38 "icont.txt">icont</A></CODE> command, modeled after the Unix
39 <CITE>cc</CITE> command, supports multiple files, separate
40 compilation, and other features.</P>
41
42 <H2>Co-Expressions</H2>
43
44 <P>
45 Because MacOS does not implement anonymous semaphores,
46 each co-expression creates an open file.
47 Programs with hundreds of active co-expressions may
48 abort with a <CODE>cannot create semaphore</CODE> system error.
49 The open file limit can be raised from the typical default of 256
50 using a <CODE>limit descriptors <I>n</I></CODE> or
51 <CODE>ulimit -nS <I>n</I></CODE> command, depending on the shell.
52
53
54 <H2>Graphics</H2>
55
56 <P> If Icon is built with graphics enabled, the X Window System
57 (&ldquo;X11&rdquo;) is required to run any Icon program.
58 X11 is not needed if Icon is built with graphics disabled.
59
60 <P> Beginning with Mac OS 10.8 (&ldquo;Mountain Lion&rdquo;),
61 X11 is not part of the standard OS installation.
62 When X11 is first needed, Mac OS provides instructions for
63 downloading and installing it.
64 After that is done, X11 starts automatically as needed.
65 A ringed X icon appears in the dock when an Icon graphics program
66 is run and persists innocuously afterward.
67
68 <H2>Building Icon</H2>
69
70 <P>Building Icon from source requires the <A href=
71 "https://developer.apple.com/xcode/">Xcode</A> toolbox,
72 which is available for
73 <A HREF="https://developer.apple.com/xcode/downloads/">
74 free download</A> with registration.</P>
75
76 <P>Icon is built in a Terminal window. The process is the same as
77 on other platforms and uses the configuration named
78 <CODE>macintosh</CODE>. See
79 <A href="build.htm">Building Icon</A> for detailed instructions.</P>
80
81 <HR>
82 </BODY>
83 </HTML>