diff --git a/lib/ansible/modules/file.py b/lib/ansible/modules/file.py index 55489bcda50..150ff6414d5 100644 --- a/lib/ansible/modules/file.py +++ b/lib/ansible/modules/file.py @@ -15,7 +15,7 @@ version_added: historical short_description: Manage files and file properties extends_documentation_fragment: [files, action_common_attributes] description: -- Set attributes of files, symlinks or directories. +- Set attributes of files, directories, or symlinks and their targets. - Alternatively, remove files, symlinks or directories. - Many other modules support the same options as the C(file) module - including M(ansible.builtin.copy), M(ansible.builtin.template), and M(ansible.builtin.assemble). @@ -72,6 +72,7 @@ options: follow: description: - This flag indicates that filesystem links, if they exist, should be followed. + - I(follow=yes) and I(state=link) can modify I(src) when combined with parameters such as I(mode). - Previous to Ansible 2.5, this was C(no) by default. type: bool default: yes