summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
Diffstat (limited to 'txr.1')
-rw-r--r--txr.112
1 files changed, 11 insertions, 1 deletions
diff --git a/txr.1 b/txr.1
index 1be7a991..df893a07 100644
--- a/txr.1
+++ b/txr.1
@@ -75474,12 +75474,22 @@ If the argument is a lambda expression, then that function is
compiled.
If the argument is a function object, and that object is an interpreted
-function, then its code is retrieved and compiled.
+function, then its code and lexical environment are retrieved and compiled.
In all cases, the return value of
.code compile
is the compiled function.
+Note: when an interpreted function object is compiled, the compiled environment
+does not share bindings with the original interpreted environment.
+Modifications to the bindings of either environment have no effect on the
+other. However, the objects referenced by the bindings are shared. Shared
+bindings may be arranged using the
+.code hlet
+or
+.code hlet*
+macros.
+
.coNP Functions @ compile-file and @ compile-update-file
.synb
.mets (compile-file < input-path <> [ output-path ])