##### 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
- Documentation Report

##### COMPONENT NAME
file

##### ANSIBLE VERSION
latest
if formatted_time == 'preserve':
        return None
    elif formatted_time == 'now':
        return Sentinel
    else:
        try:
            struct = time.strptime(formatted_time, time_format)
            struct_time = time.mktime(struct)
        except (ValueError, OverflowError) as e:
            raise AnsibleModuleError(results={'msg': 'Error while obtaining timestamp for time %s using format %s: %s'
                                              % (formatted_time, time_format, to_native(e, nonstring='simplerepr'))})
        return struct_time
def update_timestamp_for_file(path, mtime, atime, diff=None):
    b_path = to_bytes(path, errors='surrogate_or_strict')
    try:
        
        
        if mtime is Sentinel and atime is Sentinel:
            
            
            mtime = atime = time.time()
            previous_mtime = os.stat(b_path).st_mtime
            previous_atime = os.stat(b_path).st_atime
            set_time = None
        else:
            
            if mtime is None and atime is None:
                return False
            previous_mtime = os.stat(b_path).st_mtime