ansible-collections/community.general
1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2025-04-24 11:21:25 -07:00
Code Issues Projects Releases Packages Wiki Activity Actions 6

Clarifies File module docs re: absent state (#28748)

Browse source 
- The passage beginning "Note that file will not fail..." was slightly
  unclear about the fact that it referred to the behavior of the module
  when `state` is set to `absent`.
- Fixes #23203
This commit is contained in:
Christopher Torgalson 2017-08-30 16:00:30 +02:00 • committed by Martin Křížek
parent b8da5ee5ef
commit 7138742bcc
1 changed files with 2 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

3
lib/ansible/modules/files/file.py
View file

@ -46,7 +46,8 @@ options:
or M(template) module if you want that behavior. If C(link), the symbolic 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), 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. 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 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 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). modification times (similar to the way `touch` works from the command line).