summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2020-02-29 18:25:58 -0800
committerKaz Kylheku <kaz@kylheku.com>2020-02-29 18:25:58 -0800
commitf9185f425f8e62b4a3b8103b5d94a434196c5038 (patch)
treee12390c55797cadafed75c076bb5405c484da95a /txr.1
parent63aa5a2de08d2dadd3b8de50c7b31e30b1458c58 (diff)
downloadtxr-f9185f425f8e62b4a3b8103b5d94a434196c5038.tar.gz
txr-f9185f425f8e62b4a3b8103b5d94a434196c5038.tar.bz2
txr-f9185f425f8e62b4a3b8103b5d94a434196c5038.zip
doc: better wording on lisp compilation.
* txr.1: Rewriting awkward language in overview of file compilation.
Diffstat (limited to 'txr.1')
-rw-r--r--txr.127
1 files changed, 11 insertions, 16 deletions
diff --git a/txr.1 b/txr.1
index 0239ac9d..a5827f72 100644
--- a/txr.1
+++ b/txr.1
@@ -69781,23 +69781,18 @@ file name suffix) is translated into an object file (named with a
.code .tlo
suffix) containing a compiled version of those forms.
-The intent is that loading the compiled
-.code .tlo
-file via the
+The compiled object file can then be loaded via the
.code load
-function produces the same effect as loading the
-.code .tl
-file. The main difference is that the compiled file
-contains no Lisp source code; only the machine code instructions for the
-virtual machine, and some accompanying data such as literals and referenced
-symbols. Note that the behavior of compiled code can differ from interpreted
-code in a number of ways. Differences in behavior can be deliberately induced.
-Certain erroneous or dubious situations can also cause compiled code to behave
-differently from interpreted code.
-
-Compilation not only provides faster execution. Compiled files load much
-faster. Compiled files can be distributed unaccompanied by the source files,
-and are much more resistant to reverse engineering.
+function instead of the source file. Usually, loading the compiled file
+produces the same effect as if the source file were loaded. However, note that
+the behavior of compiled code can differ from interpreted code in a number of
+ways. Differences in behavior can be deliberately induced. Certain erroneous
+or dubious situations can also cause compiled code to behave differently from
+interpreted code.
+
+Compilation not only provides faster execution; compiled files also load much
+faster than source files. Moreover, they can be distributed unaccompanied by
+the source files, and resist reverse engineering.
.SS* Top-Level Forms