From 80b8d3bee035b56b0d9ac57dd732dffa3b2d5f3c Mon Sep 17 00:00:00 2001 From: mcgeeco Date: Tue, 14 Oct 2014 13:48:45 +0100 Subject: [PATCH] Fixed #12008 -- Clarified relationship between template blocks and includes. Thanks Daniele Procida for suggested wording. --- docs/ref/templates/builtins.txt | 5 +++++ 1 file changed, 5 insertions(+) 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 %}`. .. templatetag:: load