ecl(1) - f14

1ECL(1)                      General Commands Manual                     ECL(1)
2
3
4

NAME

6       ecl - Embeddable Common LISP
7

SYNOPSIS

9       ecl [-dir dir] [-load file] [-eval expr]
10           [-compile file
11               [-o  ofile]  [-c  [cfile]] [-h [hfile]] [-data [datafile]] [-s]
12       [-q]]
13
14

DESCRIPTION

16       ECL stands for Embeddable Common-Lisp.  The ECL project is an effort to
17       modernize  Giuseppe Attardi's ECL environment to produce an implementa‐
18       tion of the Common-Lisp language which complies to the ANSI X3J13 defi‐
19       nition of the language.
20
21       The current ECL implementation features:
22
23       ·      A bytecodes compiler and interpreter.
24
25       ·      A translator to C.
26
27       ·      An interface to foreign functions.
28
29       ·      A dynamic loader.
30
31       ·      The possibility to build standalone executables.
32
33       ·      The Common-Lisp Object System (CLOS).
34
35       ·      Conditions and restarts for handling errors.
36
37       ·      Sockets as ordinary streams.
38
39       ·      The Gnu Multiprecision library for fast bignum operations.
40
41       ·      A simple conservative mark & sweep garbage collector.
42
43       ·      The Boehm-Weiser garbage collector.
44
45
46       ecl without any argument gives you the interactive lisp.
47

OPTIONS

49       -shell file
50                 Executes  the given file and exits, without providing a read-
51                 eval-print loop.  If you want to use lisp as a scripting lan‐
52                 guage,  you can write #!/usr/bin/ecl -shell on the first line
53                 of the file to be executed, and then ECL  will  be  automati‐
54                 cally invoked.
55
56       -norc     Do not try to load the file ~/.eclrc at startup.
57
58       -dir      Use dir as system directory.
59
60       -load file
61                 Loads file before entering the read-eval-print loop.
62
63       -eval expr
64                 Evaluates expr before entering the read-eval-print loop.
65
66       -compile file
67                 Translates file to C and invokes the local C compiler to pro‐
68                 duce a shared library with .fas as extension per default.
69
70       -o ofile  When compiling file name the resulting shared library ofile.
71
72       -c cfile  When compiling name the intermediary C file cfile and do  not
73                 delete it afterwards.
74
75       -h hfile  When  compiling  name  the intermediary C header hfile and do
76                 not delete it afterwards.
77
78       -data [datafile]
79                 Dumps compiler data into datafile or, if not supplied, into a
80                 file  named  after  the source file, but with .data as exten‐
81                 sion.
82
83       -s        Produce a linkable object file.  It  cannot  be  loaded  with
84                 load,  but  it  can  be used to build libraries or standalone
85                 executable programs.
86
87       -q        Produce less notes when compiling.
88
89
90       The options -load, -shell, and -eval may appear any  number  of  times,
91       and they are combined and processed from left to right.
92

AUTHORS

94       The  original  version  was developed by Giuseppe Attardi starting from
95       the Kyoto Common  Lisp  implementation  by  Taiichi  Yuasa  and  Masami
96       Hagiya.   The current maintainer of ECL is Juan Jose Garcia Ripoll, who
97       can be reached at the ECL mailing list.
98

FILES

100       ~/.ecl, ~/.eclrc
101              Default initialization files loaded at startup unless the option
102              -norc is provided.  (if they exist).
103

BUGS

110       Probably some. Report them!
111
112
113
114
1154th Berkeley Distribution          03/10/03                             ECL(1)