Added an example for a different method of verbosity level usage.

[smatyas]

Setting a message level like in the added example, was not yet documented. I just found out this method by looking into the code. I also tested with some dummy command that it really does what I thought:

protected function execute(InputInterface $input, OutputInterface $output) {
    $output->writeln('quiet', OutputInterface::VERBOSITY_QUIET);
    $output->writeln('normal', OutputInterface::VERBOSITY_NORMAL);
    $output->writeln('verbose', OutputInterface::VERBOSITY_VERBOSE);
    $output->writeln('very verbose', OutputInterface::VERBOSITY_VERY_VERBOSE);
    $output->writeln('debug', OutputInterface::VERBOSITY_DEBUG);
}

[javiereguiluz]

@smatyas I like it! However, lately in the docs we try to minimize the text and instead explain more things inside the code samples. So, what about moving your explanation to the above code example? Something like this:

 It is possible to print a message in a command for only a specific verbosity
 level. For example::

    if ($output->getVerbosity() >= OutputInterface::VERBOSITY_VERBOSE) {
        $output->writeln(...);
    }

    // alternatively you can pass the verbosity level to writeln()
    $output->writeln('...', OutputInterface::VERBOSITY_VERBOSE);

[smatyas]

Thanks for the suggestion, applied and squashed.

[wouterj]

👍 Note to the merger: this feature is introduced in 2.8, it should be merged into the 2.8 version of the docs.

Status: reviewed

[javiereguiluz]

👍

[xabbuh]

Thank you @smatyas for adding the missing documentation for this nice feature. I have merged your PR into the 2.8 branch and added a versionadded directive in de9607d.