t1404: document function test_update_rejected
authorMichael Haggerty <mhagger@alum.mit.edu>
Fri, 10 Jun 2016 06:55:40 +0000 (08:55 +0200)
committerJunio C Hamano <gitster@pobox.com>
Mon, 20 Jun 2016 18:49:00 +0000 (11:49 -0700)
Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
t/t1404-update-ref-errors.sh
index 541cad12a412e7daba1b3eae4366fc5fda7bb1bd..7cfeaa99ba1faca21e4e68e42f9ba4ce2e34b8a0 100755 (executable)
@@ -3,6 +3,16 @@
 test_description='Test git update-ref error handling'
 . ./test-lib.sh
 
+# Create some references, perhaps run pack-refs --all, then try to
+# create some more references. Ensure that the second creation fails
+# with the correct error message.
+# Usage: test_update_rejected <before> <pack> <create> <error>
+#   <before> is a ws-separated list of refs to create before the test
+#   <pack> (true or false) tells whether to pack the refs before the test
+#   <create> is a list of variables to attempt creating
+#   <error> is a string to look for in the stderr of update-ref.
+# All references are created in the namespace specified by the current
+# value of $prefix.
 test_update_rejected () {
        before="$1" &&
        pack="$2" &&