CLISP-LINK(1)

NAME
clisp-link - link a new external module to CLISP[1].

SYNOPSIS

clisp-link [create] [module] [file...]

clisp-link [add] [source] [destination] [module...]

clisp-link [run] [source] [module...]

DESCRIPTION

This shell script operates on CLISP[1] module sets and linking sets:

    • creates new module sets out of source files

    • adds module sets to a linking set to produce a new linking set

    • runs CLISP[1] with module sets added

    • Only in 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 ...

    runs the linking set in directory source, with the modules in directories module... Unless 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.

EXAMPLES

See Section 32.2.6, “Example”.

FILES

clisp-link needs a “link kit” directory containing:

    • "modules.c"

    • "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

This can be overridden by the environment variable[4] CLISP_LINKKIT.

SEE ALSO

    CLISP impnotes
    clisp(1)

AUTHORS

Bruno Haible <http://www.haible.de/bruno/>
    The original author and long-time maintainer.

Michael Stoll <http://www.faculty.iu-bremen.de/mstoll/>
    The original author.

Sam Steingold <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 © 1992-2010 Bruno Haible
Copyright © 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