From 2860c14bc225add6a41910a9556e9dc49d261e9c Mon Sep 17 00:00:00 2001 From: Michael DeHaan Date: Mon, 27 Feb 2012 22:43:08 -0500 Subject: [PATCH] module doc updates --- docs/man/man5/ansible-modules.5.asciidoc | 27 ++++++++++++++++++------ 1 file changed, 21 insertions(+), 6 deletions(-) diff --git a/docs/man/man5/ansible-modules.5.asciidoc b/docs/man/man5/ansible-modules.5.asciidoc index cde62b0ba95..ef146cea78d 100644 --- a/docs/man/man5/ansible-modules.5.asciidoc +++ b/docs/man/man5/ansible-modules.5.asciidoc @@ -23,7 +23,9 @@ IDEMPOTENCE Most modules other than command are idempotent, meaning they will seek to avoid changes unless a change needs to be made. When using ansible playbooks, these modules can -trigger change events. Unless otherwise noted, all modules support change hooks. +trigger change events, as described in ansible-playbooks (5). + +Unless otherwise noted, all modules support change hooks. command @@ -40,14 +42,12 @@ This module does not support change hooks. Returns the return code from the program as well as timing information. -Async command running and command execution time limits are in plan. These will probably -be special keyvalue parameters expressed on the end of the command line, like ANSTIMEOUT=1 -and ANS_ASYNC=1 or similar. +(Async command running and command execution time limits are in plan.) copy ---- -The copy module takes a list of source files +The copy module moves a file on the local box to remote locations. *src=*:: @@ -89,7 +89,17 @@ git Deploys software from git checkouts. -This module is in plan. +*repo=*:: + +git or http protocol address of the repo to checkout + +*dest=*:: + +where to check it out, an absolute directory path + +*version=*:: + +what version to check out -- either the git SHA, the literal string 'HEAD', or a tag name ohai @@ -146,6 +156,11 @@ Optionally overrides the default JSON file location of /etc/ansible/setup. If used, also supply the metadata parameter to 'template'. Change if running as a non-root remote user who does not have permissions on /etc/ansible. +*anything=*:: + +any other parameters can be named basically anything, and set a key=value +pair in the JSON file for use in templating. + template --------