CLISP(1)                                                 CLISP(1)


NNAAMMEE
       clisp - Common Lisp language interpreter and compiler

SSYYNNOOPPSSIISS
       cclliisspp  [  --hh  ]  [ --mm _m_e_m_s_i_z_e ] [ --MM _m_e_m_f_i_l_e ] [ --qq ] [ --ii
       _i_n_i_t_f_i_l_e ...  ] [ --cc [ --ll ] _l_i_s_p_f_i_l_e ...  ] [  --xx  _e_x_p_r_e_s_-
       _s_i_o_n ]

DDEESSCCRRIIPPTTIIOONN
       Invokes the common lisp interpreter and compiler.  Invoked
       without arguments, executes  a  read-eval-print  loop,  in
       which  expressions  are  in turn read from standard input,
       evaluated by the lisp interpreter, and their results  out-
       put  to  standard  output.  Invoked with --cc, the specified
       lisp files are compiled to a bytecode that can be executed
       more efficiently.

OOPPTTIIOONNSS
       --hh     Displays a help message on how to use cclliisspp.

       --mm _m_e_m_s_i_z_e
              Sets  the  amount  of memory cclliisspp tries to grab on
              startup.  The amount may be given as _n_n_n_n_n_n_n  (mea-
              sured in bytes), _n_n_n_nKK or _n_n_n_nKKBB (measured in kilo-
              bytes)  or  _nMM  or  _nMMBB  (measured  in  megabytes).
              Default  is  2.5  megabytes.   The argument is con-
              strained between 100 KB and 16 MB.  -- This version
              of  _c_l_i_s_p allocates memory dynamically.  _m_e_m_s_i_z_e is
              essentially ignored.

       --MM _m_e_m_f_i_l_e
              Specifies the initial memory image.  This must be a
              memory  dump  produced by the _s_a_v_e_i_n_i_t_m_e_m function.
              It may have been compressed using GNU  gzip.   This
              option  is normally already set by the shell script
              //uussrr//llooccaall//bbiinn//cclliisspp.

       --qq     Quiet: cclliisspp displays no banner at startup  and  no
              good-bye message when quitting.

       --ii _i_n_i_t_f_i_l_e _._._.
              Specifies  initialization  files  to  be  _l_o_a_ded at
              startup. These should be lisp files (source or com-
              piled).

       --cc _l_i_s_p_f_i_l_e _._._.
              Compiles  the  specified lispfiles to bytecode. The
              compiled files can then be _l_o_a_ded  instead  of  the
              sources to gain efficiency.

       --ll     A bytecode listing of the files being compiled will
              be produced.  Useful only for debugging purposes.





                          26 August 1993                        1





CLISP(1)                                                 CLISP(1)


       --xx _e_x_p_r_e_s_s_i_o_n_s
              Executes a series of arbitrary expressions  instead
              of  a  read-eval-print  loop.   The  values  of the
              expressions will be output to standard output.  Due
              to  the  argument processing done by the shell, the
              _e_x_p_r_e_s_s_i_o_n_s must be enclosed in single quotes,  and
              double  quotes  and backslashes must be preceded by
              backslashes.


RREEFFEERREENNCCEE
       The language implemented conforms to
              Guy L. Steele Jr.: Common Lisp - The Language.
              Digital Press. 1st edition 1984, 465 pages.
              ("CLtL1" for short)
       and to the older parts of
              Guy L. Steele Jr.: Common Lisp - The Language.
              Digital Press. 2nd edition 1990, 1032 pages.
              ("CLtL2" for short)

UUSSEE
       hheellpp   to get some on-line help.

       ((aapprrooppooss _n_a_m_e))
              lists the symbols relating to _n_a_m_e.

       ((eexxiitt)) or ((qquuiitt)) or ((bbyyee))
              to quit cclliisspp.

       EOF (Ctrl-D)
              to leave the current read-eval-print loop.

       arrow keys
              for editing and viewing the input history.

       Tab key
              to complete the symbol's name you are just  typing.

FFIILLEESS
       _c_l_i_s_p  startup script

       _l_i_s_p_._r_u_n
              main executable

       _l_i_s_p_i_n_i_t_._m_e_m
              initial memory image

       _c_o_n_f_i_g_._l_s_p
              site-dependent configuration

       _*_._l_s_p  lisp source

       _*_._f_a_s  lisp code, compiled by cclliisspp




                          26 August 1993                        2





CLISP(1)                                                 CLISP(1)


       _*_._l_i_b  lisp source library information, generated and used
              by the cclliisspp compiler

EENNVVIIRROONNMMEENNTT
       HHOOMMEE and UUSSEERR
              are used for determining the value of the  function
              _u_s_e_r_-_h_o_m_e_d_i_r_-_p_a_t_h_n_a_m_e.  (Unix implementation only.)

       SSHHEELLLL (Unix implementation only)
              is used to find the command interpreter  called  by
              the function _s_h_e_l_l.

       TTEERRMM   determines the screen size recognized by the pretty
              printer.  This environment variable is also  manda-
              tory for the built-in screen editor.

SSEEEE AALLSSOO
       _c_m_u_l_i_s_p(1), _e_m_a_c_s(1).

BBUUGGSS
       The function _i_n_s_p_e_c_t is not implemented.

       Only very few extensions from CLtL2 are supported.

       No  on-line  documentation  beyond _a_p_r_o_p_o_s and _d_e_s_c_r_i_b_e is
       available.

PPRROOJJEECCTTSS
       Writing on-line documentation.

       Building a foreign function interface (ability to  call  C
       code directly).

       Write _i_n_s_p_e_c_t.

       Enhance  the  compiler such that it can inline local func-
       tions.

       Specify a portable set of window and graphics  operations.

AAUUTTHHOORRSS
       Bruno   Haible  <haible@ma2s2.mathematik.uni-karlsruhe.de>
       and Michael Stoll.














                          26 August 1993                        3