.nr PO 1.0i .SH Welcome to xmagic 1.1 - first release .PP You should find the following files in this directory: .DS Makefile README actions.c axioms.c button.c conns.c defs.h dialog.c fragment.c help (a directory) help/axioms.hlp help/connectives.hlp help/formulae.hlp help/intro.hlp help/logic.hlp help/output.hlp help.c jump.c list.c pipe.c syserr.c text.c xmagic.c xmagic.h xmagic.man .DE .PP Xmagic is an X Windows based front end to John Slaney's MaGIC. Assuming that you have a compatible version of MaGIC (it must be MaGIC 1.1 for xmagic 1.1) and MIT's version of X Windows (it must be X11/R4 for xmagic 1.1) with the corresponding X Toolkit Athena Widgets, you can install xmagic. To be precise, you must have the following libraries: libXaw.a, libXmu.a, libXt.a, libXext.a and libX11.a. .SH Installation .PP The installation of xmagic should be straightforward. First, edit the Makefile in this directory. On most systems only the first few lines should be modified. If you decide to run MaGIC itself on a host different from your workstation (for which a provision is made) you must define MACHINE and REMOTE. Otherwise comment the line beginning with REMOTE out. The variable MAGIC must point to the precise location of MaGIC in the directory tree whether on your own or on the remote machine. The variable HELPPATH must point to the directory in which you will put the help files which reside in ./help. This directory will be created automatically during the installation, so you do not have to make it at this stage. The variable BIN points to the location of xmagic's executables. .PP The manual entry xmagic.man will be put in $(MANROOT)/man$(MANSECT) as xmagic.$(MANSECT). Before installation you should also edit xmagic.man and modify the lines in section FILES to correspond with the real location of help and app-defaults files. Also, change the section number (it is "L") if you decide to put the manual entry not in the local section. .PP The group membership of xmagic's executables is set to bin, and the ownership to root. The group membership of help files and of the manual entry is set to man and the ownership to root. These are not essential since xmagic does not require set-uid bits. However, you should check before installation if you have the groups bin and man on your system. If not, change MANGRP and BINGRP to what you prefer it to be. .PP Having done all of these type .DS make depend make all .DE in order to compile and link xmagic, and then, if everything goes without glitches type .DS make install .DE to install xmagic, the help files and the manual pages. .PP If at some stage you would like to remove xmagic from your system change back to this directory and type .DS make deinstall .DE This will automatically remove xmagic, the help directory, and the manual pages. .PP If you would like to modify some of xmagic's defaults site-wide, write your preferences on a file XMagic in /usr/lib/X11/app-defaults or wherever else is your XAPPLOADDIR directory. See X(1) for more information. .SH Running xmagic .PP To start xmagic, simply type .DS xmagic .DE If xmagic and MaGIC have been installed properly you should see xmagic's main control panel appear on your screen. If you run MaGIC on a remote system you may have to wait a while before the connection is established. If xmagic hangs and the main control panel does not fill with labels (i.e., all the boxes and windows are empty), it means that the connection is sought to the remote host. On our network the connection is usually established within a few seconds, but sometimes it takes up to a few minutes. If the connection cannot be established xmagic should exit. .PP Before xmagic quits, it sends exit command to MaGIC rather than a kill signal. However, on occasions, we have observed that MaGIC would still hang for a long time even after xmagic had aborted. If xmagic is killed, MaGIC is very likely to hang. In this case you may have to kill hanging processes on the remote system manually. A proper signal handling facility will still have to be implemented in future releases. .PP Before running xmagic you should be reasonably acquainted with MaGIC itself. .PP At this stage xmagic has been tested only on Suns 3/50 and 386i running X11/R4 under Sun OS 4.0.3 (3/50) and 4.0.1 (386i). The remote host was Sequent Symmetry S27 running Dynix(R) V3.0.12. The window manager used was twm. .SH Authors .PP MaGIC both in its sequential and parallel version has been written by John Slaney. Xmagic has been written by Gustav Meglicki. All versions of MaGIC and xmagic can be obtained via anonymous ftp from arp.anu.oz.au or via snail-mail from .DS Automated Reasoning Project, The Research School of Social Sciences, The Australian National University, G.P.O. Box 4, Canberra, A.C.T. 2601, Australia .DE Xmagic problems and queries should be referred to .DS gustav@arp.anu.oz.au, or jks@arp.anu.oz.au .DE .