symfony
diff --git a/‎UPGRADE-3.2.md
Lines changed: 30 additions & 2 deletions b/‎UPGRADE-3.2.md
Lines changed: 30 additions & 2 deletions
diff --git a/‎UPGRADE-4.0.md
Lines changed: 30 additions & 2 deletions b/‎UPGRADE-4.0.md
Lines changed: 30 additions & 2 deletions
diff --git a/‎src/Symfony/Bridge/Twig/CHANGELOG.md
Lines changed: 4 additions & 2 deletions b/‎src/Symfony/Bridge/Twig/CHANGELOG.md
Lines changed: 4 additions & 2 deletions
@@ -133,8 +133,36 @@ Serializer
 TwigBridge
 ----------
 
- * Deprecated the possibility to inject the Form Twig Renderer into the form
-   extension. Inject it into the `TwigRendererEngine` instead.
+ * Injecting the Form `TwigRenderer` into the `FormExtension` is deprecated and has no more effect.
+   Upgrade Twig to `^1.30`, inject the `Twig_Environment` into the `TwigRendererEngine` and load
+   the `TwigRenderer` using the `Twig_FactoryRuntimeLoader` instead.
+
+   Before:
+
+   ```php
+   use Symfony\Bridge\Twig\Extension\FormExtension;
+   use Symfony\Bridge\Twig\Form\TwigRenderer;
+   use Symfony\Bridge\Twig\Form\TwigRendererEngine;
+
+   // ...
+   $rendererEngine = new TwigRendererEngine(array('form_div_layout.html.twig'));
+   $rendererEngine->setEnvironment($twig);
+   $twig->addExtension(new FormExtension(new TwigRenderer($rendererEngine, $csrfTokenManager)));
+   ```
+
+   After:
+
+   ```php
+   $rendererEngine = new TwigRendererEngine(array('form_div_layout.html.twig'), $twig);
+   $twig->addRuntimeLoader(new Twig_FactoryRuntimeLoader(array(
+       Renderer::class => function () use ($rendererEngine, $csrfTokenManager) {
+           return new TwigRenderer($rendererEngine, $csrfTokenManager);
+       },
+   )));
+   $twig->addExtension(new FormExtension());
+   ```
+
+ * Deprecated the `TwigRendererEngineInterface` interface, will be removed in 4.0.
 
 Validator
 ---------
 
@@ -186,8 +186,36 @@ Translation
 TwigBridge
 ----------
 
- * The possibility to inject the Form Twig Renderer into the form extension
-   has been removed. Inject it into the `TwigRendererEngine` instead.
+ * Removed the possibility to inject the Form `TwigRenderer` into the `FormExtension`.
+   Upgrade Twig to `^1.30`, inject the `Twig_Environment` into the `TwigRendererEngine` and load
+   the `TwigRenderer` using the `Twig_FactoryRuntimeLoader` instead.
+
+   Before:
+
+   ```php
+   use Symfony\Bridge\Twig\Extension\FormExtension;
+   use Symfony\Bridge\Twig\Form\TwigRenderer;
+   use Symfony\Bridge\Twig\Form\TwigRendererEngine;
+
+   // ...
+   $rendererEngine = new TwigRendererEngine(array('form_div_layout.html.twig'));
+   $rendererEngine->setEnvironment($twig);
+   $twig->addExtension(new FormExtension(new TwigRenderer($rendererEngine, $csrfTokenManager)));
+   ```
+
+   After:
+
+   ```php
+   $rendererEngine = new TwigRendererEngine(array('form_div_layout.html.twig'), $twig);
+   $twig->addRuntimeLoader(new Twig_FactoryRuntimeLoader(array(
+       Renderer::class => function () use ($rendererEngine, $csrfTokenManager) {
+           return new TwigRenderer($rendererEngine, $csrfTokenManager);
+       },
+   )));
+   $twig->addExtension(new FormExtension());
+   ```
+
+ * Removed the `TwigRendererEngineInterface` interface.
 
 Validator
 ---------
 
@@ -5,8 +5,10 @@ CHANGELOG
 -----
 
  * added `AppVariable::getToken()`
- * Deprecated the possibility to inject the Form Twig Renderer into the form
-   extension. Inject it on TwigRendererEngine instead.
+ * [BC BREAK] Deprecated the possibility to inject the Form `TwigRenderer` into the form extension. 
+   Inject the `Twig_Environment` into the `TwigRendererEngine` and load the `Twig_Renderer`
+   using the `Twig_FactoryRuntimeLoader` instead.
+ * Deprecated the `TwigRendererEngineInterface` interface.
 
 2.7.0
 -----