5589

11 files changed, 15 insertions, 9 deletions

diff --git a/apps/assort.subx b/apps/assort.subx
index 917dfb5c..e150a924 100644
--- a/apps/assort.subx
+++ b/apps/assort.subx
@@ -7,7 +7,7 @@
 # because we don't know if they refer to the line above or the line below.
 #
 # To run:
-#   $ ./subx translate *.subx apps/assort.subx -o apps/assort
+#   $ ./subx translate 0*.subx apps/subx-common.subx apps/assort.subx  -o apps/assort
 #   $ cat x
 #   == code
 #   abc
diff --git a/apps/crenshaw2-1.subx b/apps/crenshaw2-1.subx
index bd8cc5d6..7f91d06e 100644
--- a/apps/crenshaw2-1.subx
+++ b/apps/crenshaw2-1.subx
@@ -3,7 +3,7 @@
 # except that we support hex digits.
 #
 # To run:
-#   $ ./subx translate *.subx apps/crenshaw2-1.subx -o apps/crenshaw2-1
+#   $ ./subx translate 0*.subx apps/crenshaw2-1.subx -o apps/crenshaw2-1
 #   $ echo '3'  |./subx run apps/crenshaw2-1
 # Expected output:
 #   # syscall(exit, 3)
diff --git a/apps/crenshaw2-1b.subx b/apps/crenshaw2-1b.subx
index cb75033f..e19d5aeb 100644
--- a/apps/crenshaw2-1b.subx
+++ b/apps/crenshaw2-1b.subx
@@ -3,7 +3,7 @@
 # except that we support hex numbers of multiple digits.
 #
 # To run:
-#   $ ./subx translate *.subx apps/crenshaw2-1b.subx -o apps/crenshaw2-1b
+#   $ ./subx translate 0*.subx apps/crenshaw2-1b.subx -o apps/crenshaw2-1b
 #   $ echo '1a'  |./subx run apps/crenshaw2-1b
 # Expected output:
 #   # syscall(exit, 1a)
diff --git a/apps/desugar.subx b/apps/desugar.subx
index 4110ddec..e66e58b1 100644
--- a/apps/desugar.subx
+++ b/apps/desugar.subx
@@ -1,5 +1,8 @@
 # Experimental syntax sugar for SubX programs.
 #
+# To run:
+#   $ ./subx translate 0*.subx apps/subx-common.subx apps/desugar.subx  -o apps/desugar
+#
 # We're experimenting with the following expressions:
 #
 # 1.
diff --git a/apps/dquotes.subx b/apps/dquotes.subx
index 20343d15..1375211c 100644
--- a/apps/dquotes.subx
+++ b/apps/dquotes.subx
@@ -2,7 +2,7 @@
 # Replace them with references to new variables in the data segment.
 #
 # To run:
-#   $ ./subx translate *.subx apps/dquotes.subx -o apps/dquotes
+#   $ ./subx translate 0*.subx apps/subx-common.subx apps/dquotes.subx  -o apps/dquotes
 #   $ cat x
 #   == code
 #   ab "cd ef"/imm32
diff --git a/apps/factorial.subx b/apps/factorial.subx
index f28a3657..8bbcedbd 100644
--- a/apps/factorial.subx
+++ b/apps/factorial.subx
@@ -1,7 +1,7 @@
 ## compute the factorial of 5, and return the result in the exit code
 #
 # To run:
-#   $ ./subx translate apps/factorial.subx -o apps/factorial
+#   $ ./subx translate 0*.subx apps/factorial.subx -o apps/factorial
 #   $ ./subx run apps/factorial
 # Expected result:
 #   $ echo $?
diff --git a/apps/handle.subx b/apps/handle.subx
index 95364821..01e6adf9 100644
--- a/apps/handle.subx
+++ b/apps/handle.subx
@@ -13,7 +13,7 @@
 #   offset 4: address
 #
 # To run:
-#   $ ./subx translate *.subx apps/handle.subx -o apps/handle
+#   $ ./subx translate 0*.subx apps/handle.subx -o apps/handle
 #   $ ./subx run apps/handle
 # Expected result is a successful lookup followed by a hard abort:
 #   lookup succeeded
diff --git a/apps/hex.subx b/apps/hex.subx
index a2580e66..d5be93f4 100644
--- a/apps/hex.subx
+++ b/apps/hex.subx
@@ -3,7 +3,7 @@
 # comments between '#' and newline.
 #
 # To run:
-#   $ ./subx translate *.subx apps/hex.subx -o apps/hex
+#   $ ./subx translate 0*.subx apps/subx-common.subx apps/hex.subx  -o apps/hex
 #   $ echo '80 81 82  # comment'  |./subx run apps/hex  |xxd -
 # Expected output:
 #   00000000: 8081 82
diff --git a/apps/pack.subx b/apps/pack.subx
index 9499f3b3..029952e3 100644
--- a/apps/pack.subx
+++ b/apps/pack.subx
@@ -3,7 +3,7 @@
 # uses are left untouched.
 #
 # To run:
-#   $ ./subx translate *.subx apps/pack.subx -o apps/pack
+#   $ ./subx translate 0*.subx apps/subx-common.subx apps/pack.subx  -o apps/pack
 #   $ echo '05/add-to-EAX 0x20/imm32'  |./subx run apps/pack
 # Expected output:
 #   05 20 00 00 00  # 05/add-to-EAX 0x20/imm32
diff --git a/apps/survey.subx b/apps/survey.subx
index d226ecc0..ee9f637d 100644
--- a/apps/survey.subx
+++ b/apps/survey.subx
@@ -5,7 +5,7 @@
 #   b) add segment headers with addresses and offsets correctly filled in
 #
 # To build:
-#   $ ./subx translate *.subx apps/survey.subx -o apps/survey
+#   $ ./subx translate 0*.subx apps/subx-common.subx apps/survey.subx  -o apps/survey
 #
 # The expected input is a stream of bytes with segment headers, comments and
 # some interspersed labels.
diff --git a/apps/tests.subx b/apps/tests.subx
index 12f4902b..70456506 100644
--- a/apps/tests.subx
+++ b/apps/tests.subx
@@ -1,5 +1,8 @@
 # Generate code for a new function called 'run-tests' which calls in sequence
 # all functions starting with 'test-'.
+#
+# To build:
+#   $ ./subx translate 0*.subx apps/subx-common.subx apps/tests.subx  -o apps/tests
 
 == code
 #   instruction                     effective address                                                   register    displacement    immediate