"file" docs reference non-existent param in other modules #72372
Labels
affects_2.11
docs
This issue/PR relates to or includes documentation.
files
Files category
module
This issue/PR relates to a module.
P3
Priority 3 - Approved, No Time Limitation
support:core
This issue/PR relates to code supported by the Ansible Engineering Team.
SUMMARY
See https://docs.ansible.com/ansible/latest/collections/ansible/builtin/file_module.html, where for the parameter "state" it says:
"see the touch value or the ansible.builtin.copy or ansible.builtin.template module"
Neither
https://docs.ansible.com/ansible/latest/collections/ansible/builtin/copy_module.html#ansible-collections-ansible-builtin-copy-module
nor
https://docs.ansible.com/ansible/latest/collections/ansible/builtin/template_module.html#ansible-collections-ansible-builtin-template-module
have anything about "touch".
The "file" page also says "Even with other options (i.e mode), the file will be modified but will NOT be created if it does not exist", but a sentence later it describes "touch" value for this same parameter.
Perhaps the "see..." reference should be removed, and the note reworded like this?
"Even with other options (i.e mode), the file will be modified but will NOT be created if it does not exist. Use state touch to have the file created."
ISSUE TYPE
COMPONENT NAME
file
ANSIBLE VERSION
latest
The text was updated successfully, but these errors were encountered: