


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  ]  [
       --aannssii ] [ --ttrraaddiittiioonnaall ] [ --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
       output 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
              (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
              constrained 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,
              ffrraannccaaiiss,   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
              environment  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   tteerrmmiinnaall,   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
              unnecessary    prompts    are    not    suppressed.
              Furthermore, the GNU readline library treats Tab as
              a normal self-inserting character.

       --aannssii  ANSI  CL  compliant:  Comply  with  the   ANSI   CL
              specification even on those issues where ANSI CL is
              broken.  This  option  is  provided   for   maximum
              portability of Lisp programs, and is not useful for
              actual everyday work.  It  sets  the  symbol  macro
              _*_a_n_s_i_*  to  tt.  See impnotes.html, section "Maximum
              ANSI CL compliance", for details.

       --ttrraaddiittiioonnaall
              Traditional: reverses the residual effects of --aannssii
              in the saved image.

       --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..lliisspp    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
              compiled). 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
              compilation of the last specified _l_i_s_p_f_i_l_e.

       --ll     A  bytecode  listing  (*.lis)  of  the  files being
              compiled  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
              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.lisp.org/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_i_s_p
              site-dependent configuration

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

SSEEEE AALLSSOO
       impnotes.html, _c_m_u_c_l(1), _e_m_a_c_s(1), _x_e_m_a_c_s(1).

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

       Enhance   the   compiler  so  that  it  can  inline  local
       functions.

       Specify a portable set of window and graphics  operations.

AAUUTTHHOORRSS
       Bruno Haible and Michael Stoll.



































