home *** CD-ROM | disk | FTP | other *** search
/ Il CD di internet / CD.iso / SOURCE / D / CLISP / CLISPSRC.TAR / clisp-1995-01-01 / dos / clisp.man < prev    next >
Encoding:
Text File  |  1994-10-28  |  7.2 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.                          24 October 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.                          24 October 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. SSEEEE AALLSSOO
  164.        _c_m_u_l_i_s_p(1), _e_m_a_c_s(1).
  165.  
  166. BBUUGGSS
  167.        The function _i_n_s_p_e_c_t is not implemented.
  168.  
  169.        Only very few extensions from CLtL2 are supported.
  170.  
  171.        No  on-line  documentation  beyond _a_p_r_o_p_o_s and _d_e_s_c_r_i_b_e is
  172.        available.
  173.  
  174.        Stack overflow aborts the  program  ungracefully,  with  a
  175.        register dump.
  176.  
  177.        Pressing Control-C may not interrupt cclliisspp in every situa-
  178.        tion.
  179.  
  180.        Calling the function EXECUTE on batch  files  crashes  the
  181.        machine.
  182.  
  183. PPRROOJJEECCTTSS
  184.        Writing on-line documentation.
  185.  
  186.        Building  a  foreign function interface (ability to call C
  187.        code directly).
  188.  
  189.        Write _i_n_s_p_e_c_t.
  190.  
  191.        Enhance the compiler such that it can inline  local  func-
  192.        tions.
  193.  
  194.  
  195.  
  196.                          24 October 1994                        3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. CLISP(1)                                                 CLISP(1)
  203.  
  204.  
  205.        Specify  a portable set of window and graphics operations.
  206.  
  207. AAUUTTHHOORRSS
  208.        Bruno  Haible   <haible@ma2s2.mathematik.uni-karlsruhe.de>
  209.        and Michael Stoll.
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  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.                          24 October 1994                        4
  263.  
  264.  
  265.