1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00

Doc change - make clearer usage for existing remote file

Having read the doc for this module several times and completely missing that it can be used for existing remote archives, I propose this update to the wording to make clear from the top the two ways in which this module can be used.
This commit is contained in:
mrsheepuk 2015-02-17 13:48:59 +00:00 committed by Matt Clay
parent 6c7b202a63
commit 31421374c0

View file

@ -23,14 +23,14 @@ DOCUMENTATION = '''
--- ---
module: unarchive module: unarchive
version_added: 1.4 version_added: 1.4
short_description: Copies an archive to a remote location and unpack it short_description: Unpacks an archive after (optionally) copying it from the local machine.
extends_documentation_fragment: files extends_documentation_fragment: files
description: description:
- The M(unarchive) module copies an archive file from the local machine to a remote and unpacks it. - The M(unarchive) module unpacks an archive. By default, it will copy the source file from the local system to the target before unpacking - set copy=no to unpack an archive which already exists on the target..
options: options:
src: src:
description: description:
- Local path to archive file to copy to the remote server; can be absolute or relative. - If copy=yes (default), local path to archive file to copy to the target server; can be absolute or relative. If copy=no, path on the target server to existing archive file to unpack.
required: true required: true
default: null default: null
dest: dest:
@ -40,7 +40,7 @@ options:
default: null default: null
copy: copy:
description: description:
- "if true, the file is copied from the 'master' to the target machine, otherwise, the plugin will look for src archive at the target machine." - "If true, the file is copied from local 'master' to the target machine, otherwise, the plugin will look for src archive at the target machine."
required: false required: false
choices: [ "yes", "no" ] choices: [ "yes", "no" ]
default: "yes" default: "yes"