Merge pull request #6170 from basepi/useradd6165

Fix bad example in the state tutorial part 3, Fix #6165

doc/topics/tutorials/states_pt3.rst

@@ -42,6 +42,21 @@ This templated sls file once generated will look like this:
     curly:
       user.present
 
+Here's a more complex example:
+
+.. code-blocK:: yaml
+
+    {% for usr in 'moe','larry','curly' %}
+    {{ usr }}:
+      group:
+        - present
+      user:
+        - present
+        - gid_from_name: True
+        - require:
+          - group: {{ usr }}
+    {% endfor %}
+
 Using Grains in SLS modules
 ===========================
 
@@ -72,16 +87,13 @@ The Salt module functions are also made available in the template context as
 
 .. code-block:: yaml
 
-    {% for usr in 'moe','larry','curly' %}
+    basepi:
-    {{ usr }}:
-      group:
-        - present
       user:
         - present
-        - gid: {{ salt['file.group_to_gid'](usr) }}
+        - gid: {{ salt['file.group_to_gid']('some_group_that_exists') }}
-        - require:
+
-          - group: {{ usr }}
+Note that for the above example to work, ``some_group_that_exists`` must exist
-    {% endfor %}
+before the state file is processed by the templating engine.
 
 Below is an example that uses the ``network.hwaddr`` function to retrieve the
 MAC address for eth0::