Merge branch '2.3' into 2.4

weaverryan · weaverryan · commit 42e243ca7eb7 · 2014-10-01T10:23:41.000-04:00
* 2.3:
  add note about parameters in imports
  Fixed the official name of Node.js
  Added a note about the total deprecation of YUI
diff --git a/book/service_container.rst b/book/service_container.rst
@@ -377,6 +377,8 @@ configuration.
         // app/config/config.php
         $loader->import('@AcmeHelloBundle/Resources/config/services.php');
 
+.. include:: /components/dependency_injection/_imports-parameters-note.rst.inc
+
 The ``imports`` directive allows your application to include service container
 configuration resources from any other location (most commonly from bundles).
 The ``resource`` location, for files, is the absolute path to the resource
diff --git a/components/dependency_injection/_imports-parameters-note.rst.inc b/components/dependency_injection/_imports-parameters-note.rst.inc
@@ -0,0 +1,31 @@
+.. note::
+
+    Due to the way in which parameters are resolved, you cannot use them to
+    build paths in imports dynamically. This means that something like the
+    following doesn't work:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # app/config/config.yml
+            imports:
+                - { resource: "%kernel.root_dir%/parameters.yml" }
+
+        .. code-block:: xml
+
+            <!-- app/config/config.xml -->
+            <?xml version="1.0" encoding="UTF-8" ?>
+            <container xmlns="http://symfony.com/schema/dic/services"
+                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
+
+                <imports>
+                    <import resource="%kernel.root_dir%/parameters.yml" />
+                </imports>
+            </container>
+
+        .. code-block:: php
+
+            // app/config/config.php
+            $loader->import('%kernel.root_dir%/parameters.yml');
diff --git a/cookbook/assetic/yuicompressor.rst b/cookbook/assetic/yuicompressor.rst
@@ -10,8 +10,13 @@ you can take advantage of this tool very easily.
 
 .. caution::
 
-    The YUI Compressor is going through a `deprecation process`_. But don't
-    worry! See :doc:`/cookbook/assetic/uglifyjs` for an alternative.
+    The YUI Compressor is `no longer maintained by Yahoo`_ but by an independent
+    volunteer. Moreover, Yahoo has decided to `stop all new development on YUI`_
+    and to move to other modern alternatives such as Node.js.
+
+    That's why you are **strongly advised** to avoid using YUI utilities unless
+    strictly necessary. Read :doc:`/cookbook/assetic/uglifyjs` for a modern and
+    up-to-date alternative.
 
 Download the YUI Compressor JAR
 -------------------------------
@@ -164,4 +169,5 @@ apply this filter when debug mode is off.
 
 .. _`YUI Compressor`: http://developer.yahoo.com/yui/compressor/
 .. _`Download the JAR`: https://github.com/yui/yuicompressor/releases
-.. _`deprecation process`: http://www.yuiblog.com/blog/2012/10/16/state-of-yui-compressor/
+.. _`no longer maintained by Yahoo`: http://www.yuiblog.com/blog/2013/01/24/yui-compressor-has-a-new-owner/
+.. _`stop all new development on YUI`: http://yahooeng.tumblr.com/post/96098168666/important-announcement-regarding-yui
diff --git a/cookbook/configuration/configuration_organization.rst b/cookbook/configuration/configuration_organization.rst
@@ -148,6 +148,8 @@ needed for the ``app/config/dev/config.yml`` file:
 
         // ...
 
+.. include:: /components/dependency_injection/_imports-parameters-note.rst.inc
+
 Semantic Configuration Files
 ----------------------------
 
diff --git a/cookbook/configuration/environments.rst b/cookbook/configuration/environments.rst
@@ -262,6 +262,8 @@ The best way to accomplish this is via a new environment called, for example,
             'profiler' => array('only-exceptions' => false),
         ));
 
+.. include:: /components/dependency_injection/_imports-parameters-note.rst.inc
+
 And with this simple addition, the application now supports a new environment
 called ``benchmark``.
 
