Improve whitespace docs to reflect reality.
authorPaul McMillan <paul.mcmillan@nebula.com>
Wed, 4 Jul 2012 18:57:37 +0000 (11:57 -0700)
committerPaul McMillan <paul.mcmillan@nebula.com>
Wed, 4 Jul 2012 19:00:12 +0000 (12:00 -0700)
See also:
https://groups.google.com/d/msg/pocoo-libs/6DylMqq1voI/GXTbZJ1Tr-sJ

docs/templates.rst

index a21e331031b5d216c518305f60f5887a0524e37b..790b95e7c24908ff083291ad8e338ca6396b0685 100644 (file)
@@ -152,10 +152,11 @@ yourself::
 Whitespace Control
 ------------------
 
-In the default configuration whitespace is not further modified by the
-template engine, so each whitespace (spaces, tabs, newlines etc.) is returned
-unchanged.  If the application configures Jinja to `trim_blocks` the first
-newline after a a template tag is removed automatically (like in PHP).
+In the default configuration, a single trailing newline is stripped if
+present, and whitespace is not further modified by the template engine. Each
+whitespace (spaces, tabs, newlines etc.) is returned unchanged.  If the
+application configures Jinja to `trim_blocks` the first newline after a a
+template tag is removed automatically (like in PHP).
 
 But you can also strip whitespace in templates by hand.  If you put an minus
 sign (``-``) to the start or end of an block (for example a for tag), a