


CLISP SOURCE(1)                                   CLISP SOURCE(1)


ABOUT
       The source files for CLISP.



FILE TYPES
       *.d    The source files for unpreprocessed C code.


       *.c    The C code after preprocessing by ansidecl.


       *.lsp  The source files for lisp code.


       *.fas  Compiled lisp code. Now platform-independent.



FILES
       Unpreprocessed C code:


           Includes:


               lispbibl.d     main include file

               fsubr.d        list of all built-in special forms

               subr.d         list of all built-in functions

               pseudofun.d    list of all "pseudo functions"

               constpack.d    list of packages accessed by C code

               constsym.d     list of symbols accessed by C code

               constobj.d     list   of   miscellaneous   objects
                              accessed by C code

               unix.d         include  file  for unix implementa-
                              tions

               amiga.d        include file for Amiga/AmigaOS ver-
                              sion

               amiga2.d       second  include file for Amiga/Ami-
                              gaOS version

               msdos.d        include file  for  MS-DOS  or  OS/2
                              based versions

               win32.d        include   file   for   Win32  based



                           17 July 1999                         1





CLISP SOURCE(1)                                   CLISP SOURCE(1)


                              versions

               xthread.d      include file for thread support

               modules.h      list of foreign modules

               version.h      version of CLISP


           Modules:

               spvw.d         Memory management (garbage  collec-
                              tion),  startup. some OS interface.

                   avl.d          An implementation of AVL (Adel-
                                  son-Velskii  and Landis) trees.

                   sort.d         A sorting routine.

                   subrkw.d       list of all built-in  functions
                                  with keywords

               spvwtabf.d     Table of built-in special forms and
                              functions.

               spvwtabs.d     Table  of  symbols  accessed  by  C
                              code.

               spvwtabo.d     Table   of   miscellaneous  objects
                              accessed by C code.

               eval.d         Evaluator  (form  interpreter)  and
                              bytecode interpreter.

                   bytecode.d     List of bytecodes.

               control.d      Special forms (form interpreter).

               pathname.d     Pathnames,   file-  and  directory-
                              related functions.

               stream.d       Streams of all kinds: file streams,
                              terminal   stream,  string  streams
                              etc.

               socket.d       Opening sockets for CLX.

               io.d           The  lisp   reader   (parser)   and
                              printer (also pretty printer).

               array.d        Functions  dealing  with arrays and
                              vectors.

               hashtabl.d     Functions dealing with hash tables.



                           17 July 1999                         2





CLISP SOURCE(1)                                   CLISP SOURCE(1)


               list.d         Functions dealing with lists.

               package.d      Functions dealing with packages.

               record.d       Functions   dealing   with  records
                              (structures, closures, etc.)

               sequence.d     The generic sequence functions.

               charstrg.d     Functions dealing  with  characters
                              and strings.

               debug.d        Support for debugging and the read-
                              eval-print loop.

               error.d        Error handling and signalling.

                   erramiga.d     AMIGAOS  specific  error   mes-
                                  sages.

                   errdjgpp.d     DJGPP  specific error messages.

                   errunix.d      Unix specific error messages.

                   errwin32.d     Win32 specific error  messages.

               misc.d         Miscellaneous functions.

               time.d         Timing functions.

               predtype.d     Predicates, type tests.

               symbol.d       Functions dealing with symbols.

               unixaux.d      Auxiliary  functions  (UNIX version
                              only).

               win32aux.d     Auxiliary functions (Win32  version
                              only).

               amigaaux.d     Auxiliary  functions (Amiga version
                              only).

               acornaux.d     Auxiliary  functions  (Acorn/RiscOS
                              version only).

               rexx.d         Low-level   Rexx  interface  (Amiga
                              version only).

               graph.d        Low-level graphics functions.

               foreign.d      Foreign function interface support.

               lisparit.d     Functions   dealing   with  numbers



                           17 July 1999                         3





CLISP SOURCE(1)                                   CLISP SOURCE(1)


                              (arithmetic), see below.

               noreadline.d   Replacement   for   GNU    readline
                              library.


           Number system (arithmetic):

               lisparit.d     initialization,   input/output   of
                              numbers, lisp functions

               aridecl.d      declarations

               arilev0.d      arithmetic at the machine level

               arilev1.d      digit sequences

               arilev1c.d     operations  on   digit   sequences,
                              written in C

               arilev1i.d     operations  on  digit sequences, as
                              inline functions

               arilev1e.d     operations  on   digit   sequences,
                              bindings to external routines

               intelem.d      integers: elementary operations

               intlog.d       integers: logical connectives

               intplus.d      integers: addition and subtraction

               intcomp.d      integers: comparison

               intbyte.d      integers:   byte   operations  ldb,
                              load-byte, ...

               intmal.d       integers: multiplication

               intdiv.d       integers: division

               intgcd.d       integers: gcd and lcm

               int2adic.d     integers:  operations   on   2-adic
                              integers

               intsqrt.d      integers: square root, n-th root

               intprint.d     subroutines for integer output

               intread.d      subroutines for integer input

               rational.d     rational numbers




                           17 July 1999                         4





CLISP SOURCE(1)                                   CLISP SOURCE(1)


               sfloat.d       elementary   operations  for  short
                              floats

               ffloat.d       elementary  operations  for  single
                              floats

               dfloat.d       elementary  operations  for  double
                              floats

               lfloat.d       elementary  operations   for   long
                              floats

               flo_konv.d     conversions between floats

               flo_rest.d     general float operations

               realelem.d     elementary  functions for real num-
                              bers

               realrand.d     random numbers

               realtran.d     transcendental functions  for  real
                              numbers

               compelem.d     elementary  functions  for  complex
                              numbers

               comptran.d     transcendental functions  for  com-
                              plex numbers


           External  routines for the arithmetic system, written
               in assembly language:

               ari68000.d          written  in  68000  assembler,
                                   MIT syntax

               ari68020.d          written  in  68020  assembler,
                                   MIT syntax

               arisparc.d          written in SPARC assembler

               arisparc64.d        written in 64-bit SPARC assem-
                                   bler

               ari80386.d          written in i386/i486 assembler

               arimips.d           written in MIPS assembler

               arimips64.d         written  in 64-bit MIPS assem-
                                   bler

               arihppa.d           written in HPPA-1.0 assembler




                           17 July 1999                         5





CLISP SOURCE(1)                                   CLISP SOURCE(1)


               arivaxunix.d        written in VAX assembler, Unix
                                   assembler syntax

               ariarm.d            written in ARM assembler


           External  routines  for  accessing the stack, written
               in assembly language:

               sp68000.d           written  in  68000  assembler,
                                   MIT syntax

               spsparc.d           written in SPARC assembler

               spsparc64.d         written in 64-bit SPARC assem-
                                   bler

               sp80386.d           written in i386/i486 assembler

               spmips.d            written in MIPS assembler



       Other assembly language stuff:

           asmi386.sh
                  converts i386 assembler from MIT  syntax  to  a
                  macro syntax

           asmi386.hh
                  expands  i386  assembler  in  macro  syntax  to
                  either MIT or Intel syntax


       Lisp source files:


           init.lsp
                  first file to be loaded, loads everything else

           defseq.lsp
                  defines  the  usual  sequence  types  for   the
                  generic sequence functions

           backquot.lsp
                  implements the backquote read macro

           defmacro.lsp
                  implements defmacro

           macros1.lsp
                  the most important macros





                           17 July 1999                         6





CLISP SOURCE(1)                                   CLISP SOURCE(1)


           macros2.lsp
                  some other macros

           defs1.lsp
                  miscellaneous definitions

           timezone.lsp
                  site-dependent  definition of time zone, except
                  for Unix

           places.lsp
                  macros using places, definitions of most places

           floatpri.lsp
                  printing floating point numbers in base 10

           type.lsp
                  functions  working with type specifiers: typep,
                  subtypep

           defstruc.lsp
                  implements the defstruct macro

           format.lsp
                  implements format

           user1.lsp
                  user interface, from the system's point of view

           user2.lsp
                  user interface, from the user's point of view

           trace.lsp
                  tracer

           macros3.lsp
                  (optional) the macros letf, letf* and ethe.

           config.lsp
                  (user  written)  site-dependent  configuration,
                  may be a link to one of the following:

                  cfgsunux.lsp   for Unix, using SunOS

                  cfgunix.lsp    for any other Unix

                  cfgamiga.lsp   for Amiga

                  cfgdos.lsp     for MS-DOS version

                  cfgwin32.lsp   for WinNT/Win95 version

                  cfgacorn.lsp   for Acorn, using RiscOS




                           17 July 1999                         7





CLISP SOURCE(1)                                   CLISP SOURCE(1)


           compiler.lsp
                  compiles lisp code to bytecode

           disassem.lsp
                  disassembles machine code

           defs2.lsp
                  miscellaneous CLtL2 compatible definitions

           loop.lsp
                  implements a CLtL2/dpANS compatible LOOP macro

           clos.lsp
                  implements a subset of the Common  Lisp  Object
                  System

           conditio.lsp
                  implements the Common Lisp Condition System

           defs3.lsp
                  more CLtL2 compatible definitions

           gstream.lsp
                  generic stream default methods

           foreign1.lsp
                  foreign language interface

           screen.lsp
                  the screen access package

           rexx1.lsp
                  for Amiga, an interface to Rexx

           editor.lsp
                  (optional) the screen editor

           spanish.lsp
                  spanish user messages


       Documentation:


           FILES  lists the source files

           FILES.1
                  nroff master for FILES

           bytecode.html
                  documents the bytecode instruction set

           CHANGES.LOG
                  lists the changes to the source



                           17 July 1999                         8





CLISP SOURCE(1)                                   CLISP SOURCE(1)


           NEWS   lists the user visible changes

           _README
                  master for the distribution's README

           _README.en, _README.de, _README.es
                  translations of _README

           _clisp.1
                  master for the distribution's manual page

           _clisp.html
                  master  for  the  distribution's manual page in
                  HTML format

           _impnotes.html
                  master for  the  distribution's  implementation
                  notes



       Internationalization:


           gettext/intl/*
                  internationalization  library,  taken  from GNU
                  gettext-0.10.35

           gettext/po/*.pot
                  list of translatable messages ("portable object
                  template")

           gettext/po/*.po
                  translated messages ("portable objects")

           gettext/po/*.gmo
                  translated   messages   ("GNU   format  message
                  objects")


       Automatic configuration on Unix:


           configure.in
                  lists the features to be checked

           autoconf/autoconf
                  the main program of GNU autoconf-2.13

           autoconf/autoconf.m4
                  autoconf's driver macros.  Part  of  GNU  auto-
                  conf-2.13





                           17 July 1999                         9





CLISP SOURCE(1)                                   CLISP SOURCE(1)


           autoconf/acgeneral.m4
                  autoconf's   general  feature  testing  macros.
                  Part of GNU autoconf-2.13

           autoconf/acspecific.m4
                  macros that test for  some  standard  features.
                  Part of GNU autoconf-2.13

           autoconf/aclocal.m4
                  a  repertoire  of features.  Use with GNU auto-
                  conf-2.13

           configure
                  configuration script, checks for dozens of fea-
                  tures

           intparam.d
                  figures out some machine parameters (word size,
                  endianness etc.)

           intparam.c
                  preprocessed version of intparam.d

           unixconf.h.in
                  header file  master.  unixconf.h  contains  the
                  values  of the features found out by configure.

           makemake.in
                  makefile construction script master

           _clisp.c
                  master for the distribution's driver program

           _distmakefile
                  master for the distribution's Makefile






















                           17 July 1999                        10


