about summary refs log tree commit diff
path: root/third_party/git/t/oid-info/README
diff options
context:
space:
mode:
Diffstat (limited to 'third_party/git/t/oid-info/README')
-rw-r--r--third_party/git/t/oid-info/README19
1 files changed, 19 insertions, 0 deletions
diff --git a/third_party/git/t/oid-info/README b/third_party/git/t/oid-info/README
new file mode 100644
index 000000000000..27f843fc0006
--- /dev/null
+++ b/third_party/git/t/oid-info/README
@@ -0,0 +1,19 @@
+This directory contains various per-hash values that are used in the testsuite.
+
+Each file contains lines containing a key-value pair; blank lines and lines
+starting with `#` are ignored.  The key and value are separated by whitespace
+(specifically, those whitespace in the default `$IFS`).  The key consists only
+of shell identifier characters, and the value consists of a hash algorithm,
+colon, and value.  The hash algorithm also consists only of shell identifier
+characters; it should match the value in sha1-file.c.
+
+For example, the following lines map the key "rawsz" to "20" if SHA-1 is in use
+and to "32" if SHA-256 is in use:
+
+----
+rawsz sha1:20
+rawsz sha256:32
+----
+
+The keys and values used here are loaded by `test_oid_init` (see the README file
+in the "t" directory) and are used by calling `test_oid`.