Software Manual For Windows Z/EVES Version 2.3: TR-97-5505-04h Irwin Meisels Release Date: June 2004
Software Manual For Windows Z/EVES Version 2.3: TR-97-5505-04h Irwin Meisels Release Date: June 2004
Software Manual For Windows Z/EVES Version 2.3: TR-97-5505-04h Irwin Meisels Release Date: June 2004
for
Windows Z/EVES Version 2.3
TR-97-5505-04h
Irwin Meisels
ORA Canada
P.O. Box 46005, 2339 Ogilvie Rd.
Ottawa, Ontario K1J 9M7
CANADA
c ORA Canada (1996,1997,1999, 2000, 2004)
EVES Project TR-97-5505-04h i
Contents
1 Introduction 1
1.1 GUI Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
2 Release Notes 1
3 Installation Instructions 4
3.1 Installing Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.2 Installing Z/EVES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.3 Uninstalling Z/EVES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.4 The Toolkit and Section Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
5 LATEX 2ε Support 8
6 Contact 9
ii EVES Project TR-97-5505-04h
1 Introduction
This document describes the procedure for installing Version 2.3 of the Z/EVES verification system
on a Windows 98, Windows NT, Windows 2000, or Windows XP system. The distribution format
for Windows Z/EVES is a self-installing executable file, usually downloaded using FTP.
This version of Z/EVES can be used in two ways, in server mode and in Z/LATEX mode. In
server mode, it runs as a server, providing parsing, type checking, and proof service which is accessed
through a graphical user interface (GUI). The GUI is included in the Z/EVES distribution and is
described in [Saa 99b]. The Z/EVES GUI accepts and displays Z text in Z notation, as described
in the Z Reference Manual ([Spi 92]).
In Z/LATEX mode, Z/EVES is accessed directly, through a command-line interface provided by
Z/EVES itself. In this mode, Z text is accepted and displayed in Z/LATEX notation. Also, a GNU
Emacs mode is provided for editing Z/LATEX text and interacting with Z/EVES.
The Z/EVES distribution includes the Z font created by Richard Jones, Version 1.0.4; this font
is
Richard
c Jones, 1995.
2 Release Notes
Version 2.2 had a limited, Windows-only distribution; the last major public release of Z/EVES was
Version 2.1. Save files created with Version 2.2 can be read by Version 2.3. However, because the
Toolkit has changed, save files created by version 2.1 and earlier versions of Z/EVES may be read,
but the proofs are lost and proof scripts, if any, must be run again. The following changes have been
made since Version 2.1:
• Windows Z/EVES is now built with Xanalys LispWorks, which is considerably faster than the
Lisp system used previously.
• The Z/EVES GUI will now work with a more up-to-date version of Python (Version 2.3).
• Save and restore will now work for very large files.
• The mouse wheel, if you have one, now works correctly in the specification and proof windows.
• A specification can be exported in LATEX form. This facility has some minor shortcomings:
– Unchecked syntax declarations are exported incorrectly.
– Some symbols are exported incorrectly:
symbol exported as
\upto ..
\hide \setminus
\comp \semi
In some cases, a \Label{...} command can be exported as \ldata ... \rdata instead.
In all these cases, the exported text can be printed or re-imported without problems, but
cannot be successfully checked in the text mode Z/EVES interface.
– Generic actuals for schemas appear in the wrong place.
2 EVES Project TR-97-5505-04h
3 Installation Instructions
Before installing Z/EVES, you must install Python 2.3.4 if you wish to use the Z/EVES GUI.
1. Download the Python 2.3.4 installer (Python-2.3.4.exe) at the URL given in Section 1.
2. Run the installer. On Windows NT or above, log in as Administrator first.
1. Download the Z/EVES installer via FTP, to some temporary directory. Make sure that you
download the correct version for your system, and that you download the file in binary mode.
(For more specific instructions on how to download Z/EVES, please contact us at the address
given in Section 6.)
2. Double-click on the installer file in Windows Explorer, or run it from the Start menu. Admin-
istrator privileges are not required.
3. The installer will create a program group for Z-EVES 2.3 accessible from the Start menu, and
install shortcuts for the Z/EVES command line and Z/EVES GUI on the desktop. By default,
Z/EVES files are installed in subdirectories of C:\Program Files\Z-EVES 2.3\.
4. [optional] The file system\z-eves.el in the installation directory contains Emacs Lisp code
for the GNU Emacs Z/LATEX and Z/EVES modes. This code works only with GNU Emacs
Version 19 and above. To install and compile this file, do the following:
(a) Copy z-eves.el to your Emacs Lisp site directory.
(b) Visit the file in Emacs, and use M-x byte-compile-file to compile the file. You will get
some warnings about assignments and references to free variables; these may be ignored.
(c) Add the following to your ~/.emacs file:
(setq auto-mode-alist (append auto-mode-alist
’(("\\.z$" . z-latex-mode)
("\\.zed$" . z-latex-mode))))
(autoload ’z-latex-mode "z-eves" "Z-EVES LaTeX mode." t)
(autoload ’run-z-eves "z-eves" "Run Z-EVES." t)
(setq z-eves-program
"c:/program files/z-eves 2.3/system/z-eves-pc-windows-lispworks.exe")
(setq z-eves-program-args nil)
This assumes that Z/EVES has been installed in the default location. If not, specify the
full path name of the Z/EVES executable as the value of z-eves-program.
The modifications to auto-mode-alist will make Emacs automatically turn on Z/LATEX
mode in a buffer for a file whose extension is .z or .zed. For a file whose extension
EVES Project TR-97-5505-04h 5
is .tex, you will have to turn on Z/LATEX mode in the buffer manually. You can add
the cons ("\\.tex$" . z-latex-mode) to auto-mode-alist to automatically turn on
Z/LATEX mode for these files, but this will interfere with the editing of TEX or LATEX
source files.
1. The directory which contains the Z/EVES executable (the “system” directory).
2. Directories specified in the Z/EVES command line, with the -libs option. The value of this
option is a semicolon-separated list of directories. This option may be added to the command
line in the “Z-EVES” shortcut. (As noted in Section 4.1, this option must be preceded with
-- if it is the first Z/EVES option.)
3. Directories specified in the zsection path command, in the order specified (the “user” direc-
tories).
In the second and third cases, directory names must end in a backslash (\).
If the zsection path command is given with no arguments, the current system directory and
user directory list are printed.
• To search for a name or symbol defined in a \syndef declaration, enclose the name or symbol
in double quotes ("), to distinguish it from the name defined in a declaration box.
The Z/EVES process may be terminated by exiting Z/EVES and killing the Z/EVES window.
8 EVES Project TR-97-5505-04h
5 LATEX 2ε Support
The Windows Z/EVES distribution includes a LATEX2e package, z-eves, for typesetting Z/LATEX
specifications. This package consists of the Z macros from the zed-csp package written by Jim
Davies, plus macros for typesetting the Z/LATEX extensions to Z (e.g., theorems).
To install this package, copy the file doc\z-eves.sty to your site-local LATEX package directory.
EVES Project TR-97-5505-04h 9
6 Contact
If you have any problems with the system, contact us at:
Postal mail:
Z/EVES
c/o ORA Canada
P.O. Box 46005
2339 Ogilvie Road
Ottawa, Ontario K1J 9M7
Electronic mail:
[email protected]
World Wide Web:
http://www.ora.on.ca/
There is a mailing list (email) for Z/EVES-related announcements and news, and for general
discussion about Z/EVES and Z. The list is a good way to keep in touch with the Z/EVES developers
and with Z/EVES users.
References
[Mei 97] Irwin Meisels and Mark Saaltink. The Z/EVES Reference Manual. ORA Canada Tech-
nical Report TR-97-5493-03d, September 1997.
[Saa 99a] Mark Saaltink. The Z/EVES 2.2 Mathematical Toolkit. ORA Canada Technical Report
TR-03-5493-05c, June 2003.
[Saa 99b] Mark Saaltink. The Z/EVES 2.0 User’s Guide. ORA Canada Technical Report TR-99-
5493-06a, October 1999.
[Spi 92] J.M. Spivey. The Z Notation: A Reference Manual, 2nd Ed. Prentice Hall, 1992