about summary refs log tree commit diff stats
diff options
context:
space:
mode:
-rw-r--r--subx/examples/Readme.md5
1 files changed, 5 insertions, 0 deletions
diff --git a/subx/examples/Readme.md b/subx/examples/Readme.md
index 9cbcef98..d4bb1ff5 100644
--- a/subx/examples/Readme.md
+++ b/subx/examples/Readme.md
@@ -1 +1,6 @@
 Small example programs, each with a simple pedagogical goal.
+
+They also help to validate SubX instruction semantics against native x86
+hardware. For example, loading a single byte to a register would for some time
+clear the rest of the register. This behavior was internally consistent with
+unit tests. It took running an example binary natively to catch the discrepancy.