From f9185f425f8e62b4a3b8103b5d94a434196c5038 Mon Sep 17 00:00:00 2001 From: Kaz Kylheku Date: Sat, 29 Feb 2020 18:25:58 -0800 Subject: doc: better wording on lisp compilation. * txr.1: Rewriting awkward language in overview of file compilation. --- txr.1 | 27 +++++++++++---------------- 1 file changed, 11 insertions(+), 16 deletions(-) (limited to 'txr.1') 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 -- cgit v1.2.3