summaryrefslogtreecommitdiffstats
path: root/lib/ansible/modules/file.py
diff options
context:
space:
mode:
Diffstat (limited to 'lib/ansible/modules/file.py')
-rw-r--r--lib/ansible/modules/file.py7
1 files changed, 4 insertions, 3 deletions
diff --git a/lib/ansible/modules/file.py b/lib/ansible/modules/file.py
index 0aa9183..564d7f6 100644
--- a/lib/ansible/modules/file.py
+++ b/lib/ansible/modules/file.py
@@ -4,8 +4,7 @@
# Copyright: (c) 2017, Ansible Project
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
+from __future__ import annotations
DOCUMENTATION = r'''
@@ -66,7 +65,7 @@ options:
- >
Force the creation of the symlinks in two cases: the source file does
not exist (but will appear later); the destination exists and is a file (so, we need to unlink the
- O(path) file and create symlink to the O(src) file in place of it).
+ O(path) file and create a symlink to the O(src) file in place of it).
type: bool
default: no
follow:
@@ -74,6 +73,8 @@ options:
- This flag indicates that filesystem links, if they exist, should be followed.
- O(follow=yes) and O(state=link) can modify O(src) when combined with parameters such as O(mode).
- Previous to Ansible 2.5, this was V(false) by default.
+ - While creating a symlink with a non-existent destination, set O(follow) to V(false) to avoid a warning message related to permission issues.
+ The warning message is added to notify the user that we can not set permissions to the non-existent destination.
type: bool
default: yes
version_added: '1.8'