home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / RiscOS / APP / DEVS / LISP / CLISP.ZIP / CLisp / !CLisp / MAN / CLISP
Text File  |  1995-01-04  |  5KB  |  156 lines
  1.  
  2.                                                 CLISP(1)"1 January 1995"
  3.  
  4.  
  5.  
  6. NAME
  7.      clisp - Common Lisp language interpreter and compiler
  8.  
  9. SYNOPSIS
  10.      clisp [ -h ] [ -m memsize ] [ -M memfile ] [ -L language ] [ -q ] [
  11.      -I ] [ -i initfile ...  ] [ -c [ -l ] lispfile [ -o outputfile ]
  12.      ...  ] [ -x expression ]
  13.  
  14. DESCRIPTION
  15.      Invokes the common lisp interpreter and compiler.  Invoked without
  16.      arguments, executes a read-eval-print loop, in which expressions
  17.      are in turn read from standard input, evaluated by the lisp
  18.      interpreter, and their results output to standard output.  Invoked
  19.      with -c, the specified lisp files are compiled to a bytecode that
  20.      can be executed more efficiently.
  21.  
  22. OPTIONS
  23.  
  24.      -h   Displays a help message on how to use clisp.
  25.  
  26.      -m memsize
  27.           Sets the amount of memory clisp tries to grab on startup.  The
  28.           amount may be given as nnnnnnn (measured in bytes), nnnnK or
  29.           nnnnKB (measured in kilobytes) or nM or nMB (measured in
  30.           megabytes).  Default is 2 megabytes.  The argument is
  31.           constrained between 100 KB and 16 MB.  -- This version of
  32.           clisp allocates memory dynamically.  memsize is essentially
  33.           ignored.
  34.  
  35.      -M memfile
  36.           Specifies the initial memory image.  This must be a memory
  37.           dump produced by the saveinitmem function.
  38.  
  39.      -L language
  40.           Specifies the language clisp uses to communicate with the
  41.           user.  This may be english, deutsch, francais.
  42.  
  43.      -q   Quiet:  clisp displays no banner at startup and no good-bye
  44.           message when quitting.
  45.  
  46.      -I   ILISP friendly:  clisp interacts in a way that ILISP (a
  47.           popular Emacs LISP interface) can deal with.  Currently the
  48.           only effect of this is that unnecessary prompts are not
  49.           suppressed.
  50.  
  51.      -i initfile ...
  52.           Specifies initialization files to be loaded at startup.  These
  53.           should be lisp files (source or compiled).
  54.  
  55.      -c lispfile ...
  56.           Compiles the specified lispfiles to bytecode.  The compiled
  57.           files can then be loaded instead of the sources to gain
  58.           efficiency.
  59.  
  60.      -o outputfile
  61.           Specifies the output file or directory for the compilation of
  62.           the last specified lispfile.
  63.  
  64.      -l   A bytecode listing of the files being compiled will be
  65.           produced.  Useful only for debugging purposes.
  66.  
  67.      -x expressions
  68.           Executes a series of arbitrary expressions instead of a
  69.           read-eval-print loop.  The values of the expressions will be
  70.           output to standard output.  Due to the argument processing
  71.           done by the shell, the expressions must be enclosed in single
  72.           quotes, and double quotes and backslashes must be preceded by
  73.           backslashes.
  74.  
  75.  
  76. REFERENCE
  77.      The language implemented conforms to
  78.           1
  79.           Guy L. Steele Jr.:  Common Lisp - The Language.
  80.           Digital Press.  1st edition 1984, 465 pages.
  81.           ("CLtL1" for short)
  82.      and to the older parts of
  83.           1
  84.           Guy L. Steele Jr.:  Common Lisp - The Language.
  85.           Digital Press.  2nd edition 1990, 1032 pages.
  86.           ("CLtL2" for short)
  87.  
  88. USE
  89.  
  90.      help to get some on-line help.
  91.  
  92.      (apropos name)
  93.           lists the symbols relating to name.
  94.  
  95.      (exit) or (quit) or (bye)
  96.           to quit clisp.
  97.  
  98.      EOF (Ctrl-D)
  99.           to leave the current read-eval-print loop.
  100.  
  101. FILES
  102.  
  103.      lisp main executable
  104.  
  105.      lispinit.mem
  106.           initial memory image
  107.  
  108.      config.lsp
  109.           site-dependent configuration
  110.  
  111.      *.lsp
  112.           lisp source
  113.  
  114.      *.fas
  115.           lisp code, compiled by clisp
  116.  
  117.      *.lib
  118.           lisp source library information, generated and used by the
  119.           clisp compiler
  120.  
  121. ENVIRONMENT
  122.  
  123.      CLISP_LANGUAGE
  124.           specifies the language clisp uses to communicate with the
  125.           user.  The value may be english, deutsch, francais and
  126.           defaults to english.  The -L option can be used to override
  127.           this environment variable.
  128.  
  129. "SEE ALSO"
  130.      cmulisp(1), emacs(1).
  131.  
  132. BUGS
  133.  
  134.      The function inspect is not implemented.
  135.  
  136.      Only very few extensions from CLtL2 are supported.
  137.  
  138.      No on-line documentation beyond apropos and describe is available.
  139.  
  140. PROJECTS
  141.  
  142.      Writing on-line documentation.
  143.  
  144.      Building a foreign function interface (ability to call C code
  145.      directly).
  146.  
  147.      Write inspect.
  148.  
  149.      Enhance the compiler such that it can inline local functions.
  150.  
  151.      Specify a portable set of window and graphics operations.
  152.  
  153. AUTHORS
  154.      Bruno Haible <haible@ma2s2.mathematik.uni-karlsruhe.de> and Michael
  155.      Stoll.
  156.