Admin/README.repos
author urbanc
Thu, 13 Sep 2007 23:58:38 +0200
changeset 24571 a6d0428dea8e
parent 14585 6cf696e5ef7f
child 27461 c2bba6a4d750
permissions -rw-r--r--
some cleaning up to do with contexts
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
14583
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
     1
How to install a repository version of Isabelle.
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
     2
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
     3
The following assumes that you have successfully checked out Isabelle
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
     4
from CVS into a directory $ISABELLE (by default 'isabelle')
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
     5
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
     6
The directory structure of the repository is different from the
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
     7
distribution. The root directory $ISABELLE is the src
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
     8
subdirectory in the distribution. The 'normal' distribution
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
     9
directories are found in $ISABELLE/Distribution.
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    10
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    11
To work directly on a working copy of the repository, do the following:
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    12
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    13
Change directory to "$ISABELLE/Distribution/bin" and execute:
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    14
   ./isatool install -p ~/bin
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    15
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    16
This will install Isabelle executables in ~/bin.  Then issue in
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    17
directory "$ISABELLE/Distribution"
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    18
   ln -s .. src
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    19
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    20
This tells the Isabelle binaries where to find the theories.
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    21
14585
6cf696e5ef7f say how to install PG and poly
kleing
parents: 14584
diff changeset
    22
In $ISABELLE/Distribution/contrib install PolyML and
6cf696e5ef7f say how to install PG and poly
kleing
parents: 14584
diff changeset
    23
ProofGeneral. Download the corresponding packages from
6cf696e5ef7f say how to install PG and poly
kleing
parents: 14584
diff changeset
    24
http://isabelle.in.tum.de/dist/ and unpack them in
6cf696e5ef7f say how to install PG and poly
kleing
parents: 14584
diff changeset
    25
$ISABELLE/Distribution/contrib.  If you have already installed them
6cf696e5ef7f say how to install PG and poly
kleing
parents: 14584
diff changeset
    26
elsewhere, it is sufficient to create a symbolic link in contrib to
6cf696e5ef7f say how to install PG and poly
kleing
parents: 14584
diff changeset
    27
the main PolyML and ProofGeneral directories. The links should be
6cf696e5ef7f say how to install PG and poly
kleing
parents: 14584
diff changeset
    28
called 'polyml' and 'ProofGeneral'.
14583
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    29
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    30
Before you can build logic images it is necessary to initialise
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    31
generation of browser info.  Change to the directory
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    32
"$ISABELLE/Distribution/lib/browser" and issue
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    33
   make
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    34
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    35
Java JDK 1.1 or greater needs to be installed for this to work.
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    36
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    37
Now you can build images by going to corresponding folders and issuing:
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    38
   isatool make
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    39
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    40
(for instance, in "$ISABELLE/HOL" in order to make HOL).  This
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    41
will create the directory "~/isabelle" (if not already present).
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    42
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    43
After setting up the local copy of Isabelle, changes in the repository
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    44
can be imported by:
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    45
   cvs update -d -P
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    46
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    47
(-d causes cvs to create directories that have appeared in the
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    48
repository since the last update, -P causes directories that have been
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    49
removed from the repository to be pruned).
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    50
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    51
Internal environment variables
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    52
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    53
  $ISABELLE_HOME is the directory "isabelle/Distribution" from above.
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    54
  $ISABELLE_HOME_USER is the directory "~/isabelle".
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    55
efbee41e85c2 describe how to work on Isabelle repository version
kleing
parents:
diff changeset
    56
14584
76b81ae4031f fix cvs id
kleing
parents: 14583
diff changeset
    57
$Id$