Update docs for copy directory_mode param per #8572

1 files changed, 3 insertions, 2 deletions

diff --git a/files/copy b/files/copy
index 0a5fa699..3c2a5da1 100644
--- a/files/copy
+++ b/files/copy
@@ -79,8 +79,9 @@ options:
     version_added: "1.2"
   directory_mode:
     description:
-      - When doing a recursive copy set the mode for the directories. If this is not set we will default the system
-        defaults.
+      - When doing a recursive copy set the mode for the directories. If this is not set we will use the system
+        defaults. The mode is only set on directories which are newly created, and will not affect those that
+        already existed.
     required: false
     version_added: "1.5"
 extends_documentation_fragment: files