Browse files

Added note about multiple block tags to docs/templates.txt

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
adrianholovaty committed Oct 17, 2005
1 parent 383704a commit 63a3c72e19758995c7933be0644b33ff6a5d9837
Showing with 7 additions and 0 deletions.
  1. +7 −0 docs/templates.txt
@@ -224,6 +224,13 @@ Here are some tips for working with inheritance:
if you want to add to the contents of a parent block instead of
completely overriding it.
+Finally, note that you can't define multiple ``{% block %}`` tags with the same
+name in the same template. This limitation exists because a block tag works in
+"both" directions. That is, a block tag doesn't just provide a hole to fill --
+it also defines the content that fills the hole in the *parent*. If there were
+two similarly-named ``{% block %}`` tags in a template, that template's parent
+wouldn't know which one of the blocks' content to use.
Using the built-in reference

0 comments on commit 63a3c72

Please sign in to comment.