diff --git a/System/Directory.hs b/System/Directory.hs
index 7829ecf21209e438ff4d909d0a5e6df03ac2a43c..f4475c48da8425843b787704ca77ba10d05d53dd 100644
--- a/System/Directory.hs
+++ b/System/Directory.hs
@@ -530,7 +530,8 @@ removeContentsRecursive path =
 -- Unlike other removal functions, this function will also attempt to delete
 -- files marked as read-only or otherwise made unremovable due to permissions.
 -- As a result, if the removal is incomplete, the permissions or attributes on
--- the remaining files may be altered.
+-- the remaining files may be altered.  If there are hard links in the
+-- directory, then permissions on all related hard links may be altered.
 --
 -- If an entry within the directory vanishes while @removePathForcibly@ is
 -- running, it is silently ignored.