Merge branch '7.4' into 8.0

* 7.4:
  Tweaks
  Document that usages may be supplied by AsCommand Attribute

Author: javiereguiluz

console.rst

@@ -147,12 +147,17 @@ If you can't use PHP attributes, register the command as a service and
 :ref:`default services.yaml configuration <service-container-services-load-example>`,
 this is already done for you, thanks to :ref:`autoconfiguration <services-autoconfigure>`.
 
-You can also use ``#[AsCommand]`` to add a description and longer help text for the command::
+You can also use ``#[AsCommand]`` to add a description, usage exampless, and
+longer help text for the command::
 
     #[AsCommand(
         name: 'app:create-user',
-        description: 'Creates a new user.', // the command description shown when running "php bin/console list"
-        help: 'This command allows you to create a user...', // the command help shown when running the command with the "--help" option
+        // this short description is shown when running "php bin/console list"
+        description: 'Creates a new user.',
+        // this is shown when running the command with the "--help" option
+        help: 'This command allows you to create a user...',
+        // this allows you to show one or more usage examples (no need to add the command name)
+        usages: ['bob', 'alice --as-admin'],
     )]
     class CreateUserCommand
     {
@@ -162,6 +167,11 @@ You can also use ``#[AsCommand]`` to add a description and longer help text for
         }
     }
 
+.. versionadded:: 7.4
+
+    The feature to define usage examples in the ``#[AsCommand]`` attribute was
+    introduced in Symfony 7.4.
+
 Additionally, you can extend the :class:`Symfony\\Component\\Console\\Command\\Command` class to
 leverage advanced features like lifecycle hooks (e.g. :method:`Symfony\\Component\\Console\\Command\\Command::initialize` and
 and :method:`Symfony\\Component\\Console\\Command\\Command::interact`)::