about summary refs log tree commit diff
path: root/README.txt
diff options
context:
space:
mode:
authorIrene Knapp <ireneista@irenes.space>2026-10-06 17:43:31 -0700
committerIrene Knapp <ireneista@irenes.space>2026-10-06 21:43:29 -0700
commit2d9bed2e8e1b8fc3a08c3209d9528b52e3251812 (patch)
tree5204f9dc8584dab1a3bff08000c1ce2cf55bbd2b /README.txt
parentdcb2e0642c07a98447bfe4d0be06063f7df251fa (diff)
rework the interface to "enchant" to support different kinds of executables
so, in particular, "hex" now builds with the new syntax

to implement this, "enchant" now passes the full structure through to "output-contents", which makes it easier to extend.

additionally, when inscribing, the source of "evoke" needs to be included in the scope of the hex transform even when the program being compiled is something else, so that it can carefully interfere with the other transforms. this is now implemented, though in an inelegant way that could do with some cleanup. (that last sentence could be the slogan of the whole project :D)

Change-Id: I553afadba350a62d6e97a21df2b3e821685b9c0c
Force-Push: yes
Diffstat (limited to 'README.txt')
-rw-r--r--README.txt4
1 files changed, 2 insertions, 2 deletions
diff --git a/README.txt b/README.txt
index 388f85f..208bbfc 100644
--- a/README.txt
+++ b/README.txt
@@ -373,12 +373,12 @@ can be metacircular while you're metacircular.)
 
   If you need to compile "hex", you can do so as follows:
 
-  $ cat hex.e | ./evoke > hex
+  $ ./evoke hex.e enchant > hex
   $ chmod 755 hex
 
   To produce the hex-dump version of it, do:
 
-  $ cat inscribe-hex.e | ./evoke > hex.hex
+  $ ./evoke hex.e inscribe > hex.hex
 
   The program "hex" is written in Evocation-assembly, but the hex transform
 also works on Forth programs, including Evocation itself. To produce the