From dc021c9dc52e690010b563dab861650906c904db Mon Sep 17 00:00:00 2001
From: Jim Kleckner <jim@cloudphysics.com>
Date: Wed, 9 Oct 2013 18:21:43 -0700
Subject: [PATCH] Add detail to copy module validate argument

This clarifies the validate command argument and makes it clear that if
it is present, it must include the '%s' argument for the path to the
temporary file to validate.
---
 files/copy | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/files/copy b/files/copy
index 27e90e07570..8f2843b314d 100644
--- a/files/copy
+++ b/files/copy
@@ -65,7 +65,8 @@ options:
     aliases: [ "thirsty" ]
   validate:
     description:
-      - validation to run before copying into place
+      - The validation command to run before copying into place.  The path to the file to
+        validate is passed in via '%s' which must be present as in the visudo example below.
     required: false
     default: ""
     version_added: "1.2"