GKB-Editor distribution is available in two formats: runtime and source. The runtime distribution includes an executable and does not require a user to purchase Lisp or CLIM license. It does not include the Lisp compiler, and therefore, cannot be used to support new development. The source distribution includes the complete source code for GKB-Editor and its subsystems, and requires a user to purchase a Lisp license.
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-runtime.tar.Zfor runtime distribution) can be unpacked as follows: (the tar files can be deleted after successful installation)
uncompress gkb-editor.tar.Z 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
To relativize the installation scripts to this directory, it is
necessary to set the environment variable
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
$AIC, but you will have to reexecute
aic-installevery time a new
aic-exportis 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-exportdirectory tree to this file. If you received the runtime distribution, just enter a period ("
aic-export/library/released/clim/clim.Xdefaultsuseful for the
olwmwindow 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
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.
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
/usr/local/lib/NExS/lib and the X11
/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
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
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.
DISPLAYenvironment 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.
$AIC. If you are using the GKB-Editor with Ocelot or Sipe, substitute
(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:
To run the system, execute the following:
at the Unix prompt. This will startup a Lisp image. At the Lisp prompt, type the following to start 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
Go to the GKB User Manual.