symfony
diff --git a/‎translation.rst
Copy file name to clipboardExpand all lines: translation.rst
+5Lines changed: 5 additions & 0 deletions b/‎translation.rst
Copy file name to clipboardExpand all lines: translation.rst
+5Lines changed: 5 additions & 0 deletions
diff --git a/‎translation/debug.rst
Copy file name to clipboardExpand all lines: translation/debug.rst
+4-3Lines changed: 4 additions & 3 deletions b/‎translation/debug.rst
Copy file name to clipboardExpand all lines: translation/debug.rst
+4-3Lines changed: 4 additions & 3 deletions
@@ -292,6 +292,8 @@ To manage these situations, Symfony follows the `ICU MessageFormat`_ syntax by
 using PHP's :phpclass:`MessageFormatter` class. Read more about this in
 :doc:`/translation/message_format`.
 
+.. _translatable-objects:
+
 Translatable Objects
 --------------------
 
@@ -462,6 +464,9 @@ The ``translation:update`` command looks for missing translations in:
   :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()`` method.
+* Any PHP file/class stored in the ``src/`` directory that creates
+  :ref:`translatable-objects` using the constructor or the ``t()`` method or calls
+  the ``trans()`` method.
 
 .. _translation-resource-locations:
 
 
@@ -19,9 +19,10 @@ command helps you to find these missing or unused translation messages templates
 
 .. caution::
 
-    The extractors can't find messages translated outside templates, like form
-    labels or controllers. Dynamic translations using variables or expressions
-    in templates are not detected either:
+    The extractors can't find messages translated outside templates (like form
+    labels or controllers) unless using :ref:`translatable-objects` or calling
+    the ``trans()`` method on a translator. Dynamic translations using variables
+    or expressions in templates are not detected either:
 
     .. code-block:: twig