summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2018-07-11 22:11:28 -0700
committerKaz Kylheku <kaz@kylheku.com>2018-07-11 22:11:28 -0700
commitf71aad515d95107da81a3f70d080e75675ce87e2 (patch)
tree6cc0ea3247b275b2de9b22cf55b385d4847b9083 /txr.1
parent4ffee7148db812a67b9752e710bad54a7dc9dabb (diff)
downloadtxr-f71aad515d95107da81a3f70d080e75675ce87e2.tar.gz
txr-f71aad515d95107da81a3f70d080e75675ce87e2.tar.bz2
txr-f71aad515d95107da81a3f70d080e75675ce87e2.zip
compile-file: support hash bang.
* share/txr/stdlib/compiler.tl (usr:compile-file): Check for a hash bang line in the source file. If so, propagate it to the compiled file. * txr.1: Documented existing support for hash bang in .tlo files, and the translation of hash bang from .tl to .tlo.
Diffstat (limited to 'txr.1')
-rw-r--r--txr.111
1 files changed, 11 insertions, 0 deletions
diff --git a/txr.1 b/txr.1
index 9941c972..0a377670 100644
--- a/txr.1
+++ b/txr.1
@@ -62306,6 +62306,17 @@ special variable has no influence on this.
Circular structures in compiled literals are preserved; on loading, similar
circular structures are reproduced.
+.SS* Treatment of The Hash Bang Line
+
+When a source file begins with the
+.code #!
+("hash-bang") character sequence, the file compiler propagates that
+line to the compiled file, verbatim.
+
+\*(TX supports the hash bang mechanism in compiled
+.code .tlo
+files, thereby allowing compiled scripts to be executable.
+
.coNP Function @ compile-toplevel
.synb
.mets (compile-toplevel < form << expanded-p )