added examples for tests that compare the compiler output with a reference

test/ref/custom-reference-error.c

@@ -0,0 +1,21 @@
+
+/*
+    this is an example (not actually a regression test) that shows how to
+    make a check that compares the compiler (error-) output with a provided
+    reference.
+
+    to produce a reference file, first make sure your program "works" as intended,
+    then "make" in this directory once and copy the produced compiler output to
+    the reference:
+
+    $ cp ../../testwrk/ref/custom-reference-error.g.6502.out custom-reference-error.cref
+
+    and then "make" again to confirm
+*/
+
+int main(int argc, char* argv[])
+{
+    printf("%02x", 0x42);
+    n = 0; /* produce an error */
+    /* another error */
+}