From 32218332ee2772c2dddd484b7ce4de4a00c1040d Mon Sep 17 00:00:00 2001
From: Alicia Cozine <879121+acozine@users.noreply.github.com>
Date: Fri, 5 Apr 2019 16:24:29 -0500
Subject: [PATCH] Add a recurse example to file module docs (#54926)

Add recurse example to file module
must set state: directory to use recurse: yes
---
 lib/ansible/modules/files/file.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/lib/ansible/modules/files/file.py b/lib/ansible/modules/files/file.py
index dc002d4e649..218051bb228 100644
--- a/lib/ansible/modules/files/file.py
+++ b/lib/ansible/modules/files/file.py
@@ -59,7 +59,7 @@ options:
   recurse:
     description:
     - Recursively set the specified file attributes on directory contents.
-    - This applies only to C(state=directory).
+    - This applies only when C(state) is set to C(directory).
     type: bool
     default: no
     version_added: '1.1'
@@ -187,6 +187,15 @@ EXAMPLES = r'''
     path: /etc/another_file
     state: file
     access_time: '{{ "%Y%m%d%H%M.%S" | strftime(stat_var.stat.atime) }}'
+
+- name: Recursively change ownership of a directory
+  file:
+    path: /etc/foo
+    state: directory
+    recurse: yes
+    owner: foo
+    group: foo
+
 '''
 RETURN = r'''