home *** CD-ROM | disk | FTP | other *** search
/ Il CD di internet / CD.iso / SOURCE / D / CLISP / CLISPSRC.TAR / clisp-1995-01-01 / os2 / clisp.man < prev    next >
Encoding:
Text File  |  1994-08-28  |  7.6 KB  |  265 lines
  1.  
  2.  
  3.  
  4. CLISP(1)                                                 CLISP(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        clisp - Common Lisp language interpreter and compiler
  9.  
  10. SSYYNNOOPPSSIISS
  11.        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 ]
  12.        [ --qq ] [ --II ] [ --ii _i_n_i_t_f_i_l_e ...  ] [ --cc [  --ll  ]  _l_i_s_p_f_i_l_e
  13.        ...  ] [ --xx _e_x_p_r_e_s_s_i_o_n ]
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.        Invokes the common lisp interpreter and compiler.  Invoked
  17.        without arguments, executes  a  read-eval-print  loop,  in
  18.        which  expressions  are  in turn read from standard input,
  19.        evaluated by the lisp interpreter, and their results  out-
  20.        put  to  standard  output.  Invoked with --cc, the specified
  21.        lisp files are compiled to a bytecode that can be executed
  22.        more efficiently.
  23.  
  24. OOPPTTIIOONNSS
  25.        --hh     Displays a help message on how to use cclliisspp.
  26.  
  27.        --mm _m_e_m_s_i_z_e
  28.               Sets  the  amount  of memory cclliisspp tries to grab on
  29.               startup.  The amount may be given as _n_n_n_n_n_n_n  (mea-
  30.               sured in bytes), _n_n_n_nKK or _n_n_n_nKKBB (measured in kilo-
  31.               bytes)  or  _nMM  or  _nMMBB  (measured  in  megabytes).
  32.               Default  is  2  megabytes.   The  argument  is con-
  33.               strained between 100 KB and 16 MB.  -- This version
  34.               of  _c_l_i_s_p allocates memory dynamically.  _m_e_m_s_i_z_e is
  35.               essentially ignored.
  36.  
  37.        --MM _m_e_m_f_i_l_e
  38.               Specifies the initial memory image.  This must be a
  39.               memory dump produced by the _s_a_v_e_i_n_i_t_m_e_m function.
  40.  
  41.        --LL _l_a_n_g_u_a_g_e
  42.               Specifies  the  language  cclliisspp uses to communicate
  43.               with the user. This may be eenngglliisshh, ddeeuuttsscchh,  ffrraann--
  44.               ccaaiiss.
  45.  
  46.        --qq     Quiet:  cclliisspp  displays no banner at startup and no
  47.               good-bye message when quitting.
  48.  
  49.        --II     ILISP friendly: cclliisspp interacts in a way that ILISP
  50.               (a  popular  Emacs  LISP  interface) can deal with.
  51.               Currently the only effect of this is that  unneces-
  52.               sary prompts are not suppressed.
  53.  
  54.        --ii _i_n_i_t_f_i_l_e _._._.
  55.               Specifies  initialization  files  to  be  _l_o_a_ded at
  56.               startup. These should be lisp files (source or com-
  57.               piled).
  58.  
  59.        --cc _l_i_s_p_f_i_l_e _._._.
  60.               Compiles  the  specified lispfiles to bytecode. The
  61.  
  62.  
  63.  
  64.                            19 June 1994                         1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CLISP(1)                                                 CLISP(1)
  71.  
  72.  
  73.               compiled files can then be _l_o_a_ded  instead  of  the
  74.               sources to gain efficiency.
  75.  
  76.        --ll     A bytecode listing of the files being compiled will
  77.               be produced.  Useful only for debugging purposes.
  78.  
  79.        --xx _e_x_p_r_e_s_s_i_o_n_s
  80.               Executes a series of arbitrary expressions  instead
  81.               of  a  read-eval-print  loop.   The  values  of the
  82.               expressions will be output to standard output.  Due
  83.               to  the  argument processing done by the shell, the
  84.               _e_x_p_r_e_s_s_i_o_n_s must be enclosed in single quotes,  and
  85.               double  quotes  and backslashes must be preceded by
  86.               backslashes.
  87.  
  88.        @@_o_p_t_i_o_n_f_i_l_e
  89.               substitutes the contents  of  _o_p_t_i_o_n_f_i_l_e  as  argu-
  90.               ments. Each line of _o_p_t_i_o_n_f_i_l_e is treated as a sep-
  91.               arate argument to cclliisspp.
  92.  
  93.  
  94. RREEFFEERREENNCCEE
  95.        The language implemented conforms to
  96.               Guy L. Steele Jr.: Common Lisp - The Language.
  97.               Digital Press. 1st edition 1984, 465 pages.
  98.               ("CLtL1" for short)
  99.        and to the older parts of
  100.               Guy L. Steele Jr.: Common Lisp - The Language.
  101.               Digital Press. 2nd edition 1990, 1032 pages.
  102.               ("CLtL2" for short)
  103.  
  104. UUSSEE
  105.        hheellpp   to get some on-line help.
  106.  
  107.        ((aapprrooppooss _n_a_m_e))
  108.               lists the symbols relating to _n_a_m_e.
  109.  
  110.        ((eexxiitt)) or ((qquuiitt)) or ((bbyyee))
  111.               to quit cclliisspp.
  112.  
  113.        EOF (Ctrl-Z)
  114.               to leave the current read-eval-print loop.
  115.  
  116.        arrow keys
  117.               for editing and viewing the input history.
  118.  
  119.        Tab key
  120.               to complete the symbol's name you are just  typing.
  121.  
  122. FFIILLEESS
  123.        _l_i_s_p_._e_x_e
  124.               main executable
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                            19 June 1994                         2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CLISP(1)                                                 CLISP(1)
  137.  
  138.  
  139.        _l_i_s_p_i_n_i_t_._m_e_m
  140.               initial memory image
  141.  
  142.        _c_o_n_f_i_g_._l_s_p
  143.               site-dependent configuration
  144.  
  145.        _*_._l_s_p  lisp source
  146.  
  147.        _*_._f_a_s  lisp code, compiled by cclliisspp
  148.  
  149.        _*_._l_i_b  lisp source library information, generated and used
  150.               by the cclliisspp compiler
  151.  
  152. EENNVVIIRROONNMMEENNTT
  153.        CCLLIISSPP__LLAANNGGUUAAGGEE
  154.               specifies the language cclliisspp  uses  to  communicate
  155.               with  the  user. The value may be eenngglliisshh, ddeeuuttsscchh,
  156.               ffrraannccaaiiss and defaults to eenngglliisshh.   The  --LL  option
  157.               can  be used to override this environment variable.
  158.  
  159.        CCOOMMSSPPEECC (DOS, OS/2 implementations only)
  160.               is used to find the command interpreter  called  by
  161.               the function _s_h_e_l_l.
  162.  
  163.        TTEERRMM   specifies  the  terminal emulation cclliisspp relies on.
  164.               If you have ANSI.SYS loaded,  possible  values  are
  165.               _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.
  166.  
  167.        TTEERRMMCCAAPP
  168.               should  be  set  to the slashified file name of the
  169.               terminal capabilities database _t_e_r_m_c_a_p_._d_a_t.
  170.  
  171. SSEEEE AALLSSOO
  172.        _c_m_u_l_i_s_p(1), _e_m_a_c_s(1).
  173.  
  174. BBUUGGSS
  175.        The function _i_n_s_p_e_c_t is not implemented.
  176.  
  177.        Only very few extensions from CLtL2 are supported.
  178.  
  179.        No on-line documentation beyond _a_p_r_o_p_o_s  and  _d_e_s_c_r_i_b_e  is
  180.        available.
  181.  
  182.        Stack  overflow  aborts  the  program ungracefully, with a
  183.        register dump.
  184.  
  185.        Pressing Control-C may not interrupt cclliisspp in every situa-
  186.        tion.
  187.  
  188.        Calling  the  function  EXECUTE on batch files crashes the
  189.        machine.
  190.  
  191. PPRROOJJEECCTTSS
  192.        Writing on-line documentation.
  193.  
  194.  
  195.  
  196.                            19 June 1994                         3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. CLISP(1)                                                 CLISP(1)
  203.  
  204.  
  205.        Building a foreign function interface (ability to  call  C
  206.        code directly).
  207.  
  208.        Write _i_n_s_p_e_c_t.
  209.  
  210.        Enhance  the  compiler such that it can inline local func-
  211.        tions.
  212.  
  213.        Specify a portable set of window and graphics  operations.
  214.  
  215. AAUUTTHHOORRSS
  216.        Bruno   Haible  <haible@ma2s2.mathematik.uni-karlsruhe.de>
  217.        and Michael Stoll.
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                            19 June 1994                         4
  263.  
  264.  
  265.