Tweaks and additions

Author: javiereguiluz

components/console/usage.rst

@@ -65,13 +65,13 @@ You can suppress output with:
 
 .. code-block:: terminal
 
+    # suppresses all output, including errors
+    $ php application.php list --silent
+
     # suppresses all output except errors
     $ php application.php list --quiet
     $ php application.php list -q
 
-    # suppresses all output, including errors
-    $ php application.php list --silent
-
 .. versionadded:: 7.2
 
     The ``--silent`` option was introduced in Symfony 7.2.

console/input.rst

@@ -446,8 +446,8 @@ The Console component adds some predefined options to all commands:
 
 * ``--verbose``: sets the verbosity level (e.g. ``1`` the default, ``2`` and
   ``3``, or you can use respective shortcuts ``-v``, ``-vv`` and ``-vvv``)
-* ``--quiet``: disables output and interaction (errors are still displayed)
 * ``--silent``: disables all output and interaction, including errors
+* ``--quiet``: disables output and interaction, but errors are still displayed
 * ``--no-interaction``: disables interaction
 * ``--version``: outputs the version number of the console application
 * ``--help``: displays the command help

console/verbosity.rst

@@ -7,13 +7,13 @@ messages, but you can control their verbosity with the ``-q`` and ``-v`` options
 
 .. code-block:: terminal
 
-    # do not output any message (not even the command result messages) but display errors
-    $ php bin/console some-command -q
-    $ php bin/console some-command --quiet
-
     # suppress all output, including errors
     $ php bin/console some-command --silent
 
+    # suppress all output (even the command result messages) but display errors
+    $ php bin/console some-command -q
+    $ php bin/console some-command --quiet
+
     # normal behavior, no option required (display only the useful messages)
     $ php bin/console some-command
 
@@ -26,6 +26,10 @@ messages, but you can control their verbosity with the ``-q`` and ``-v`` options
     # display all messages (useful to debug errors)
     $ php bin/console some-command -vvv
 
+.. versionadded:: 7.2
+
+    The ``--silent`` option was introduced in Symfony 7.2.
+
 The verbosity level can also be controlled globally for all commands with the
 ``SHELL_VERBOSITY`` environment variable (the ``-q`` and ``-v`` options still
 have more precedence over the value of ``SHELL_VERBOSITY``):
@@ -41,10 +45,6 @@ Console option         ``SHELL_VERBOSITY`` value  Equivalent PHP constant
 ``-vvv``               ``3``                      ``OutputInterface::VERBOSITY_DEBUG``
 =====================  =========================  ===========================================
 
-.. versionadded:: 7.2
-
-    The ``--silent`` option was introduced in Symfony 7.2.
-
 It is possible to print a message in a command for only a specific verbosity
 level. For example::
 
@@ -66,7 +66,7 @@ level. For example::
                 'Password: '.$input->getArgument('password'),
             ]);
 
-            // available methods: ->isQuiet(), ->isVerbose(), ->isVeryVerbose(), ->isDebug()
+            // available methods: ->isSilent(), ->isQuiet(), ->isVerbose(), ->isVeryVerbose(), ->isDebug()
             if ($output->isVerbose()) {
                 $output->writeln('User class: '.get_class($user));
             }
@@ -81,10 +81,19 @@ level. For example::
         }
     }
 
-When the quiet level is used, all output is suppressed as the default
+.. versionadded:: 7.2
+
+    The ``isSilent()`` method was introduced in Symfony 7.2.
+
+When the silent or quiet level are used, all output is suppressed as the default
 :method:`Symfony\\Component\\Console\\Output\\Output::write` method returns
 without actually printing.
 
+.. tip::
+
+    When using the ``silent`` verbosity, errors won't be displayed in the console
+    but they will still be logged through the :doc:`Symfony logger </logger>` integration.
+
 .. tip::
 
     The MonologBridge provides a :class:`Symfony\\Bridge\\Monolog\\Handler\\ConsoleHandler`