


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 ] [ --LL _l_a_n_g_u_a_g_e ]
       [ --NN _d_i_r_e_c_t_o_r_y ] [ --qq ] [ --II ] [ --ii _i_n_i_t_f_i_l_e ...  ] [ --cc [
       --ll  ] _l_i_s_p_f_i_l_e [ --oo _o_u_t_p_u_t_f_i_l_e ] ...  ] [ --pp _p_a_c_k_a_g_e_n_a_m_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  megabytes.   The  argument  is  con-
              strained between 100 KB and 16 MB.  -- This version
              of cclliisspp 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.

       --LL _l_a_n_g_u_a_g_e
              Specifies the language cclliisspp  uses  to  communicate
              with  the user. This may be eenngglliisshh, ddeeuuttsscchh, ffrraann--
              ccaaiiss.

       --NN _d_i_r_e_c_t_o_r_y
              Specifies where the locale  message  files  may  be
              found.

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

       --II     ILISP friendly: cclliisspp interacts in a way that ILISP
              (a  popular  Emacs  LISP  interface) can deal with.
              Currently the only effect of this is that  unneces-
              sary prompts are not suppressed.

       --ii _i_n_i_t_f_i_l_e _._._.
              Specifies  initialization  files  to  be  _l_o_a_ded at



                           15 June 1995                         1





CLISP(1)                                                 CLISP(1)


              startup. These should be lisp files (source or com-
              piled).

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

       --oo _o_u_t_p_u_t_f_i_l_e
              Specifies the output file or directory for the com-
              pilation of the last specified _l_i_s_p_f_i_l_e.

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

       --pp _p_a_c_k_a_g_e_n_a_m_e
              At startup the value of the variable _*_p_a_c_k_a_g_e_* will
              be set to the package named _p_a_c_k_a_g_e_n_a_m_e.

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

       @@_o_p_t_i_o_n_f_i_l_e
              substitutes the contents  of  _o_p_t_i_o_n_f_i_l_e  as  argu-
              ments. Each line of _o_p_t_i_o_n_f_i_l_e is treated as a sep-
              arate argument to cclliisspp.


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.





                           15 June 1995                         2





CLISP(1)                                                 CLISP(1)


       EOF (Ctrl-Z)
              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
       _l_i_s_p_._e_x_e
              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

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

       _*_._c    C code, compiled from lisp source by cclliisspp

EENNVVIIRROONNMMEENNTT
       CCLLIISSPP__LLAANNGGUUAAGGEE
              specifies the language cclliisspp  uses  to  communicate
              with  the  user. The value may be eenngglliisshh, ddeeuuttsscchh,
              ffrraannccaaiiss and defaults to eenngglliisshh.   The  --LL  option
              can  be used to override this environment variable.

       LLAANNGG   specifies the language cclliisspp  uses  to  communicate
              with  the  user,  unless  it  is  already specified
              through the environment variable CCLLIISSPP__LLAANNGGUUAAGGEE  or
              the  --LL option. The value may begin with a two-let-
              ter ISO 639 language code, for example eenn, ddee,  ffrr.

       CCOOMMSSPPEECC (DOS, OS/2 implementations only)
              is  used  to find the command interpreter called by
              the function _s_h_e_l_l.

       TTEERRMM   specifies the terminal emulation cclliisspp  relies  on.
              If  you  have  ANSI.SYS loaded, possible values are
              _a_n_s_i, _a_n_s_i_-_c_o_l_o_r_-_2, _a_n_s_i_-_c_o_l_o_r_-_3 and _m_o_n_o.

       TTEERRMMCCAAPP
              should be set to the slashified file  name  of  the
              terminal capabilities database _t_e_r_m_c_a_p_._d_a_t.





                           15 June 1995                         3





CLISP(1)                                                 CLISP(1)


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.

       The memory management scheme is not very flexible.

       Not all 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.

       Stack overflow aborts the  program  ungracefully,  with  a
       register dump.

       Pressing Control-C may not interrupt cclliisspp in every situa-
       tion.

       Calling the function _e_x_e_c_u_t_e on batch  files  crashes  the
       machine.

PPRROOJJEECCTTSS
       Writing on-line documentation.

       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.






















                           15 June 1995                         4


