@@ -467,24 +467,23 @@ The ``translation:extract`` command looks for missing translations in:
467467
468468 $ composer require nikic/php-parser
469469
470- By default, the ``translation:extract `` command extracts new messages in
471- *message/translation * pairs, with the translation populated with the same
472- text as the message, prefixed by ``__ ``. You can customize this prefix using
473- the ``--prefix `` option.
474-
475- If you want to leave new translations empty, use the ``--no-fill `` option.
476- When enabled, only messages are created, and the translation strings are left
477- empty. This is particularly useful when using external translation tools, as
478- it ensures untranslated strings are easily identifiable without any pre-filled
479- content. Note that when ``--no-fill `` is used, the ``--prefix `` option has
480- no effect.
470+ By default, when the ``translation:extract `` command creates new entries in the
471+ trnaslation file, it uses the same content as both the source and the pending
472+ translation. The only difference is that the pending translation is prefixed by
473+ ``__ ``. You can customize this prefix using the ``--prefix `` option:
481474
482475.. code-block :: terminal
483476
484- # changes default prefix
485477 $ php bin/console translation:extract --force --prefix="NEW_" fr
486478
487- # leaves new translations empty
479+ Alternatively, you can use the ``--no-fill `` option to leave the pending translation
480+ completely empty when creating new entries in the translation catalog. This is
481+ particularly useful when using external translation tools, as it makes it easier
482+ to spot untranslated strings:
483+
484+ .. code-block :: terminal
485+
486+ # when using the --no-fill option, the --prefix option is ignored
488487 $ php bin/console translation:extract --force --no-fill fr
489488
490489 .. versionadded :: 7.2
@@ -493,7 +492,6 @@ no effect.
493492
494493.. _translation-resource-locations :
495494
496-
497495Translation Resource/File Names and Locations
498496---------------------------------------------
499497
0 commit comments