diff --git a/lib/ansible/modules/files/file.py b/lib/ansible/modules/files/file.py index 68eddcec661..9157f98b55b 100644 --- a/lib/ansible/modules/files/file.py +++ b/lib/ansible/modules/files/file.py @@ -46,7 +46,8 @@ options: or M(template) module if you want that behavior. If C(link), the symbolic link will be created or changed. Use C(hard) for hardlinks. If C(absent), directories will be recursively deleted, and files or symlinks will be unlinked. - Note that C(file) will not fail if the C(path) does not exist as the state did not change. + Note that C(absent) will not cause C(file) to fail if the C(path) does not exist + as the state did not change. If C(touch) (new in 1.4), an empty file will be created if the C(path) does not exist, while an existing file or directory will receive updated file access and modification times (similar to the way `touch` works from the command line).