We expect that in the future the GKB-Editor will run on additional platforms due to the high portability of Common Lisp and CLIM. We also expect to port the GKB-Editor to run on additional FRSs.
gkb-editor.tar.Z can be unpacked as follows: (the
tar files can be deleted after successful installation)
uncompress gkb-editor.tar tar xvf gkb-editor.tar
This will create a directory aic-export containing a
number of sub-directories.
aic-install. Our examples assume that you are placing the root of the directory tree for the distribution (namely aic-export) in
directory /usr/local/. You may wish to substitute a different location for the
value of AIC.
To relativize the installation scripts to this directory, it is
necessary to set the environment variable $AIC:
setenv AIC /usr/local/aic-export
The environment variable $AIC must be set to use any of the
Makefile commands for unpacking, loading, or running an SRI system.
Run the installation shell script:
cd $AIC aic-install
You will first be prompted for the name of a Unix directory; the script
will create a file named aic-init.lisp in that directory;
aic-init.lisp is used by all AIC systems to find the local
aic-export directory tree. We recommend using one of the following
directories:
/usr/share/local/lib
/usr/local/lib
/usr/local/etc
/etc
$AIC, but you will have to reexecute
aic-install every time a new aic-export is created. The
directory name that you type should not end with a /.
Next you will be prompted for the name of a file which is a Lisp
executable image that contains CLIM (and possibly your FRS). The script will create a link
in the aic-export directory tree to this file.
aic-export/library/released/clim/clim.Xdefaults useful
for the olwm
window manager. Therefore, we suggest that the following line be
added to the file .openwin-init (or its equivalent) in the home
directory of every user of the GKB-Editor:
toolwait xrdb -merge aic-export/library/released/clim/clim.Xdefaults
If you are running Allegro Common Lisp with Motif, you may find it useful to
assign emacs-like key bindings to your Motif text-field and
text-editing gadgets. Franz, Inc. supplies a file of suggested bindings,
dot-Xdefaults, in the lib/misc/ directory
included with the ACL distribution. You may wish to edit your own
.Xdefaults file (in your home directory) to include some
or all of these bindings.
$AIC/gkb-editor/released/lib.
Before linking the NExS library with the GKB-Editor library, you must
ensure that the locations of the NExS library and the X11 library are
on the LD_LIBRARY_PATH. For example, if the NExS library resides in
the directory /usr/local/lib/NExS/lib and the X11
library in /opt/openwin/released/lib, you can add them
to the LD_LIBRARY_PATH by typing
setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH:/usr/local/lib/NExS/bin:/opt/openwin/released/libat the unix prompt. Next go to the home directory for the GKB-Editor and link the two libraries by typing
cd $AIC/gkb-editor/released make spreadsheet
at the unix prompt. If the linking is successful you should see the
message Spreadsheet library successfully created . If
due to some reason you need to recompile the GKB-Editor library, you
may do so by typing the following
make compile-spreadsheet
at the unix prompt. Once the library has been created, you should add its location to the LD_LIBRARY_PATH by typing
setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH:$AIC/gkb-editor/released/libat the unix prompt. The library will be automatically loaded by the load procedure described next.
DISPLAY environment variable correctly, either from
the shell, by typing
setenv DISPLAY local-host:0.0(substituting your own local machine name for
local-host), or from within
Lisp, by typing
(sri:display-env "local-host:0.0")to the Lisp listener.
Type the following
to the Lisp listener, but substitute the
location of the aic-export directory for $AIC. If you
are using the GKB-Editor with Ocelot or Sipe, substitute :ocelot or
:sipe for :loom.
(load "$AIC/gkb-editor/released/lisp/define-aic-root.lisp") (sri:load-system 'gkb-editor :subsystem :loom)
The first time you load the GKB-Editor, you may wish to compile it. After loading the system using the commands above, execute the following:
(user:compile-gkb-editor)
To run the system, execute the following:
(user:run-gkb-editor)
$AIC/doc/aic-sys-spec.txt. In addition, this file describes
other conventions for managing AIC systems.
The GFP specifications are included with the distribution in $AIC/generic-fp/released/spec/paper.ps.
Go to the GKB User Manual.