mirrors/ecl
1
Fork 0
mirror of https://gitlab.com/embeddable-common-lisp/ecl.git synced 2026-03-14 08:50:48 -07:00
Code Issues Projects Releases Packages Wiki Activity

doc: fix section about the interpreter lexical environment

Browse source
This commit is contained in:
Marius Gerbershagen 2018-06-24 15:39:57 +02:00
parent 3bd980ce43
commit b56c9c12be
2 changed files with 26 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

33
src/doc/new-doc/developer-guide/interpreter.txi
View file

@ -1,6 +1,14 @@
@node The interpreter
@section The interpreter
@menu
* ECL stacks::
* Procedure Call Conventions::
* The lexical environment::
* The interpreter stack::
@end menu
@node ECL stacks
@subsection ECL stacks
ECL uses the following stacks:
@multitable @columnfractions .3 .7
@ -14,6 +22,7 @@ ECL uses the following stacks:
@tab used for arguments/values passing, typed lexical variables, temporary values, and function invocation.
@end multitable
@node Procedure Call Conventions
@subsection Procedure Call Conventions
ECL employs standard C calling conventions to achieve efficiency and
interoperability with other languages. Each Lisp function is
@ -69,20 +78,22 @@ instance, the actual source code for @code{cl_cons} in
@)
@end verbatim
@node The lexical environment
@subsection The lexical environment
The ECL interpreter uses two A-lists (Association lists) to represent
lexical environments.
@itemize
@item One for variable bindings
@item One for local function/macro/tag/block bindings
@end itemize
When a function closure is created, the current two A-lists are saved
in the closure along with the lambda expression. Later, when the
closure is invoked, the saved A-lists are used to recover the lexical
The ECL interpreter uses a list containing local functions and macros,
variables, tags and blocks to represent the lexical environment. When
a function closure is created, the current lexical environment is
saved in the closure along with the lambda expression. Later, when the
closure is invoked, this list is used to recover the lexical
environment.
Note that this list is different from what the Common Lisp standard
calls a lexical environment, which is the content of a
@code{&environment} parameter to @code{defmacro}. For the differences
between this two environments see the comments in
@code{src/c/compiler.d} and @code{src/c/interpreter.d}.
@node The interpreter stack
@subsection The interpreter stack
The bytecodes interpreter uses a stack of its own to save and restore

6
src/doc/new-doc/developer-guide/objects.txi
View file

@ -756,7 +756,9 @@ make_lambda function.
@cppindex cl_eval
@deftypefun cl_object si_safe_eval (cl_object form, cl_object env, ...)
@code{si_safe_eval} evaluates @code{form} in the lexical environment
@code{si_safe_eval} evaluates @code{form} in the lexical
environment@footnote{Note that @code{env} must be a lexical
environment as used in the interpreter, @xref{The lexical environment}}
@code{env}, which can be @var{ECL_NIL}. Before evaluating it, the
expression form must be bytecompiled.
@ -769,7 +771,7 @@ compatibility with previous versions.
Equivalent of @code{si_safe_eval} (macro define).
@end table
@subheading Exmaple
@subheading Example
@exindex @code{cl_safe_eval}
@example
si_object form = c_string_to_object("(print 1)");