Merge branch '5.4' into 6.0

* 5.4:
  [DependencyInjection] Minor improvement of service tag description
  Rewords and tweaks
  [Console] Document lazy command via description

Author: javiereguiluz

console.rst

@@ -70,19 +70,38 @@ Configuring the Command
 You can optionally define a description, help message and the
 :doc:`input options and arguments </console/input>`::
 
+    // ...
+    // the command description shown when running "php bin/console list"
+    protected static $defaultDescription = 'Creates a new user.';
+
     // ...
     protected function configure(): void
     {
         $this
-            // the short description shown while running "php bin/console list"
-            ->setDescription('Creates a new user.')
+            // If you don't like using the $defaultDescription static property,
+            // you can also define the short description using this method:
+            // ->setDescription('...')
 
-            // the full command description shown when running the command with
-            // the "--help" option
+            // the command help shown when running the command with the "--help" option
             ->setHelp('This command allows you to create a user...')
         ;
     }
 
+Defining the ``$defaultDescription`` static property instead of using the
+``setDescription()`` method allows to get the command description without
+instantiating its class. This makes the ``php bin/console list`` command run
+much faster.
+
+If you want to always run the ``list`` command fast, add the ``--short`` option
+to it (``php bin/console list --short``). This will avoid instantiating command
+classes, but it won't show any description for commands that use the
+``setDescription()`` method instead of the static property.
+
+.. versionadded:: 5.3
+
+    The ``$defaultDescription`` static property and the ``--short`` option
+    were introduced in Symfony 5.3.
+
 The ``configure()`` method is called automatically at the end of the command
 constructor. If your command defines its own constructor, set the properties
 first and then call to the parent constructor, to make those properties

service_container/tags.rst

@@ -598,9 +598,9 @@ application handlers::
 Tagged Services with Priority
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The tagged services can be prioritized using the ``priority`` attribute.
-The priority is a positive or negative integer. The higher the number,
-the earlier the tagged service will be located in the collection:
+The tagged services can be prioritized using the ``priority`` attribute. The
+priority is a positive or negative integer that defaults to ``0``. The higher
+the number, the earlier the tagged service will be located in the collection:
 
 .. configuration-block::