From 1146c09f9d1475c4c5d9c6d9a51bf324329f3254 Mon Sep 17 00:00:00 2001
From: Rik <gitaarik@gmail.com>
Date: Tue, 24 Jun 2014 13:40:19 +0200
Subject: [PATCH] Added examples to the shell module

---
 library/commands/shell | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/library/commands/shell b/library/commands/shell
index 639d4a14b09..130abc6718f 100644
--- a/library/commands/shell
+++ b/library/commands/shell
@@ -53,6 +53,17 @@ author: Michael DeHaan
 
 EXAMPLES = '''
 # Execute the command in remote shell; stdout goes to the specified
-# file on the remote
+# file on the remote.
 - shell: somescript.sh >> somelog.txt
+
+# Change the working directory to somedir/ before executing the command.
+- shell: somescript.sh >> somelog.txt chdir=somedir/
+
+# You can also use the 'args' form to provide the options. This command
+# will change the working directory to somedir/ and will only run when
+# somedir/somelog.txt doesn't exist.
+- shell: somescript.sh >> somelog.txt
+  args:
+    chdir: somedir/
+    creates: somelog.txt
 '''