add comments

diff --git a/tests/mv/hard-3 b/tests/mv/hard-3
index 6fdf0ffafa62331bdc6ee0250de93c94af4bba37..2e04e58eb761fb013afa1ae77910509e47e8e40b 100755 (executable)
--- a/tests/mv/hard-3
+++ b/tests/mv/hard-3
@@ -1,6 +1,17 @@
 #!/bin/sh
 # Ensure that using `cp --preserve=link' to copy hard-linked arguments
 # onto existing destinations works, even when one of the link operations fails.
+# This bug was fixed in coreutils-4.5.9.
+# To exercise this bug is non-trivial:
+# Set-up requires at least three hard-linked files.  In copying them,
+# while preserving links, the initial copy must succeed, the attempt
+# to create the second file via `link' must fail, and the final `link'
+# (to create the third) must succeed.  Before the corresponding fix,
+# the first and third destination file would not be linked.
+#
+# Note that this is nominally a test of `cp', yet it is in the tests/mv
+# directory, because it requires use of the --preserve=link option that
+# mv enables by default.
 
 if test "$VERBOSE" = yes; then
   set -x