Admin/website/installation_macos_emacs.html
author haftmann
Tue, 27 Sep 2005 15:30:37 +0200
changeset 17671 e9e341bc7d42
parent 17563 abb280dd3431
permissions -rw-r--r--
website preparation for Isabelle2005
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
16674
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     1
<?xml version='1.0' encoding='iso-8859-1' ?>
bf2cd93cc245 unified main and dist
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">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     3
<!-- $Id$ -->
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     4
<html xmlns="http://www.w3.org/1999/xhtml">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     5
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     6
<head>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     7
    <title>MacOS X Emacs hints</title>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     8
    <?include file="//include/htmlheader.include.html"?>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     9
</head>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    10
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    11
<body class="dist">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    12
    <?include file="//include/header.include.html"?>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    13
    <div class="hr"><hr/></div>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    14
    <?include file="//include/navigation.include.html"?>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    15
    <div class="hr"><hr/></div>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    16
    <div id="content">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    17
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    18
      <h2>MacOS X Emacs hints</h2>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    19
      
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    20
        <p>Assuming you have an installation of Isabelle on your Mac,
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    21
        there are various possibilites for running ProofGeneral:</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    22
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    23
        <ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    24
            <li>You should also be able to launch <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    25
                "http://proofgeneral.inf.ed.ac.uk/">Proof General</a> by typing
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    26
                <tt class="shellcmd">Isabelle</tt> at the Unix command line. This will invoke the
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    27
                Apple-supplied version of Emacs in a terminal window, providing a primitive
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    28
                environment.</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    29
            <li>Somewhat better is to run Proof General from within a version
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    30
                of Emacs ported as a native Mac OS X application, such as <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    31
                "http://home.att.ne.jp/alpha/z123/emacs-mac-e.html">MacEmacs JP</a> or
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    32
                <a href="http://mindlube.com/products/emacs/">mindlube's</a> or <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    33
                "http://www.cs.man.ac.uk/%7efranconi/mac-emacs/">Enhanced Carbon Emacs</a>.
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    34
                Visiting a theory file from Emacs will automatically launch Proof General
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    35
                provided <tt class="shellcmd">isabelle</tt> is on the search path. None of these options
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    36
                support the X-Symbol package, unfortunately.</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    37
            <li>In order to get the full benefit of Proof General, you must install the X
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    38
              Window System (X11) and <a href="http://www.xemacs.org/">XEmacs</a> or
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    39
              <a href="http://www.gnu.org/software/emacs/emacs.html">GNU Emacs</a>.</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    40
              <ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    41
                <li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    42
                    <a href="http://www.apple.com/macosx/x11/">apple's version of X11</a>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    43
                    is included with the Panther (MacOS X 10.3) installation discs, though it is
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    44
                    not installed by default. The Command key serves as Meta, but it is
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    45
                    reserved for standard Apple shortcuts such as C, V and X, so you must use
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    46
                    Esc-C, Esc-V and Esc-X in Emacs or else deselect &raquo;Enable key equivalents&laquo;
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    47
                    in the X11 preferences.</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    48
                <li>The easiest way to install XEmacs or GNU Emacs is via the package manager
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    49
                  <a href="http://fink.sourceforge.net/">Fink</a>. Install the Fink package
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    50
                  <tt>xemacs-sumo-pkg</tt> to get the XEmacs libraries that Proof General needs
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    51
                  to run. To install GNU Emacs, install the package <tt>emacs21</tt>. Fink can
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    52
                  compile from sources, but this takes hours, so it is better to request binary
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    53
                  installations.</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    54
                <li>To use <a href="http://www.gnu.org/software/emacs/emacs.html">GNU
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    55
                  Emacs</a> instead of <a href="http://www.xemacs.org/">XEmacs</a>, you must
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    56
                  recompile Proof General and X-Symbol following the instructions <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    57
                  "http://proofgeneral.inf.ed.ac.uk/FAQ">here</a>. Note that Proof General
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    58
                  incorporates its own copy of X-Symbol.</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    59
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    60
              </ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    61
        </ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    62
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    63
        <p>You may want to install this drag-and-drop <a href=
17563
abb280dd3431 unify dist and main
haftmann
parents: 16674
diff changeset
    64
        "//misc/isabelle_droplet.dmg">Isabelle launcher</a>. It is a simple hack that
16674
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    65
        invokes XEmacs on any files dropped on it.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    66
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    67
        <p>Here is a <a href=
17563
abb280dd3431 unify dist and main
haftmann
parents: 16674
diff changeset
    68
        "//img/screenshot_isabelle_macos.gif">screenshot</a> showing Proof General running
16674
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    69
        in GNU Emacs.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    70
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    71
    </div>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    72
    <div class="hr"><hr/></div>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    73
    <?include file="//include/footer.include.html"?>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    74
</body>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    75
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    76
</html>