file module: add clarification on state=absent re files that do not exist.

This commit is contained in:
David Chwalisz 2016-08-01 08:23:04 -05:00 committed by Matt Clay
parent e526b2ad3d
commit f979928ecc

View file

@ -55,6 +55,7 @@ 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 M(file) will not 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).