Permalink
Browse files

[#2408] Minor tweaks for OutputInterface verbosity level discussion

  • Loading branch information...
1 parent f0dd5d9 commit 824e097b2b69df45328675279febc1d087acd71f @weaverryan weaverryan committed Apr 4, 2013
Showing with 10 additions and 3 deletions.
  1. +10 −3 components/console/introduction.rst
@@ -160,7 +160,7 @@ You can also set these colors and options inside the tagname::
// bold text on a yellow background
$output->writeln('<bg=yellow;options=bold>foo</bg=yellow;options=bold>');
-Verbosity levels
+Verbosity Levels
~~~~~~~~~~~~~~~~
The console has 3 levels of verbosity. These are defined in the
@@ -178,14 +178,21 @@ You can specify the quiet verbosity level with the ``--quiet`` or ``-q``
option. The ``--verbose`` or ``-v`` option is used when you want an increased
level of verbosity.
-It is possible to print messages in a command only for the according verbosity
+.. tip::
+
+ The full exception stacktrace is printed if the ``VERBOSITY_VERBOSE``
+ level is used.
+
+It is possible to print a message in a command for only a specific verbosity
level. For example::
if (OutputInterface::VERBOSITY_VERBOSE === $output->getVerbosity()) {
$output->writeln(...);
}
-Note that when the quiet level is used, all output is suppressed.
+When the quiet level is used, all output is suppressed as the default
+:method:`Symfony\Component\Console\Output::write<Symfony\\Component\\Console\\Output::write>`
+method returns without actually printing.
Using Command Arguments
-----------------------

0 comments on commit 824e097

Please sign in to comment.