summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authormcgeeco <mcgeeco@tcd.ie>2014-10-14 13:48:45 +0100
committerTim Graham <timograham@gmail.com>2014-10-16 10:53:17 -0400
commit80b8d3bee035b56b0d9ac57dd732dffa3b2d5f3c (patch)
treeb61ee1d0ab85732f406241dda050f421b66d7b71
parent303a8486310447f0f83058d185faa9bfbc2ad700 (diff)
Fixed #12008 -- Clarified relationship between template blocks and includes.
Thanks Daniele Procida for suggested wording.
-rw-r--r--docs/ref/templates/builtins.txt5
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt
index 2f38a1512b..0cae2766ea 100644
--- a/docs/ref/templates/builtins.txt
+++ b/docs/ref/templates/builtins.txt
@@ -700,6 +700,11 @@ available to the included template::
This means that there is no shared state between included templates --
each include is a completely independent rendering process.
+ Blocks are evaluated *before* they are included. This means that a template
+ that includes blocks from another will contain blocks that have *already
+ been evaluated and rendered* - not blocks that can be overridden by, for
+ example, an extending template.
+
See also: :ttag:`{% ssi %}<ssi>`.
.. templatetag:: load