Fix #2106. Port help commands to Annotated.

[weitzman]

A start at porting help and helpsingle commands. I'm happy with the output of Console's list command (only gripe is that it wants to list all global options which is a currently long list in our case.)

The output appears to need a colspan for the category titles. How to do this with Consolidated/OutputFormatters? Or should I bypass that and Output via Console's Table class directly? Ping @greg-1-anderson

[weitzman]

Now depends on

• Add a Helpformatter consolidation/output-formatters#52
• Add getExampleUsages() to AnnotatedCommand. consolidation/annotated-command#92

[weitzman]

I'm now reusing HelpDocument from Annotated-Command project. Drush is supplying its own formatter for CLI presentation of help. Ping @greg-1-anderson for input on the list below.

Bugs

1. We have a legitimate test fail at https://github.com/drush-ops/drush/blob/helpAnnotated/tests/annotatedCommandTest.php#L70. For some reason, when help gets an $application, the woot command is not in there. We are successfully bootstrapping Drupal. Fixed. we were not registering Commands from discovered modules (e.g. woot) with the Application.
2. Global options are appearing in command help due to Console's mergeApplicationDefinition() which merges together command options and global options. I'd rather show a subset and move those to own section. Might be fixable in future with a Console update to 3.1+. An alternative would be to honor hidden options (this is a Drush-only concept right now). Fixed - depends on Unprotect two methods for benefit of Drush help. consolidation/annotated-command#99
3. List command fails with a helpful error message Cannot convert data from a DOM document to an array, because <command> appears more than once, and is not wrapped in a <commands> element. . I'm matching Symfony's XML:

<namespaces>
  <namespace id="watchdog">
    <command>watchdog-show</command>
    <command>watchdog-list</command>
    <command>watchdog-delete</command>
    <command>watchdog-show-one</command>
  </namespace>
</namespaces>

1. Table wrapping is poor in both list and help commands. Related Improve table wrapping #2603.

Nice to have

1. HelpDocument doesn't supply the default value for arguments. This would be a small improvement over Console help.
2. Hide hidden options. Console does not support hidden options. I guess this will be a Drush-only feature?
3. help isn't yet making use of the description and the "long description" of a command.