summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2022-02-13 12:54:26 -0800
committerKaz Kylheku <kaz@kylheku.com>2022-02-13 12:54:26 -0800
commit9ec46dec14376ac3bb042272d6d52c36477cdb6e (patch)
tree4220bcdca7b8d85f500d2fa84e1513beb3f0966a
parent9da084f7a68d81cb204654c37ad7e7c0e2d82c20 (diff)
downloadtxr-9ec46dec14376ac3bb042272d6d52c36477cdb6e.tar.gz
txr-9ec46dec14376ac3bb042272d6d52c36477cdb6e.tar.bz2
txr-9ec46dec14376ac3bb042272d6d52c36477cdb6e.zip
doc: document catenated .tlo files.
* txr.1: Under load and compile-file, mention the support for loading catenated .tlo files.
-rw-r--r--txr.135
1 files changed, 35 insertions, 0 deletions
diff --git a/txr.1 b/txr.1
index 4d5090ef..e1324c0e 100644
--- a/txr.1
+++ b/txr.1
@@ -77333,6 +77333,31 @@ reads reads the first line of the file and discards it.
Processing of the file then begins with the first byte
following that line.
+Two or more
+.code .tlo
+files produced by the same version of \*(TX may be catenated
+together (for instance, using the
+.code cat-files
+function) to produce a single
+.code .tlo
+file. Such a combined file can be loaded with the
+.code load
+function.
+
+Note: this is a single
+.code load
+operation: all of the binding and unbinding of variables like
+.code *load-path*
+and
+.code *package*
+is performed once over the entire contents of the combined file, and any
+.code *load-hooks*
+are performed one time after the load operation. Therefore it is possible that
+the load-time behavior differs from that of loading the original files
+individually. The
+.code *load-path*
+is bound to the name of the combined file.
+
.coNP Special variable @ *load-path*
.desc
The
@@ -84626,6 +84651,16 @@ or
.code eval-only
top-level forms.
+Two or more compiled files that are compiled by the same version of \*(TX may be
+catenated together to produce a single
+.code .tlo
+file. Such a file may be loaded by the
+.code load
+function. The behavior of loading such a file may differ from loading the individual
+files, because such a
+.code load
+is treated as a single operation.
+
.coNP Special variable @ *opt-level*
.desc