Custom help command

[grasmash]

Having separate short and long form strings for command information would be useful.

The short, existing string should be displayed when commands are listed. The long form string should be displayed when a user asks for help with the command.

The annotation would look like this:

* @description Short description of the command.
* @help This text is output when the user types `command --help` and is intended to provided more detailed information.

[grasmash]

It looks like this annotation may already exist, but it isn't documented and doesn't appear to work in the proposed way.

[greg-1-anderson]

Symfony Console's help command is not very extensible. Work to replace it is underway.

[grasmash]

@greg-1-anderson Symfony's console component does support separate help and description text. I can submit a PR for support. But, are you going to continue to use that component? I don't want to do the work if it will be replaced :)

[greg-1-anderson]

I'm planning to replace the help command, not all of Symfony Console. If there is a mistake in the current handling of the help text, a PR to fix it would be appreciated. I'd like the replacement help command to parallel the standard help command as closely as possible, so correct behavior in the baseline code would be good to have.

[weitzman]

Nice. Would be great to list associated Topics in a new help command.

[weitzman]

Work has started on a custom Help command which will hopefully upstream in annotated-command - drush-ops/drush#2670

[greg-1-anderson]

Just a note that Drush has a custom help command that is working pretty well. Drush's version of list does not support list <commandgroup> at the moment. At some point when we have feature parity we can bring this work into annotated command.