clisp-link
(1)
Name
clisp-link - link a new external module to blue]CLISP][1].
Synopsis
clisp-link [create] [module] [file...]
clisp-link [add] [source] [destination] [module...]
clisp-link [run] [source] [module...]
clisp-link [install] [module...]
Description
User Commands CLISP-LINK(1)
NAME
clisp-link - link a new external module to blue]CLISP][1].
SYNOPSIS
clisp-link [create] [module] [file...]
clisp-link [add] [source] [destination] [module...]
clisp-link [run] [source] [module...]
clisp-link [install] [module...]
DESCRIPTION
This shell script operates on blue]CLISP][1] module sets and
linking sets:
o creates new module sets out of source files
o adds module sets to a linking set to produce a new
linking set
o runs blue]CLISP][1] with module sets added
o Only in blue]CLISP][1] built without configure flag
--without-dynamic-modules.
installs new module sets for general use
OPTIONS
create
The command
$ clisp-link create module file ...
creates a module set in module directory which refers
(via symbolic links) to files file... The files are
expected to be modules of their own.
add
The command
$ clisp-link add source destination module ...
combines the linking set in directory source and the
modules in directories module... to a new linking set,
in the directory destination which is newly created.
run
The command
$ clisp-link run source module ...
CLISP 2.49 Last change: Last modified: 2010-07-07 1
User Commands CLISP-LINK(1)
runs the linking set in directory source, with the
modules in directories module... Unless blue]CLISP][1]
has been built with the configuration option
--without-dynamic-modules, the loading will be performed
using SYS::DYNLOAD-MODULES. Otherwise - this is much
slower - a temporary linking set will be created and
deleted afterwards.
install
Only in blue]CLISP][1] built without configure flag
--without-dynamic-modules.
The command
$ clisp-link install module ...
installs the modules in directories module... into
CUSTOM:*LIB-DIRECTORY* or, if it is not writable to the
user (e.g., if a system-wide blue]CLISP][1] installation
is used and the user does not have administrative
privileges), into CUSTOM:*USER-LIB-DIRECTORY*.
Variable CUSTOM:*USER-LIB-DIRECTORY* is initially set to
(blue]MERGE-PATHNAMES][2] ".clisp/"
(blue]USER-HOMEDIR-PATHNAME][3])) if that directory
exists, and can be reset in the RC file.
Note
Do not add CUSTOM:*USER-LIB-DIRECTORY* to
CUSTOM:*LOAD-PATHS* or under any element thereof.
Use REQUIRE instead of LOAD to load dynamic modules.
For this command to work, each module directory must
contain a Makefile with a clisp-module-distrib target
which uses LN to distribute the files necessary to run
the module into destdir. This is in addition to the
general requirement that link.sh is present.
EXAMPLES
See Section 32.2.6, "Example".
FILES
clisp-link needs a "link kit" directory containing:
o "modules.c"
o "clisp.h"
clisp-link expects to find these files in a subdirectory
linkkit/ of the installation directory (i.e.,
CUSTOM:*LIB-DIRECTORY*) which it acquires by running
$ `dirname $0`/clisp -b
CLISP 2.49 Last change: Last modified: 2010-07-07 2
User Commands CLISP-LINK(1)
This can be overridden by the blue]environment variable][4]
CLISP_LINKKIT.
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | runtime/clisp |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
SEE ALSO
CLISP impnotes
clisp(1)
AUTHORS
Bruno Haible <blue]http://www.haible.de/bruno/]>
The original author and long-time maintainer.
Michael Stoll <blue]-
http://www.faculty.iu-bremen.de/mstoll/]>
The original author.
Sam Steingold <blue]http://sds.podval.org/]>
Co-maintainer since 1998.
Others
See COPYRIGHT (file in the CLISP sources) for the list
of other contributors and the license.
COPYRIGHT
Copyright (C) 1992-2010 Bruno Haible
Copyright (C) 1998-2010 Sam Steingold
NOTES
1. CLISP
http://clisp.cons.org
2. MERGE-PATHNAMES
http://www.ai.mit.edu/projects/iiip/doc/CommonLISP/HyperSpec/Body/fun_merge-pathnames.html
3. USER-HOMEDIR-PATHNAME
http://www.ai.mit.edu/projects/iiip/doc/CommonLISP/HyperSpec/Body/fun_user-homedir-pathname.html
4. environment variable
[set
$man.base.url.for.relative.links]/basedefs/xbd_chap08.html
CLISP 2.49 Last change: Last modified: 2010-07-07 3
User Commands CLISP-LINK(1)
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from
http://ftp.gnu.org/gnu/clisp/release/2.49/clisp-2.49.tar.bz2
Further information about this software can be found on the
open source community website at http://clisp.cons.org/.
CLISP 2.49 Last change: Last modified: 2010-07-07 4