


CLISP(1)                                                 CLISP(1)


NNAAMMEE
       clisp - Common Lisp language interpreter and compiler

SSYYNNOOPPSSIISS
       cclliisspp  [  --hh  |  ----hheellpp ] [ ----vveerrssiioonn ] [ ----lliicceennssee ] [ --BB
       _l_i_s_p_l_i_b_d_i_r ] [ --KK _l_i_n_k_i_n_g_-_s_e_t ] [ --MM _m_e_m_f_i_l_e ] [  --mm  _m_e_m_-
       _s_i_z_e  ] [ --LL _l_a_n_g_u_a_g_e ] [ --NN _l_o_c_a_l_e_d_i_r ] [ --EE_d_o_m_a_i_n _e_n_c_o_d_-
       _i_n_g ] [ --qq | ----qquuiieett | ----ssiilleenntt ] [ --ww ] [ --II ] [ --aa  ]  [
       --pp  _p_a_c_k_a_g_e_n_a_m_e  ] [ --CC ] [ --nnoorrcc ] [ --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 ] ...  ] [  --xx  _e_x_p_r_e_s_-
       _s_i_o_n ] [ _l_i_s_p_f_i_l_e [ _a_r_g_u_m_e_n_t ] ]

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, ----hheellpp
              Displays a help message on how to use cclliisspp.

       ----vveerrssiioonn
              Displays  the cclliisspp version number, as given by the
              function call _(_l_i_s_p_-_i_m_p_l_e_m_e_n_t_a_t_i_o_n_-_v_e_r_s_i_o_n_).

       ----lliicceennssee
              Displays a summary of  the  licensing  information,
              the GNU GPL.

       --BB _l_i_s_p_l_i_b_d_i_r
              Specifies  the  installation directory. This is the
              directory containing the  linking  sets  and  other
              data files.  This option is normally not necessary,
              because  the  installation  directory  is   already
              built-in in the cclliisspp executable.

       --KK _l_i_n_k_i_n_g_-_s_e_t
              Specifies  the  linking  set  to  be run. This is a
              directory containing at least a main executable and
              an  initial memory image. Possible values are bbaassee,
              ffuullll.  The default is bbaassee.

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

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



                         15 January 2000                        1





CLISP(1)                                                 CLISP(1)


              (measured in bytes), _n_n_n_nKK or _n_n_n_nKKBB  (measured  in
              kilobytes)  or  _nMM  or _nMMBB (measured in megabytes).
              Default is  2  megabytes.   The  argument  is  con-
              strained above 100 KB.  -- This version of cclliisspp is
              not likely to actually use the entire _m_e_m_s_i_z_e since
              garbage  collection  will  periodically  reduce the
              amount of used memory.  It is therefore  common  to
              specify  10  MB  even  if only 2 MB are going to be
              used.

       --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, eessppaannooll.  Other languages  may  be  specified
              through the environment variable LLAANNGG, provided the
              corresponding message catalog is installed.

       --NN _l_o_c_a_l_e_d_i_r
              Specifies  the  base  directory  of  locale  files.
              cclliisspp   will   search   its   message  catalogs  in
              _l_o_c_a_l_e_d_i_r/_l_a_n_g_u_a_g_e/LC_MESSAGES/clisp.mo.

       --EE_d_o_m_a_i_n _e_n_c_o_d_i_n_g
              Specifies the encoding used  for  a  given  domain,
              overriding  the  default which depends on the envi-
              ronment variables LLCC__AALLLL, LLCC__CCTTYYPPEE,  LLAANNGG.   _d_o_m_a_i_n
              can  be ffiillee, affecting **ddeeffaauulltt--ffiillee--eennccooddiinngg**, or
              ppaatthhnnaammee, affecting **ppaatthhnnaammee--eennccooddiinngg**, or  tteerrmmii--
              nnaall,  affecting  **tteerrmmiinnaall--eennccooddiinngg**,  or  ffoorreeiiggnn,
              affecting **ffoorreeiiggnn--eennccooddiinngg**,  or  mmiisscc,  affecting
              **mmiisscc--eennccooddiinngg**.

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

       --ww     Wait for keypress after program termination.

       --II     Be ILISP friendly. ILISP is  an  alternative  Emacs
              interface to Common Lisp systems. With this option,
              cclliisspp interacts in a way that ILISP can deal  with.
              Currently  the only effect of this is that unneces-
              sary prompts are not suppressed.  Furthermore,  the
              GNU  readline  library treats Tab as a normal self-
              inserting character.

       --aa     ANSI CL compliant: Comply with the ANSI CL specifi-
              cation  even  on those issues where ANSI CL is bro-
              ken. This option is provided for maximum  portabil-
              ity  of Lisp programs, and is not useful for actual
              everyday work. It sets the  variable  _*_p_a_c_k_a_g_e_*  to
              CCOOMMMMOONN--LLIISSPP--UUSSEERR, and the symbol macro _*_a_n_s_i_* to tt.
              See impnotes.html, section "Maximum ANSI CL compli-
              ance", for details.



                         15 January 2000                        2





CLISP(1)                                                 CLISP(1)


       --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.   The
              default  is  the  package which was active when the
              image was saved, normally UUSSEERR, or CCOOMMMMOONN--LLIISSPP--UUSSEERR
              if the option --aa was specified.

       --CC     Compile  when  load:  At  startup  the value of the
              variable _*_l_o_a_d_-_c_o_m_p_i_l_i_n_g_* will be set to  tt.   Code
              being _l_o_a_ded will then be compiled on the fly. This
              results in slower loading, but faster execution.

       --nnoorrcc  Normally cclliisspp loads a user run control  (RC)  file
              on  startup  (this  happens  after the --CC option is
              processed).       The      file      loaded      is
              $${{HHOOMMEE}}//..cclliisspprrcc..llsspp    or    $${{HHOOMMEE}}//..cclliisspprrcc..ffaass,
              whichever is newest. This option,  --nnoorrcc,,  prevents
              loading of the RC file.

       --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).  Several  --ii  options can be given; all the
              specified files will be loaded in order.

       --cc _l_i_s_p_f_i_l_e _._._.
              Compiles  the  specified  _l_i_s_p_f_i_l_es   to   bytecode
              (*.fas).  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 (*.lis) of the files being com-
              piled will be produced.  Useful only for  debugging
              purposes. See the documentation of _c_o_m_p_i_l_e_-_f_i_l_e for
              details.

       --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 double quotes,  and
              double  quotes  and backslashes must be preceded by
              backslashes.

       _l_i_s_p_f_i_l_e [_a_r_g_u_m_e_n_t _._._.]
              Loads and executes a _l_i_s_p_f_i_l_e.  There  will  be  no
              read-eval-print  loop.  Before  _l_i_s_p_f_i_l_e is loaded,
              the variable _*_a_r_g_s_* will be  bound  to  a  list  of
              strings,  representing  the  _a_r_g_u_m_e_n_ts.   The first
              line of _l_i_s_p_f_i_l_e may start with ##!!, thus permitting



                         15 January 2000                        3





CLISP(1)                                                 CLISP(1)


              cclliisspp to be used as a script interpreter.  If _l_i_s_p_-
              _f_i_l_e is --, the standard input is used instead of  a
              file.  This option must be the last one. No RC file
              will be executed.


RREEFFEERREENNCCEE
       The language implemented mostly conforms to
              ANSI Common Lisp standard X3.226-1994
              http://www.x3.org/tc_home/j13sd4.htm
       available online as the
              Common Lisp HyperSpec
              http://www.harlequin.com/education/books/HyperSpec/
              ("CLHS" for short)
       which supersedes the earlier specifications
              Guy L. Steele Jr.: Common Lisp - The Language.
              Digital Press. 2nd edition 1990, 1032 pages.
              http://www.cs.cmu.edu/afs/cs.cmu.edu/project/ai-
        repository/ai/html/cltl/cltl2.html
              ("CLtL2" for short)
       and
              Guy L. Steele Jr.: Common Lisp - The Language.
              Digital Press. 1st edition 1984, 465 pages.
              ("CLtL1" 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



                         15 January 2000                        4





CLISP(1)                                                 CLISP(1)


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

       LLCC__CCTTYYPPEE
              specifies the locale which determines the character
              set  in use.  The value can be of the form _l_a_n_g_u_a_g_e
              or  _l_a_n_g_u_a_g_e___c_o_u_n_t_r_y  or  _l_a_n_g_u_a_g_e___c_o_u_n_t_r_y_._c_h_a_r_s_e_t,
              where  _l_a_n_g_u_a_g_e  is  a  two-letter ISO 639 language
              code (lower case), and _c_o_u_n_t_r_y is a two-letter  ISO
              3166  country  code  (upper  case).   _c_h_a_r_s_e_t is an
              optional character  set  specification,  and  needs
              normally not be given because the character set can
              be inferred from the language and country.

       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.  It also specifies the locale deter-
              mining the character set  in  use,  unless  already
              specified    through   the   environment   variable
              LLCC__CCTTYYPPEE.  The value may begin  with  a  two-letter
              ISO 639 language code, for example eenn, ddee, ffrr.

       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 interactive command interpreter
              called by _(_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
       impnotes.html, _c_m_u_c_l(1), _x_e_m_a_c_s(1).

BBUUGGSS
       The function _i_n_s_p_e_c_t is not implemented.




                         15 January 2000                        5





CLISP(1)                                                 CLISP(1)


       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.

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@clisp.cons.org> and Michael Stoll.








































                         15 January 2000                        6


