More proper shebang line parsing.

1 files changed, 14 insertions, 0 deletions

diff --git a/docs/c1/1-parse.md b/docs/c1/1-parse.md
index 0fc0da5..4eb5776 100644
--- a/docs/c1/1-parse.md
+++ b/docs/c1/1-parse.md
@@ -590,6 +590,20 @@ Notes:
   further decoding of enclosed data.  This is not so, since quoting is related
   to code evaluation, not decoding.
 
+
+## Shebang
+
+There is one final "syntax sugar" translation whose sole purpose is to allow a
+shebang line at the start of a file:
+
+    #!interpreter          ->  (#SHBANG & interpreter)
+
+    #!interpreter argline  ->  (#SHBANG interpreter & argline)
+
+Under default settings, the decoder will allow this datum to appear once at the
+beginning of a per-file decoding sequence, and simply discard it.
+
+
 <!--
 ;; Local Variables:
 ;; fill-column: 80