about summary refs log tree commit diff stats
path: root/examples/Readme.md
diff options
context:
space:
mode:
Diffstat (limited to 'examples/Readme.md')
-rw-r--r--examples/Readme.md6
1 files changed, 6 insertions, 0 deletions
diff --git a/examples/Readme.md b/examples/Readme.md
new file mode 100644
index 00000000..d4bb1ff5
--- /dev/null
+++ b/examples/Readme.md
@@ -0,0 +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.