From: Paul McMillan Date: Wed, 4 Jul 2012 18:57:37 +0000 (-0700) Subject: Improve whitespace docs to reflect reality. X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=b4188e0d18d211aed914669de79607fe7bef042b;p=jinja2.git Improve whitespace docs to reflect reality. See also: https://groups.google.com/d/msg/pocoo-libs/6DylMqq1voI/GXTbZJ1Tr-sJ --- diff --git a/docs/templates.rst b/docs/templates.rst index a21e331..790b95e 100644 --- a/docs/templates.rst +++ b/docs/templates.rst @@ -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