Ticket #4658: 4658.diff

docs/templates.txt

@@ -1058 +1058 @@
 linebreaks
 ~~~~~~~~~~
 
-Converts newlines into ``<p>`` and ``<br />`` tags.
+Converts newlines into ``<br />`` tags and consecutive newlines into ``<p>`` tags.
 
+For example, with the following string stored in the context variable ``text``::
+
+  This is
+  paragraph one.
+
+  This is
+  paragraph two.
+
+``{{ text|linebreaks }}`` would become::
+
+  <p>This is<br />paragraph one.</p>
+  
+  <p>This is<br />paragraph two.</p>
+
 linebreaksbr
 ~~~~~~~~~~~~