From d164c94bc180a70a3f994be5154ff4d64e3124f5 Mon Sep 17 00:00:00 2001
From: Douglas Hammond <wizhippo@gmail.com>
Date: Mon, 9 Feb 2015 10:01:56 -0500
Subject: [PATCH] Added Twig loader priority Documentation

---
 reference/dic_tags.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index bfa2c3dc532..98a55ec5ebb 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1337,7 +1337,7 @@ the new loader and tag it with ``twig.loader``:
             acme.demo_bundle.loader.some_twig_loader:
                 class: Acme\DemoBundle\Loader\SomeTwigLoader
                 tags:
-                    - { name: twig.loader }
+                    - { name: twig.loader, priority: 0 }
 
     .. code-block:: xml
 
@@ -1351,7 +1351,7 @@ the new loader and tag it with ``twig.loader``:
                     id="acme.demo_bundle.loader.some_twig_loader"
                     class="Acme\DemoBundle\Loader\SomeTwigLoader">
 
-                    <tag name="twig.loader" />
+                    <tag name="twig.loader" priority="0" />
                 </service>
             </services>
         </container>
@@ -1360,9 +1360,14 @@ the new loader and tag it with ``twig.loader``:
 
         $container
             ->register('acme.demo_bundle.loader.some_twig_loader', 'Acme\DemoBundle\Loader\SomeTwigLoader')
-            ->addTag('twig.loader')
+            ->addTag('twig.loader', array('priority' => 0))
         ;
 
+.. note::
+
+    The ``priority`` value is optional and defaults to ``0``.
+    The higher priority loaders are tried first.
+
 validator.constraint_validator
 ------------------------------