


CLISP(1)                 USER COMMANDS                   CLISP(1)



NAME
     clisp - Common Lisp language interpreter and compiler

SYNOPSIS
     clisp [ -h | --help ] [ --version  ]  [  --license  ]  [  -B
     _l_i_s_p_l_i_b_d_i_r  ] [ -K _l_i_n_k_i_n_g-_s_e_t ] [ -M _m_e_m_f_i_l_e ] [ -m _m_e_m_s_i_z_e
     ] [ -L _l_a_n_g_u_a_g_e ] [ -N _l_o_c_a_l_e_d_i_r ] [ -E_d_o_m_a_i_n _e_n_c_o_d_i_n_g  ]  [
     -q  |  --quiet  | --silent ] [ -w ] [ -I ] [ -a ] [ -p _p_a_c_k_-
     _a_g_e_n_a_m_e ] [ -C ] [ -norc ] [ -i _i_n_i_t_f_i_l_e ...  ] [ -c [ -l  ]
     _l_i_s_p_f_i_l_e  [  -o  _o_u_t_p_u_t_f_i_l_e  ]  ...   ]  [ -x _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 ] ]

DESCRIPTION
     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 stan-
     dard output.  Invoked with -c, the specified lisp files  are
     compiled  to  a  bytecode  that  can  be executed more effi-
     ciently.

OPTIONS
     -h, --help
          Displays a help message on how to use clisp.

     --version
          Displays the clisp 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).

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

     -B _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
          clisp executable.

     -K _l_i_n_k_i_n_g-_s_e_t
          Specifies the linking set to be run. This is  a  direc-
          tory  containing at least a main executable and an ini-
          tial memory image. Possible values are base, full.  The
          default is base.

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

     -m _m_e_m_s_i_z_e



Sun Release 4.1   Last change: 15 January 2000                  1






CLISP(1)                 USER COMMANDS                   CLISP(1)



          Sets the amount  of  memory  clisp  tries  to  grab  on
          startup.   The amount may be given as _n_n_n_n_n_n_n (measured
          in bytes), _n_n_n_nK or _n_n_n_nKB (measured in  kilobytes)  or
          _nM  or _nMB (measured in megabytes).  Default is 2 mega-
          bytes.  The argument is constrained above 100  KB.   --
          This version of clisp is not likely to actually use the
          entire _m_e_m_s_i_z_e since garbage collection  will  periodi-
          cally  reduce  the amount of used memory.  It is there-
          fore common to specify 10 MB even  if  only  2  MB  are
          going to be used.

     -L _l_a_n_g_u_a_g_e
          Specifies the language clisp uses to  communicate  with
          the user. This may be english, deutsch, francais, Other
          languages may  be  specified  through  the  environment
          variable LANG, provided the corresponding message cata-
          log is installed.

     -N _l_o_c_a_l_e_d_i_r
          Specifies the base directory of  locale  files.   clisp
          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.

     -E_d_o_m_a_i_n _e_n_c_o_d_i_n_g
          Specifies the encoding used for a given  domain,  over-
          riding  the  default  which  depends on the environment
          variables LC_ALL, LC_CTYPE, LANG.  _d_o_m_a_i_n can be  file,
          affecting *default-file-encoding*, or pathname, affect-
          ing   *pathname-encoding*,   or   terminal,   affecting
          *terminal-encoding*,  or  foreign,  affecting *foreign-
          encoding*, or misc, affecting *misc-encoding*.

     -q, --quiet, --silent
          Quiet: clisp displays  no  banner  at  startup  and  no
          good-bye message when quitting.

     -w   Wait for keypress after program termination.

     -I   Be ILISP friendly. ILISP is an alternative Emacs inter-
          face  to  Common  Lisp systems. With this option, clisp
          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.

     -a   ANSI CL compliant: Comply with the ANSI  CL  specifica-
          tion even on those issues where ANSI CL is broken. This
          option is provided for maximum portability of Lisp pro-
          grams,  and  is not useful for actual everyday work. It
          sets the variable *_p_a_c_k_a_g_e*  to  COMMON-LISP-USER,  and
          the  symbol macro *_a_n_s_i* to t.  See impnotes.html, sec-
          tion "Maximum ANSI CL compliance", for details.



Sun Release 4.1   Last change: 15 January 2000                  2






CLISP(1)                 USER COMMANDS                   CLISP(1)



     -p _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 USER, or COMMON-LISP-USER if the option -a was
          specified.

     -C   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 t.  Code being _l_o_a_ded
          will then be compiled  on  the  fly.  This  results  in
          slower loading, but faster execution.

     -norc
          Normally clisp loads a user run control  (RC)  file  on
          startup  (this  happens  after  the  -C  option is pro-
          cessed).  The file loaded  is  ${HOME}/.clisprc.lsp  or
          ${HOME}/.clisprc.fas, whichever is newest. This option,
          -norc, prevents loading of the RC file.

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

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

     -o _o_u_t_p_u_t_f_i_l_e
          Specifies the output file or directory for the compila-
          tion of the last specified _l_i_s_p_f_i_l_e.

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

     -x _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 vari-
          able *_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 clisp to be used  as



Sun Release 4.1   Last change: 15 January 2000                  3






CLISP(1)                 USER COMMANDS                   CLISP(1)



          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.

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

USE
     help to get some on-line help.

     (apropos _n_a_m_e)
          lists the symbols relating to _n_a_m_e.

     (exit) or (quit) or (bye)
          to quit clisp.

     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.

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



Sun Release 4.1   Last change: 15 January 2000                  4






CLISP(1)                 USER COMMANDS                   CLISP(1)



          site-dependent configuration

     *._l_s_p
          lisp source

     *._f_a_s
          lisp code, compiled by clisp

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

     *._c  C code, compiled from lisp source by clisp

ENVIRONMENT
     CLISP_LANGUAGE
          specifies the language clisp uses to  communicate  with
          the  user.  The value may be english, deutsch, francais
          and defaults to english.  The -L option can be used  to
          override this environment variable.

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

     LANG specifies the language clisp uses to  communicate  with
          the  user,  unless  it is already specified through the
          environment variable CLISP_LANGUAGE or the  -L  option.
          It  also specifies the locale determining the character
          set  in  use,  unless  already  specified  through  the
          environment  variable  LC_CTYPE.   The  value may begin
          with a two-letter ISO 639 language  code,  for  example
          en, de, fr.

     HOME and USER
          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.)

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

     TERM determines the screen size  recognized  by  the  pretty
          printer.   This  environment variable is also mandatory
          for the built-in screen editor.



Sun Release 4.1   Last change: 15 January 2000                  5






CLISP(1)                 USER COMMANDS                   CLISP(1)



SEE ALSO
     impnotes.html, _c_m_u_c_l(1), _x_e_m_a_c_s(1).

BUGS
     The function _i_n_s_p_e_c_t is not implemented.

     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.

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

AUTHORS
     Bruno Haible <haible@clisp.cons.org> and Michael Stoll.
































Sun Release 4.1   Last change: 15 January 2000                  6



