


CLISP SOURCE(1)                                   CLISP SOURCE(1)


AABBOOUUTT
       The source files for CLISP.



FFIILLEE TTYYPPEESS
       **..dd    The source files for unpreprocessed C code.


       **..cc    The C code after preprocessing.  They depend on the
              preprocessor: ansidecl or traddecl.


       **..llsspp  The source files for lisp code.


       **..ffaass  Compiled lisp code. Depends on the machine on which
              CLISP  runs  and  (perhaps) on the compiler used to
              build CLISP.



FFIILLEESS
       Unpreprocessed C code:


           Includes:


               lliissppbbiibbll..dd     main include file

               ffssuubbrr..dd        list of all built-in special forms

               ssuubbrr..dd         list of all built-in functions

               ppsseeuuddooffuunn..dd    list of all "pseudo functions"

               ccoonnssttppaacckk..dd    list of packages accessed by C code

               ccoonnssttssyymm..dd     list of symbols accessed by C code

               ccoonnssttoobbjj..dd     list   of   miscellaneous   objects
                              accessed by C code

               uunniixx..dd         include file for  unix  implementa-
                              tions

               aattaarrii..dd        include file for Atari/TOS version

               aammiiggaa..dd        include file for Amiga/AmigaOS ver-
                              sion

               aammiiggaa22..dd       second     include     file     for
                              Amiga/AmigaOS version



                          1 January 1995                        1





CLISP SOURCE(1)                                   CLISP SOURCE(1)


               mmssddooss..dd        include  file  for  MS-DOS  or OS/2
                              based versions

               mmoodduulleess..hh      list of foreign modules

               vveerrssiioonn..hh      version of CLISP


           Modules:

               ssppvvww..dd         Memory management (garbage  collec-
                              tion),  startup. some OS interface.

                   aavvll..dd      An implementation of AVL  (Adelson-
                              Velskii and Landis) trees.

                   ssoorrtt..dd     A sorting routine.

               ssppvvwwttaabbff..dd     Table of built-in special forms and
                              functions.

               ssppvvwwttaabbss..dd     Table  of  symbols  accessed  by  C
                              code.

               ssppvvwwttaabboo..dd     Table   of   miscellaneous  objects
                              accessed by C code.

               eevvaall..dd         Evaluator  (form  interpreter)  and
                              bytecode interpreter.

               ccoonnttrrooll..dd      Special forms (form interpreter).

               ppaatthhnnaammee..dd     Pathnames,   file-  and  directory-
                              related functions.

               ssttrreeaamm..dd       Streams of all kinds: file streams,
                              terminal   stream,  string  streams
                              etc.

               ssoocckkeett..dd       Opening sockets for CLX.

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

               aarrrraayy..dd        Functions  dealing  with arrays and
                              vectors.

               hhaasshhttaabbll..dd     Functions dealing with hash tables.

               lliisstt..dd         Functions dealing with lists.

               ppaacckkaaggee..dd      Functions dealing with packages.

               rreeccoorrdd..dd       Functions   dealing   with  records



                          1 January 1995                        2





CLISP SOURCE(1)                                   CLISP SOURCE(1)


                              (structures, closures, etc.)

               sseeqquueennccee..dd     The generic sequence functions.

               cchhaarrssttrrgg..dd     Functions dealing  with  characters
                              and strings.

               ddeebbuugg..dd        Support for debugging and the read-
                              eval-print loop.

               eerrrroorr..dd        Error handling and signalling.

               mmiisscc..dd         Miscellaneous functions.

               pprreeddttyyppee..dd     Predicates, type tests.

               ssyymmbbooll..dd       Functions dealing with symbols.

               uunniixxaauuxx..dd      Auxiliary functions  (UNIX  version
                              only).

               ssttddwwiinn..dd       Interface to the STDWIN library.

               rreexxxx..dd         Low-level   Rexx  interface  (Amiga
                              version only).

               ggrraapphh..dd        Low-level graphics functions.

               lliissppaarriitt00..dd    Functions  dealing   with   numbers
                              (arithmetic).

               nnoorreeaaddlliinnee..dd   Replacement    for   GNU   readline
                              library.

               ddbbxxttyyppeess..dd     Declaration of types for  use  with
                              SUN's dbx (Sun version only).

               aallgglloobbaall..dd     Declaration of all global variables
                              of the library (Atari  TOS  version
                              only).

               mmaaiinn..dd         Declaration  of auxiliary functions
                              for use with Gcc 2.

               wwiinnddoowwss..dd      Stuff  for  MS  Windows  3.1.  This
                              includes:

                   wwiinntteexxtt..dd      text windows

                   wwiinnssttaatt..dd      status window

                   wwiinnmmaaiinn..dd      the main window

                   wwiinnaauuxx..dd       auxiliary functions



                          1 January 1995                        3





CLISP SOURCE(1)                                   CLISP SOURCE(1)


           Number system (arithmetic):

               lliissppaarriitt..dd     initialization,   input/output   of
                              numbers, lisp functions

               aarriiddeeccll..dd      declarations

               aarriilleevv00..dd      arithmetic at the machine level

               aarriilleevv11..dd      digit sequences

               aarriilleevv11cc..dd     operations  on   digit   sequences,
                              written in C

               aarriilleevv11ii..dd     operations  on  digit sequences, as
                              inline functions

               aarriilleevv11ee..dd     operations  on   digit   sequences,
                              bindings to external routines

               iinntteelleemm..dd      integers: elementary operations

               iinnttlloogg..dd       integers: logical connectives

               iinnttpplluuss..dd      integers: addition and subtraction

               iinnttccoommpp..dd      integers: comparison

               iinnttbbyyttee..dd      integers:   byte   operations  _l_d_b,
                              _l_o_a_d_-_b_y_t_e, ...

               iinnttmmaall..dd       integers: multiplication

               iinnttddiivv..dd       integers: division

               iinnttggccdd..dd       integers: gcd and lcm

               iinntt22aaddiicc..dd     integers:  operations   on   2-adic
                              integers

               iinnttssqqrrtt..dd      integers: square root, n-th root

               iinnttpprriinntt..dd     subroutines for integer output

               iinnttrreeaadd..dd      subroutines for integer input

               rraattiioonnaall..dd     rational numbers

               ssffllooaatt..dd       elementary   operations  for  short
                              floats

               ffffllooaatt..dd       elementary  operations  for  single
                              floats




                          1 January 1995                        4





CLISP SOURCE(1)                                   CLISP SOURCE(1)


               ddffllooaatt..dd       elementary  operations  for  double
                              floats

               llffllooaatt..dd       elementary  operations   for   long
                              floats

               fflloo__kkoonnvv..dd     conversions between floats

               fflloo__rreesstt..dd     general float operations

               rreeaalleelleemm..dd     elementary  functions for real num-
                              bers

               rreeaallrraanndd..dd     random numbers

               rreeaallttrraann..dd     transcendental functions  for  real
                              numbers

               ccoommppeelleemm..dd     elementary  functions  for  complex
                              numbers

               ccoommppttrraann..dd     transcendental functions  for  com-
                              plex numbers


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

               aarrii6688000000..mmiitt..dd      written  in  68000  assembler,
                                   MIT syntax

               aarrii6688000000..mmoott..dd      written  in  68000  assembler,
                                   Motorola syntax

               aarrii6688000000..aattaarrii..dd    written  in  68000  assembler,
                                   MIT syntax, use this for Atari
                                   version

               aarrii6688002200..mmiitt..dd      written  in  68020  assembler,
                                   MIT syntax

               aarrii6688002200..mmoott..dd      written  in  68020  assembler,
                                   Motorola syntax

               aarriissppaarrcc..dd          written in SPARC assembler

               aarrii8800338866..dd          written in i386/i486 assembler

               aarriimmiippss..dd           written in MIPS assembler

               aarriihhppppaa..dd           written in HPPA-1.0 assembler

               aarriivvaaxxuunniixx..dd        written in VAX assembler, Unix
                                   assembler syntax



                          1 January 1995                        5





CLISP SOURCE(1)                                   CLISP SOURCE(1)


               aarriiaarrmm..dd            written in ARM assembler


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

               sspp6688000000..mmiitt..dd       written  in  68000  assembler,
                                   MIT syntax

               sspp6688000000..mmoott..dd       written  in  68000  assembler,
                                   Motorola syntax

               ssppssppaarrcc..dd           written in SPARC assembler

               sspp8800338866..dd           written in i386/i486 assembler

               ssppmmiippss..dd            written in MIPS assembler



       Other C stuff:

           mmoodduullee..cccc
                  automatic initialization of foreign modules


       Other assembly language stuff:

           cccc__ssppaarrcc..iill
                  lisp stack access in SPARC assembler,  for  use
                  with Sun's cc


       Lisp source files:


           iinniitt..llsspp
                  first file to be loaded, loads everything else

           ddeeffsseeqq..llsspp
                  defines   the  usual  sequence  types  for  the
                  generic sequence functions

           bbaacckkqquuoott..llsspp
                  implements the backquote read macro

           ddeeffmmaaccrroo..llsspp
                  implements _d_e_f_m_a_c_r_o

           mmaaccrrooss11..llsspp
                  the most important macros

           mmaaccrrooss22..llsspp
                  some other macros



                          1 January 1995                        6





CLISP SOURCE(1)                                   CLISP SOURCE(1)


           ddeeffss11..llsspp
                  miscellaneous definitions

           ttiimmeezzoonnee..llsspp
                  site-dependent definition of time zone,  except
                  for Unix

           ppllaacceess..llsspp
                  macros using places, definitions of most places

           ffllooaattpprrii..llsspp
                  printing floating point numbers in base 10

           ttyyppee..llsspp
                  functions working with type specifiers:  _t_y_p_e_p,
                  _s_u_b_t_y_p_e_p

           ddeeffssttrruucc..llsspp
                  implements the _d_e_f_s_t_r_u_c_t macro

           ffoorrmmaatt..llsspp
                  implements _f_o_r_m_a_t

           uusseerr11..llsspp
                  user interface, from the system's point of view

           uusseerr22..llsspp
                  user interface, from the user's point of view

           ttrraaccee..llsspp
                  tracer

           mmaaccrrooss33..llsspp
                  (optional) the macros _l_e_t_f, _l_e_t_f_* and _e_t_h_e.

           ccoonnffiigg..llsspp
                  (user  written)  site-dependent  configuration,
                  may be a link to one of the following:

                  ccffgglliinnuuxx..llsspp   for Unix, using Linux

                  ccffggssuunnuuxx..llsspp   for Unix, using SunOS

                  ccffgguunniixx..llsspp    for any other Unix

                  ccffggaattffdd..llsspp    for Atari, using floppy disk A:

                  ccffggaatthhdd..llsspp    for Atari, using hard disk E:

                  ccffggaammiiggaa..llsspp   for Amiga

                  ccffggddooss..llsspp     for MS-DOS version

                  ccffggaaccoorrnn..llsspp   for Acorn, using RiscOS



                          1 January 1995                        7





CLISP SOURCE(1)                                   CLISP SOURCE(1)


           ccoommppiilleerr..llsspp
                  compiles lisp code to bytecode

           ddeeffss22..llsspp
                  miscellaneous CLtL2 compatible definitions

           lloooopp..llsspp
                  implements a CLtL2/dpANS compatible LOOP macro

           ccllooss..llsspp
                  implements  a  subset of the Common Lisp Object
                  System

           ccoonnddiittiioo..llsspp
                  implements the Common Lisp Condition System

           ddeeffss33..llsspp
                  more CLtL2 compatible definitions

           ggssttrreeaamm..llsspp
                  generic stream default methods

           ssccrreeeenn..llsspp
                  the screen access package

           ssttddwwiinn22..llsspp
                  part 2 of the interface to the STDWIN library

           rreexxxx..llsspp
                  for Amiga, an interface to Rexx

           eeddiittoorr..llsspp
                  (optional) the screen editor


       Documentation:


           FFIILLEESS  lists the source files

           FFIILLEESS..11
                  nroff master for _F_I_L_E_S

           CCHHAANNGGEESS..LLOOGG
                  lists the changes to the source

           NNEEWWSS   lists the user visible changes

           __RREEAADDMMEE
                  master for the distribution's README

           __cclliisspp..11
                  master for the distribution's manual page




                          1 January 1995                        8





CLISP SOURCE(1)                                   CLISP SOURCE(1)


           __cclliisspp..hhttmmll
                  master for the distribution's  manual  page  in
                  HTML format

           __iimmppnnootteess..ttxxtt
                  master  for  the  distribution's implementation
                  notes

           ....//ddoocc//ccllttll22..ttxxtt
                  list of X3J13 votes and their current status in
                  CLISP

           ffoorreeiiggnn..ttxxtt
                  how to call foreign functions from within CLISP


       Automatic configuration on Unix:


           ccoonnffiigguurree..iinn
                  lists the features to be checked

           aauuttooccoonnff--11..77//aauuttooccoonnff
                  the main program of GNU autoconf-1.7

           aauuttooccoonnff--11..77//aaccggeenneerraall..mm44
                  _a_u_t_o_c_o_n_f's  general  feature  testing   macros.
                  Part of GNU autoconf-1.7

           aauuttooccoonnff--11..77//aaccssppeecciiffiicc..mm44
                  macros  that  test  for some standard features.
                  Part of GNU autoconf-1.7

           aauuttooccoonnff--11..77//aaccllooccaall..mm44
                  a repertoire of features.  Use with  GNU  auto-
                  conf-1.7

           aauuttooccoonnff--22..11//aauuttooccoonnff
                  the main program of GNU autoconf-2.1

           aauuttooccoonnff--22..11//aauuttooccoonnff..mm44
                  _a_u_t_o_c_o_n_f's  driver  macros.   Part of GNU auto-
                  conf-2.1

           aauuttooccoonnff--22..11//aaccggeenneerraall..mm44
                  _a_u_t_o_c_o_n_f's  general  feature  testing   macros.
                  Part of GNU autoconf-2.1

           aauuttooccoonnff--22..11//aaccssppeecciiffiicc..mm44
                  macros  that  test  for some standard features.
                  Part of GNU autoconf-2.1

           aauuttooccoonnff--22..11//aaccllooccaall..mm44
                  a  repertoire  of  features.   Use   with   GNU



                          1 January 1995                        9





CLISP SOURCE(1)                                   CLISP SOURCE(1)


                  autoconf-2.1

           ccoonnffiigguurree
                  configuration script, checks for dozens of fea-
                  tures

           mmaacchhiinnee..dd
                  figures out some machine parameters (word size,
                  endianness etc.)

           mmaacchhiinnee..cc
                  preprocessed version of _m_a_c_h_i_n_e_._d

           uunniixxccoonnff..hh..iinn
                  header  file  master.  unixconf.h  contains the
                  values of the features found out by  configure.

           mmaakkeemmaakkee..iinn
                  makefile construction script master

           __ddiissttmmaakkeeffiillee
                  master for the distribution's Makefile



































                          1 January 1995                       10


