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