1 <?xml version='1.0' encoding='iso-8859-1' ?> |
|
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
|
3 <!-- $Id$ --> |
|
4 <html xmlns="http://www.w3.org/1999/xhtml"> |
|
5 |
|
6 <head> |
|
7 <title>Installation hints for Mac OS X</title> |
|
8 <?include file="//include/htmlheader.include.html"?> |
|
9 </head> |
|
10 |
|
11 <body class="dist"> |
|
12 <?include file="//include/header.include.html"?> |
|
13 <div class="hr"><hr/></div> |
|
14 <?include file="//include/navigation_dist.include.html"?> |
|
15 <div class="hr"><hr/></div> |
|
16 <div id="content"> |
|
17 |
|
18 <h2>Installing on Mac OS X</h2> |
|
19 <p><a href="http://www.apple.com/macosx/">Mac OS X</a> is the current version |
|
20 of the Macintosh operating system, installed on all new <a href= |
|
21 "http://www.apple.com/">Apple</a> computers. Because it is based on Unix, it |
|
22 can run <a href= |
|
23 "http://www.cl.cam.ac.uk/Research/HVG/Isabelle/">Isabelle</a>. The new |
|
24 <a href="http://www.apple.com/powermac/">Power Mac G5</a> is an excellent |
|
25 Isabelle machine. Here is a <a href= |
|
26 "//dist/img/screenshot_isabelle_macos.gif">screenshot</a> showing Proof General running |
|
27 in GNU Emacs.</p> |
|
28 |
|
29 <p>This page gives advice on building Isabelle for Mac OS X. It assumes that |
|
30 you are familiar with both Mac OS X and Unix. You must have installed the Mac |
|
31 OS X developer tools.</p> |
|
32 |
|
33 <ol> |
|
34 <li>Download Isabelle to a suitable directory, as described on the |
|
35 <a href="download.html">download page</a>. Be sure to get the following |
|
36 files |
|
37 |
|
38 <ul> |
|
39 <li><?value key="distname"?>.tar.gz</li> |
|
40 <li>ProofGeneral.tar.gz</li> |
|
41 <li>polyml_base.tar.gz</li> |
|
42 <li>polyml_ppc-darwin.tar.gz</li> |
|
43 <li>HOL_ppc-darwin.tar.gz</li> |
|
44 </ul> |
|
45 </li> |
|
46 |
|
47 <li>You may have to install the bash shell. Versions of Mac OS X prior to |
|
48 10.2.2 did not provide it. If /bin/bash does not exist, you can install it |
|
49 using the package manager <a href= |
|
50 "http://fink.sourceforge.net/">Fink</a>.</li> |
|
51 |
|
52 <li>At this point, you should be able to run Isabelle with the command line |
|
53 interface. You can also build Isabelle from the Unix command line, |
|
54 following the instructions for "Compiling Logics" in file |
|
55 <tt class="shellcmd">Isabelle/INSTALL.</tt></li> |
|
56 |
|
57 <li>You should also be able to launch <a href= |
|
58 "http://proofgeneral.inf.ed.ac.uk/">Proof General</a> by typing |
|
59 <tt class="shellcmd">Isabelle</tt> at the Unix command line. This will invoke the |
|
60 Apple-supplied version of Emacs in a terminal window, providing a primitive |
|
61 environment. Somewhat better is to run Proof General from within a version |
|
62 of Emacs ported as a native Mac OS X application, such as <a href= |
|
63 "http://home.att.ne.jp/alpha/z123/emacs-mac-e.html">MacEmacs JP</a> or |
|
64 <a href="http://mindlube.com/products/emacs/">mindlube's</a> or <a href= |
|
65 "http://www.cs.man.ac.uk/%7efranconi/mac-emacs/">Enhanced Carbon Emacs</a>. |
|
66 Visiting a theory file from Emacs will automatically launch Proof General |
|
67 provided <tt class="shellcmd">isabelle</tt> is on the search path. None of these options |
|
68 support the X-Symbol package, unfortunately.</li> |
|
69 </ol> |
|
70 |
|
71 <p>In order to get the full benefit of Proof General, you must install the X |
|
72 Window System (X11) and <a href="http://www.xemacs.org/">XEmacs</a> or |
|
73 <a href="http://www.gnu.org/software/emacs/emacs.html">GNU Emacs</a>.</p> |
|
74 |
|
75 <ul> |
|
76 <li><a href="http://www.apple.com/macosx/x11/">Apple's version</a> of X11 |
|
77 is included with the Panther (MacOS 10.3) installation discs, though it is |
|
78 not installed by default. The Command key serves as Meta, but it is |
|
79 reserved for standard Apple shortcuts such as C, V and X, so you must use |
|
80 Esc-C, Esc-V and Esc-X in Emacs or else deselect "Enable key equivalents" |
|
81 in the X11 preferences.</li> |
|
82 |
|
83 <li>Some people prefer the <a href= |
|
84 "http://www.osxgnu.org/software/Xwin/WindowManagers/OroborOSX/">OroborOSX</a> |
|
85 window manager. It must be used in conjunction with <a href= |
|
86 "http://xfree86.org/">XFree86</a>, which is easy to install if you use the |
|
87 installer provided by the <a href= |
|
88 "http://sourceforge.net/projects/xonx/">XonX</a> project.</li> |
|
89 </ul> |
|
90 |
|
91 <p>The easiest way to install XEmacs or GNU Emacs is via the package manager |
|
92 <a href="http://fink.sourceforge.net/">Fink</a>. Install the Fink package |
|
93 <tt>xemacs-sumo-pkg</tt> to get the XEmacs libraries that Proof General needs |
|
94 to run. To install GNU Emacs, install the package <tt>emacs21</tt>. Fink can |
|
95 compile from sources, but this takes hours, so it is better to request binary |
|
96 installations.</p> |
|
97 |
|
98 <p>To use <a href="http://www.gnu.org/software/emacs/emacs.html">GNU |
|
99 Emacs</a> instead of <a href="http://www.xemacs.org/">XEmacs</a>, you must |
|
100 recompile Proof General and X-Symbol following the instructions <a href= |
|
101 "http://proofgeneral.inf.ed.ac.uk/FAQ">here</a>. Note that Proof General |
|
102 incorporates its own copy of X-Symbol.</p> |
|
103 |
|
104 <ol> |
|
105 <li>Install X11 or OroborOSX.</li> |
|
106 |
|
107 <li>Install XEmacs (and its libraries), or install GNU Emacs and recompile |
|
108 Proof General.</li> |
|
109 |
|
110 <li>You may want to install this drag-and-drop <a href= |
|
111 "IsabelleDroplet.dmg">Isabelle launcher</a>. It is a simple hack that |
|
112 invokes xemacs on any files dropped on it.</li> |
|
113 </ol> |
|
114 |
|
115 </div> |
|
116 <div class="hr"><hr/></div> |
|
117 <?include file="../include/footer.include.html"?> |
|
118 </body> |
|
119 |
|
120 </html> |
|