


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.  They depend on the
              preprocessor: ansidecl or traddecl.


       *.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




                        16 September 1997                       1





CLISP SOURCE(1)                                   CLISP SOURCE(1)


               win32.d        include file for Win32  based  ver-
                              sions

               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.




                        16 September 1997                       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



                        16 September 1997                       3





CLISP SOURCE(1)                                   CLISP SOURCE(1)


                              (arithmetic), see below.

               noreadline.d   Replacement    for   GNU   readline
                              library.

               dbxtypes.d     Declaration of types for  use  with
                              SUN's dbx (Sun version only).

               windows.d      Stuff  for  MS  Windows  3.1.  This
                              includes:

                   wintext.d      text windows

                   winstat.d      status window

                   winmain.d      the main window

                   winaux.d       auxiliary functions


           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



                        16 September 1997                       4





CLISP SOURCE(1)                                   CLISP SOURCE(1)


               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

               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



                        16 September 1997                       5





CLISP SOURCE(1)                                   CLISP SOURCE(1)


               ari80386.d          written in i386/i486 assembler

               arimips.d           written in MIPS assembler

               arihppa.d           written in HPPA-1.0 assembler

               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

               sp80386.d           written in i386/i486 assembler

               spmips.d            written in MIPS assembler



       Other assembly language stuff:

           cc_sparc.il
                  lisp stack access in SPARC assembler,  for  use
                  with Sun's cc

           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




                        16 September 1997                       6





CLISP SOURCE(1)                                   CLISP SOURCE(1)


           defmacro.lsp
                  implements defmacro

           macros1.lsp
                  the most important macros

           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:

                  cfglinux.lsp   for Unix, using Linux

                  cfgsunux.lsp   for Unix, using SunOS

                  cfgunix.lsp    for any other Unix




                        16 September 1997                       7





CLISP SOURCE(1)                                   CLISP SOURCE(1)


                  cfgamiga.lsp   for Amiga

                  cfgdos.lsp     for MS-DOS version

                  cfgwin32.lsp   for WinNT/Win95 version

                  cfgacorn.lsp   for Acorn, using RiscOS

           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




                        16 September 1997                       8





CLISP SOURCE(1)                                   CLISP SOURCE(1)


           FILES.1
                  nroff master for FILES

           CHANGES.LOG
                  lists the changes to the source

           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.txt
                  master  for  the  distribution's implementation
                  notes

           ../doc/cltl2.txt
                  list of X3J13 votes and their current status in
                  CLISP

           ../doc/foreign.txt
                  how to call foreign functions from within CLISP

           ../doc/module.txt
                  how to link external add-on modules to CLISP


       Internationalization:


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

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




                        16 September 1997                       9





CLISP SOURCE(1)                                   CLISP SOURCE(1)


       Automatic configuration on Unix:


           configure.in
                  lists the features to be checked

           autoconf/autoconf
                  the main program of GNU autoconf-2.12

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

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

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

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

           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









                        16 September 1997                      10


