src/Tools/README
author wenzelm
Mon, 01 Dec 1997 18:22:38 +0100
changeset 4334 e567f3425267
parent 3279 815ef5848324
permissions -rw-r--r--
ISABELLE_TMP_PREFIX;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
3279
815ef5848324 tuned all READMEs;
wenzelm
parents: 817
diff changeset
     1
815ef5848324 tuned all READMEs;
wenzelm
parents: 817
diff changeset
     2
***************************************************************************
815ef5848324 tuned all READMEs;
wenzelm
parents: 817
diff changeset
     3
815ef5848324 tuned all READMEs;
wenzelm
parents: 817
diff changeset
     4
IMPORTANT NOTE: These tools will disappear next time!
815ef5848324 tuned all READMEs;
wenzelm
parents: 817
diff changeset
     5
815ef5848324 tuned all READMEs;
wenzelm
parents: 817
diff changeset
     6
***************************************************************************
815ef5848324 tuned all READMEs;
wenzelm
parents: 817
diff changeset
     7
815ef5848324 tuned all READMEs;
wenzelm
parents: 817
diff changeset
     8
817
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
     9
	Tools: Shell scripts and utilities associated with Isabelle
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    10
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    11
To make these tools visible, you may wish to add this directory to your PATH
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    12
variable.
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    13
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    14
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    15
This directory includes scripts for building Isabelle:
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    16
  make-all		shell script for building entire system
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    17
  make-all-poly		sample make-all invocation for Poly/ML
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    18
  make-all-nj		sample make-all invocation for SML of NJ
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    19
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    20
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    21
Also scripts for running Isabelle:
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    22
  xlisten		shell script for running Isabelle under X
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    23
  teeinput		shell script to run Isabelle, logging inputs to a file
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    24
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    25
	xlisten and teeinput constitute a *very* primitive user interface.
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    26
	xlisten sets up a window running Isabelle, with a separate small
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    27
	"listener" window, which keeps a log of all input lines.  If you are
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    28
	not running the X Window System, teeinput can still be used to record
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    29
	the log.  David Aspinall's Emacs-based interface is infinitely better
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    30
	than this one!
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    31
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    32
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    33
And scripts to operate on source files (mainly for maintaining compatibility)
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    34
  agrep			search for a string throughout all the sources
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    35
  expandshort		shell script to expand "shortcuts" in files
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    36
  change_simp		shell script to help convert sources to new simplifier
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    37
  conv-theory-files.pl  perl script to rename old theory files
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    38
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    39
	The command
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    40
		conv-theory-files.pl | grep mv
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    41
	generates commands to rename all theory files in a directory hierarchy.
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    42
	See conv-theory-files.pl for more information.
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    43
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    44
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    45
And a program to insert calls to the new qed functions
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    46
  qed.cc		the program
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    47
  qed.doc		its documentation
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    48
  Makefile		its Makefile
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    49
  runqed		script for bulk changes
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    50
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    51
	These allow you to update old sources to take advantage of the
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    52
	new database of theorems.  They replace calls to result, prove_goal,
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    53
	etc. by calls to functions that store the theorems in the database.
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    54
	The result may fail if the theorems are declared within a structure
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    55
	body, or if they are proved in an ad-hoc union of theories.
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    56
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    57
99824db26a29 Tools description, largely taken from ../README
lcp
parents:
diff changeset
    58
$Id$