Mentioned the extraction of translation contents from PHP files

javiereguiluz · javiereguiluz · commit f82ad62c75cd · 2019-05-28T09:55:52.000+02:00
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
@@ -301,6 +301,8 @@ on. Set it to ``0`` to disable all the optimizations. You can even enable or
 disable these optimizations selectively, as explained in the Twig documentation
 about `the optimizer extension`_.
 
+.. _config-twig-default-path:
+
 default_path
 ~~~~~~~~~~~~
 
diff --git a/translation.rst b/translation.rst
@@ -357,23 +357,27 @@ with these tasks:
 
 .. code-block:: terminal
 
-    # updates the French translation file with the missing strings found in templates/
+    # updates the French translation file with the missing strings for that locale
     $ php bin/console translation:update --dump-messages --force fr
 
-    # updates the English translation file with the missing strings found in AppBundle
-    $ php bin/console translation:update --dump-messages --force en AppBundle
+The ``translation:update`` command looks for missing translations in:
+
+* Templates stored in the ``templates/`` directory (or any other directory
+  defined in the :ref:`twig.default_path <config-twig-default-path>` and
+  :ref:`twig.paths <config-twig-paths>` config options);
+* Any PHP file/class that injects or :doc:`autowires </service_container/autowiring>`
+  the ``translator`` service and makes calls to the ``trans()`` function.
+
+.. versionadded:: 4.3
+
+    The extraction of missing translation strings from PHP files was introduced
+    in Symfony 4.3.
 
 .. note::
 
     If you want to see the missing translation strings without actually updating
     the translation files, remove the ``--force`` option from the command above.
 
-.. tip::
-
-    If you need to extract translation strings from other sources, such as
-    controllers, forms and flash messages, consider using the more advanced
-    third-party `TranslationBundle`_.
-
 .. _translation-resource-locations:
 
 Translation Resource/File Names and Locations
@@ -564,4 +568,3 @@ Learn more
 .. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
 .. _`Translatable Extension`: http://atlantic18.github.io/DoctrineExtensions/doc/translatable.html
 .. _`Translatable Behavior`: https://github.com/KnpLabs/DoctrineBehaviors
-.. _`TranslationBundle`: https://github.com/php-translation/symfony-bundle
