[Book][ServiceContainer] Added docs for YAML '@@' escaping

Thomas Ploch · Thomas Ploch · commit ed39ba0ccdf8 · 2013-03-26T11:29:23.000+01:00
This PR deprecates #2286 | Q | A | ------------- | --- | Doc fix? | no | New docs? | yes symfony/symfony#7357 | Applies to | 2.1 | Fixed tickets | symfony/symfony#4889
diff --git a/book/service_container.rst b/book/service_container.rst
@@ -231,6 +231,24 @@ looks up the value of each parameter and uses it in the service definition.
 
         <argument type="string">http://symfony.com/?foo=%%s&bar=%%d</argument>
 
+.. versionadded:: 2.1
+    Escaping the ``@`` character in YAML parameter values is new in Symfony 2.1.9
+    and Symfony 2.2.1.
+
+.. note::
+
+    If you want to use a string that starts with an ``@`` sign as a parameter
+    value (i.e. a very safe mailer password) in a yaml file, you need to escape
+    it by adding another ``@`` sign (This only applies to the YAML format):
+
+    .. code-block:: yaml
+
+        # app/config/parameters.yml
+        parameters:
+            # This will be parsed as string "@securepass"
+            mailer_password: "@@securepass"
+
+
 The purpose of parameters is to feed information into services. Of course
 there was nothing wrong with defining the service without using any parameters.
 Parameters, however, have several advantages:
