document how state=file works (#50986)

* document how state=file works

 this seems to have been lost in previous updates to docs

* Update lib/ansible/modules/files/file.py

Co-Authored-By: bcoca <bcoca@users.noreply.github.com>
pull/51452/head
Brian Coca 5 years ago committed by Sandra McCann
parent 19441df7e9
commit ce898bfde5

@ -37,8 +37,9 @@ options:
not exist as the state did not change.
- If C(directory), all intermediate subdirectories will be created if they
do not exist. Since Ansible 1.7 they will be created with the supplied permissions.
- If C(file), the file will NOT be created if it does not exist; see the C(touch)
value or the M(copy) or M(template) module if you want that behavior.
- If C(file), without any other options this works mostly as a 'stat' and will return the current state of C(path).
Even with other options (i.e C(mode)), the file will be modified but will NOT be created if it does not exist;
see the C(touch) value or the M(copy) or M(template) module if you want that behavior.
- If C(hard), the hard link will be created or changed.
- If C(link), the symbolic link will be created or changed.
- If C(touch) (new in 1.4), an empty file will be created if the C(path) does not

Loading…
Cancel
Save