From 6d4b429488d045511563f5bd573729c2aaa6b854 Mon Sep 17 00:00:00 2001
From: James Cammarata <jimi@sngx.net>
Date: Tue, 12 Aug 2014 12:19:13 -0500
Subject: [PATCH] Update docs for copy directory_mode param per #8572

---
 files/copy | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/files/copy b/files/copy
index 0a5fa699d03..3c2a5da16aa 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