Update documentation on complex args to new simpler format.

docsite/rst/playbooks2.rst

@@ -945,8 +945,8 @@ feature produces a large amount of output, it is best used when checking a singl
 
     ansible-playbook foo.yml --check --diff --limit foo.example.com
 
-Passing Complex Arguments From Dictionaries
+Dictionary & Nested (Complex) Arguments
-```````````````````````````````````````````
+```````````````````````````````````````
 
 As a review, most tasks in ansbile are of this form::
 
@@ -956,14 +956,12 @@ As a review, most tasks in ansbile are of this form::
         yum: name=cobbler state=installed
 
 However, in some cases, it may be useful to feed arguments directly in from a hash (dictionary).  In fact, a very small
-number of modules (the CloudFormations module is one) actually require complex arguments that can't be fit
+number of modules (the CloudFormations module is one) actually require complex arguments.  They work like this::
-into a key=value system.  To pass arguments in from a hash (dictionary), do this::
 
     tasks:
 
       - name: call a module that requires some complex arguments
-        module_name_goes_here: asdf=1234
+        foo_module:
-        args:
            fibonacci_list:
              - 1
              - 1
@@ -976,14 +974,22 @@ into a key=value system.  To pass arguments in from a hash (dictionary), do this
              fish:
                - limpet
                - nemo
+               - ${other_fish_name}
 
-While complex arguments can be fed to most modules in Ansible, they should only be used where needed.  Note
+You can of course use variables inside these, as noted above.
-that variable interpolation works exactly as you would suspect, so you can use "${foo}" and so on in values
-inside of the dictionary you pass to "args".
 
-If both key=value arguments are given along with 'args', the key=value arguments take priority.  This technically
+If using local_action, you can do this::
-means you can set defaults by using 'args' if you so choose, though that is not the intended purpose of this
+      
-feature.
+    - name: call a module that requires some complex arguments
+      local_action:
+        module: foo_module
+        arg1: 1234
+        arg2: 'asdf'
+
+Which of course means, though more verbose, this is also technically legal syntax::
+
+    - name: foo
+      template: { src: '/templates/motd.j2', dest: '/etc/motd' }
 
 Style Points
 ````````````