Work at SourceForge, help us to make it a better place! We have an immediate need for a Support Technician in our San Francisco or Denver office.

Close

Tree [512ab3] clisp_2_29-2002-07-25 clisp_2_25_1-2001-04-06 / os2 /
History



File Date Author Commit
INSTALL 2001-06-29 sds sds [01a9e2] typo
PLATFORMS 2001-06-29 sds sds [01a9e2] typo
README 2001-06-29 sds sds [01a9e2] typo
clisp.1 2001-06-29 sds sds [01a9e2] typo
clisp.dvi 2001-06-29 sds sds [01a9e2] typo
clisp.html 2001-06-29 sds sds [01a9e2] typo
clisp.man 2001-06-29 sds sds [01a9e2] typo
clreadline.3 2001-06-29 sds sds [01a9e2] typo
clreadline.dvi 2001-06-29 sds sds [01a9e2] typo
clreadline.man 2001-06-29 sds sds [01a9e2] typo
conv_one.cmd 2001-06-29 sds sds [01a9e2] typo
convert.bax 2001-06-29 sds sds [01a9e2] typo
copyx.cmd 2001-06-29 sds sds [01a9e2] typo
cv_lt_pc.c 2001-06-29 sds sds [01a9e2] typo
cv_pc_lt.c 2001-06-29 sds sds [01a9e2] typo
delx.cmd 2001-06-29 sds sds [01a9e2] typo
emx-faq.doc 2001-06-29 sds sds [01a9e2] typo
forall.cmd 2001-06-29 sds sds [01a9e2] typo
gcclink.in 2001-06-29 sds sds [01a9e2] typo
grep.in 2001-06-29 sds sds [01a9e2] typo
gtconfig.h 2001-06-29 sds sds [01a9e2] typo
gtobjects 2001-06-29 sds sds [01a9e2] typo
interpreted.in 2001-06-29 sds sds [01a9e2] typo
lispinit.in 2002-07-24 cvs2hg cvs2hg [512ab3] fixup commit for tag 'clisp_2_25_1-2001-04-06'
makefile 2002-07-24 cvs2hg cvs2hg [512ab3] fixup commit for tag 'clisp_2_25_1-2001-04-06'
popenrw.c 2001-06-29 sds sds [01a9e2] typo
rlconfig.h 2001-06-29 sds sds [01a9e2] typo

Read Me

This is CLISP, a Common Lisp implementation.


What is LISP?
-------------

LISP is a programming language. It was invented by J. McCarthy in 1959.
There have been many dialects of it, but nowadays LISP has been standardized
and wide-spread due to the industrial standard COMMON LISP. There are
applications in the domains of symbolic knowledge processing (AI), numerical
mathematics (MACLISP yielded numerical code as good as FORTRAN), and
widely used programs like editors (EMACS) and CAD (AUTOCAD).
There is an introduction to the language:

  Sheila Hughes: Lisp. Pitman Publishing Limited, London 1986.
  107 pages.

After a while wou will need the standard text containing the language
definition:

  Guy L. Steele Jr.: Common Lisp - The Language. Digital Press.
  1. edition 1984, 465 pages.
  2. edition 1990, 1032 pages.

LISP is run in an interactive environment. You input forms, and they will be
evaluated at once. Thus you can inspect variables, call functions with given
arguments or define your own functions.


Contents:
---------

It consists of the following files:

      lisp.exe         main program
      lispinit.mem     memory image needed for startup
      clisp.1          manual page in Unix man format
      clisp.man        manual page
      clisp.dvi        manual page in dvi format
      impnotes.html    implementation notes
      emx-user.doc     emx applications user's guide
      emx.dll          OS/2 dynamic link library containing emx
      emxlibc.dll      OS/2 dynamic link library containing the emx libc
      README           this text
      SUMMARY          short description of CLISP
      ANNOUNCE         announcement
      COPYRIGHT        copyright notice
      GNU-GPL          free software license
      config.lisp      site-dependent configuration

and - to your convenience, if you like reading source -

      *.lisp           the source of lispinit.mem
      *.fas            the same files, already compiled


Hardware requirements:
----------------------

This OS/2 version of CLISP requires an 80386 (SX or DX) or an 80486 CPU,
running OS/2 2.0.


Installation:
-------------

First of all, install emx.dll and emxlibc.dll in a separate directory,
say c:\emx\dll. Add c:\emx\dll (insert the correct drive letter)
to the LIBPATH statement in your config.sys file. Reboot your computer
to enable the new LIBPATH statement and the new environment variables.

Edit the contents of config.lisp appropriately for your site,
especially the definitions of short-site-name and long-site-name.
You may also want to edit the time zone definition in defs1.lisp.
Then start

         lisp.exe -M lispinit.mem

When the LISP prompt

      > _

appears, type

        (compile-file "config")
        (load "config")

and - in case you modified defs1.lisp -

        (compile-file "defs1")
        (load "defs1")

and then

        (saveinitmem)

to overwrite the file lispinit.mem with your configuration. Then

        (exit)

Then create a directory, and put the executable and the memory image there.
Assuming D:\LIB\LISP :

   mkdir d:\lib\lisp
   copy lisp.exe d:\lib\lisp
   copy lispinit.mem d:\lib\lisp

And create a batch file that starts lisp:

   copy con c:\bat\clisp.bat
   d:\lib\lisp\lisp.exe -M d:\lib\lisp\lispinit.mem %1 %2 %3 %4 %5 %6 %7 %8 %9
   [Ctrl-Z]


The editor:
-----------

Normally CLISP's ED function calls the editor you specified in config.lisp.
However, after you did

    (load "editor")

it invokes a builtin screen editor. It is a bit Emacs-like: you can evaluate
lisp expressions from within the editor, and the result is pasted into the
editor buffer. Type Alt-H to see the full set of commands.


When you encounter problems:
----------------------------

If clisp doesn't start up at all, check EMX-USER.DOC. lisp.exe is an EMX
application, so everything mentioned there applies to lisp.exe.

After errors, you are in the debugger:

     1. Break> _

You can evaluate forms, as usual. Furthermore:

     Help
               calles help
     Abort     or
     Unwind
               climbs up to next higher input loop
     (show-stack)
               shows the contents of the stack, helpful for debugging

And you can look at the values of the variables of the functions where the
error occurred.

On bigger problems, e.g. register dumps, please send a description of the error
and how to produce it reliably to the authors.


Mailing List:
-------------

There is a mailing list for users of CLISP. It is the proper forum for
questions about CLISP, installation problems, bug reports, application
packages etc.

For information about the list and how to subscribe it, send mail to
listserv@ma2s2.mathematik.uni-karlsruhe.de, with the two lines
          help
          information clisp-list
in the message body.


Acknowledgement:
----------------

If you find CLISP fast and bug-free and you like using it, a gift of $25
(or any amount you like) will be appreciated. Most DOS software costs
something, so you will probably already be used to paying.

If not, feel free to send us suggestions for improvement. Or grab the
source of CLISP, improve it yourself and send us your patches.

We are indebted to
  * Guy L. Steele and many others for the Common Lisp specification.
  * Richard Stallman's GNU project for GCC and the readline library.
  * Eberhard Mattes for EMX.


Authors:
--------

        Bruno Haible                    Michael Stoll
        Augartenstraße 40               Gallierweg 39
    D - W 7500 Karlsruhe 1          D - W 5300 Bonn 1
        Germany                         Germany

Email: haible@ma2s2.mathematik.uni-karlsruhe.de