From 1c3935eb4038ad3fd5e615b7de50cc1ae51c4cc8 Mon Sep 17 00:00:00 2001
From: Thomas Harte <TomHarte@users.noreply.github.com>
Date: Tue, 7 Dec 2021 18:19:51 -0500
Subject: [PATCH] Add README.md

As a warning.
---
 .../Mac/Clock SignalTests/Amiga Blitter Tests/README.md    | 7 +++++++
 1 file changed, 7 insertions(+)
 create mode 100644 OSBindings/Mac/Clock SignalTests/Amiga Blitter Tests/README.md

diff --git a/OSBindings/Mac/Clock SignalTests/Amiga Blitter Tests/README.md b/OSBindings/Mac/Clock SignalTests/Amiga Blitter Tests/README.md
new file mode 100644
index 000000000..7f67d6fd7
--- /dev/null
+++ b/OSBindings/Mac/Clock SignalTests/Amiga Blitter Tests/README.md	
@@ -0,0 +1,7 @@
+## Amiga Blitter Tests
+
+These tests record register writes and subsequent memory accesses by the Amiga Blitter over a variety of test cases. It is believed that they test all functionality other than stippled lines.
+
+They were generated using a slightly-inaccurate public domain model of the chip rather than from the real thing. In particular:
+* these tests record the output as though the Blitter weren't pipelined — assuming all channels enabled, it always reads via A, then B, then C, then writes via D. The real Blitter performs two cycles of reads before its first write, and adds a final write with no additional reads; and
+* the tests do not record which pointer is used for a write target and therefore do not observe that the Blitter will use pointer C as a write destination for the first pixel of a line.