Ticket #5865: cycle-doc.diff

docs/templates.txt

@@ -591 +591 @@
 ~~~~~
 
 **Changed in Django development version**
-Cycle among the given strings or variables each time this tag is encountered.
+Cycle among the given strings, variables, iterable type each time this tag is encountered.
 
 Within a loop, cycles among the given strings/variables each time through the
 loop::
@@ -621 +621 @@
 comma-based syntax exists for backwards-compatibility, and should not be
 used for new projects.
 
+In case you pass a single value which is an iterable variable defined in the context cycle iterates over its values.
+Example context definition::
+
+        {'colors': ['red', 'blue', 'green']}
+
+Example usage::
+
+        {% for row in mydata %}
+        <tr class="{% cycle colors %}">...</tr>
+        {% endfor %}
+
+        {% for row in mydata %}
+        <tr class="{% cycle colors as color%}">...</tr>
+        {% endfor %}
+
+        <tr class="{% cycle colors as color %}">...</tr>
+        <tr class="{% cycle color %}">...</tr>
+        <tr class="{% cycle color %}">...</tr>
+
+
 debug
 ~~~~~