From: Reuben Thomas <rrt@sc3d.org>
Date: Thu, 28 Feb 2008 19:27:49 +0000 (+0000)
Subject: Add basic instructions for writing tests.
X-Git-Tag: FILE5_05~434
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=8f982b281c69224cb04d36a697b6244a8760a0e4;p=file

Add basic instructions for writing tests.
---

diff --git a/tests/README b/tests/README
new file mode 100644
index 00000000..31f9b14e
--- /dev/null
+++ b/tests/README
@@ -0,0 +1,17 @@
+file tests
+==========
+
+This directory contains tests for file. It is highly encouraged to add
+one each time a bug is found, and each time new magic is added. Each
+test consists of three files:
+
+  TEST.magic
+  TEST.testfile
+  TEST.result
+
+where TEST is the base name of the test, TEST.magic contains the magic
+used, TEST.testfile is the input, and TEST.result is the desired
+output from file.
+
+It suffices to add a triplet of test files to the directory to have
+them included in "make check".