home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Misc / CLISP-1.LHA / CLISP960530-sr.lha / amiga / clisp.man < prev    next >
Encoding:
Text File  |  1996-08-13  |  5.9 KB  |  181 lines
  1. CLISP(1)                 USER COMMANDS                   CLISP(1)
  2.  
  3. NAME
  4.      clisp - Common Lisp language interpreter and compiler
  5.  
  6. SYNOPSIS
  7.      clisp [ -h ] [ -m memsize ] [ -s stacksize ] [ -M memfile  ]
  8.      [ -L language ] [ -q ] [ -I ] [ -i initfile ...  ] [ -c [ -l
  9.      ] lispfile [ -o outputfile ] ...  ] [ -p packagename ] [  -x
  10.      expression ]
  11.  
  12. DESCRIPTION
  13.      Invokes the common lisp interpreter and  compiler.   Invoked
  14.      without arguments, executes a read-eval-print loop, in which
  15.      expressions are in turn read from standard input,  evaluated
  16.      by  the  lisp interpreter, and their results output to stan-
  17.      dard output.  Invoked with -c, the specified lisp files  are
  18.      compiled  to  a  bytecode  that  can  be executed more effi-
  19.      ciently.
  20.  
  21. OPTIONS
  22.      -h   Displays a help message on how to use clisp.
  23.  
  24.      -m memsize
  25.           Sets the amount  of  memory  clisp  tries  to  grab  on
  26.           startup.   The amount may be given as nnnnnnn (measured
  27.           in bytes), nnnnK or nnnnKB (measured in  kilobytes)  or
  28.           nM  or nMB (measured in megabytes).  Default is 2 mega-
  29.           bytes.  The argument is constrained between 100 KB  and
  30.           16  MB.   --  This  version  of  clisp allocates memory
  31.           dynamically.  memsize is essentially ignored.
  32.  
  33.      -s stacksize
  34.           Sets the size of the stack clisp allocates for  itself.
  35.           The  syntax is the same as for memsize.  Default is one
  36.           eighth of memsize.  The argument is constrained between
  37.           40 KB and 8 MB.
  38.  
  39.      -M memfile
  40.           Specifies the initial memory image.   This  must  be  a
  41.           memory dump produced by the saveinitmem function.
  42.  
  43.      -L language
  44.           Specifies the language clisp uses to  communicate  with
  45.           the user. This may be english, deutsch, francais.
  46.  
  47.      -q   Quiet: clisp displays  no  banner  at  startup  and  no
  48.           good-bye message when quitting.
  49.  
  50.      -I   ILISP friendly: clisp interacts in a way that ILISP  (a
  51.           popular Emacs LISP interface) can deal with.  Currently
  52.           the only effect of this is that unnecessary prompts are
  53.           not suppressed.
  54.  
  55.      -i initfile ...
  56.           Specifies initialization files to be loaded at startup.
  57.           These should be lisp files (source or compiled).
  58.  
  59.      -c lispfile ...
  60.           Compiles the specified lispfiles to bytecode. The  com-
  61.           piled  files  can then be loaded instead of the sources
  62.           to gain efficiency.
  63.  
  64.      -o outputfile
  65.           Specifies the output file or directory for the compila-
  66.           tion of the last specified lispfile.
  67.  
  68.      -l   A bytecode listing of the files being compiled will  be
  69.           produced.  Useful only for debugging purposes.
  70.  
  71.      -p packagename
  72.           At startup the value of the variable *package* will  be
  73.           set to the package named packagename.
  74.  
  75.      -x expressions
  76.           Executes a series of arbitrary expressions instead of a
  77.           read-eval-print  loop.   The  values of the expressions
  78.           will be output to standard output.  Due to the argument
  79.           processing  done  by the shell, the expressions must be
  80.           enclosed  in  single  quotes,  and  double  quotes  and
  81.           backslashes must be preceded by backslashes.
  82.  
  83. WORKBENCH
  84.      Two kinds of tooltypes are supported:
  85.  
  86.      WINDOW= windowspec
  87.           clisp will communicate with the console window or  pipe
  88.           specified by windowspec.
  89.  
  90.      ARGS= arguments
  91.           Specifies the command line arguments for clisp.  Within
  92.           arguments  the  token  `*'  may  be  used to denote the
  93.           project's filename.  arguments defaults to `-i *' which
  94.           means that the file will be loaded (see above).
  95.  
  96. REFERENCE
  97.      The language implemented conforms to
  98.             Guy L. Steele Jr.: Common Lisp - The Language.
  99.             Digital Press. 1st edition 1984, 465 pages.
  100.             ("CLtL1" for short)
  101.      and to the older parts of
  102.             Guy L. Steele Jr.: Common Lisp - The Language.
  103.             Digital Press. 2nd edition 1990, 1032 pages.
  104.             ("CLtL2" for short)
  105.  
  106. USE
  107.      help to get some on-line help.
  108.  
  109.      (apropos name)
  110.           lists the symbols relating to name.
  111.  
  112.      (exit) or (quit) or (bye)
  113.           to quit clisp.
  114.  
  115.      EOF (Ctrl-\)
  116.           to leave the current read-eval-print loop.
  117.  
  118. FILES
  119.      lisp.run
  120.           main executable
  121.  
  122.      lispinit.mem
  123.           initial memory image
  124.  
  125.      config.lsp
  126.           site-dependent configuration
  127.  
  128.      *.lsp
  129.           lisp source
  130.  
  131.      *.fas
  132.           lisp code, compiled by clisp
  133.  
  134.      *.lib
  135.           lisp source library information, generated and used  by
  136.           the clisp compiler
  137.  
  138. ENVIRONMENT
  139.      CLISP_LANGUAGE
  140.           specifies the language clisp uses to  communicate  with
  141.           the  user.  The value may be english, deutsch, francais
  142.           and defaults to english.  The -L option can be used  to
  143.           override this environment variable.
  144.  
  145.      Language
  146.           specifies the language clisp uses to  communicate  with
  147.           the  user,  unless  it is already specified through the
  148.           environment variable CLISP_LANGUAGE or the  -L  option.
  149.           The value may be as above.
  150.  
  151.      LANG specifies the language clisp uses to  communicate  with
  152.           the  user,  unless  it is already specified through the
  153.           environment variable CLISP_LANGUAGE or the  -L  option.
  154.           The  value may begin with a two-letter ISO 639 language
  155.           code, for example en, de, fr.
  156.  
  157. SEE ALSO
  158.      cmulisp(1), emacs(1).
  159.  
  160. BUGS
  161.      The function inspect is not implemented.
  162.  
  163.      Not all extensions from CLtL2 are supported.
  164.  
  165.      No on-line documentation  beyond  apropos  and  describe  is
  166.      available.
  167.  
  168. PROJECTS
  169.      Writing on-line documentation.
  170.  
  171.      Write inspect.
  172.  
  173.      Enhance the compiler such that it  can  inline  local  func-
  174.      tions.
  175.  
  176.      Specify a portable set of window and graphics operations.
  177.  
  178. AUTHORS
  179.      Bruno Haible <haible@ma2s2.mathematik.uni-karlsruhe.de>  and
  180.      Michael Stoll.
  181.