Merge pull request #5419 from stoned/shell-module-doc-fix

shell module: document removes option and sync with command module doc

commands/shell

@@ -7,20 +7,26 @@ DOCUMENTATION = '''
 module: shell
 short_description: Execute commands in nodes.
 description:
-     - The shell module takes the command name followed by a list of arguments,
+     - The M(shell) module takes the command name followed by a list of space-delimited arguments.
-       space delimited. It is almost exactly like the M(command) module but runs
+       It is almost exactly like the M(command) module but runs
        the command through a shell (C(/bin/sh)) on the remote node.
 version_added: "0.2"
 options:
-  (free form):
+  free_form:
     description:
-      - The command module takes a free form command to run
+      - The shell module takes a free form command to run
-    required: null
+    required: true
     default: null
   creates:
     description:
-      - a filename, when it already exists, this step will NOT be run
+      - a filename, when it already exists, this step will B(not) be run.
-    required: false
+    required: no
+    default: null
+  removes:
+    description:
+      - a filename, when it does not exist, this step will B(not) be run.
+    version_added: "0.8"
+    required: no
     default: null
   chdir:
     description: