Set description for command, but not for option

For every command I have a concrete class which implements certain interface. For example:

public class FooCommand implements Command{
    @Parameter(names = {"-?","--help"}, description = "display this help",help = true)
    private boolean helpRequested = false;
 }

I have foo-command, boo-command, lala-command. However, all these commands are separate and are not within one main command (by other words this is not like git clone …). This is the way I get usage

 JCommander jCommander=new JCommander(command, args);
 jCommander.setProgramName(commandName);//for example foo-command
 StringBuilder builder=new StringBuilder();
 jCommander.usage(builder);

And this is the usage message I get:

Usage: foo-command [options]
  Options:
    -?, --help
      display this help

However I need to add description to command (but not to option). For example I want to get such usage message:

Usage: foo-command [options] - This command is used as base foo
  Options:
    -?, --help
      display this help

To get it I do this way:

public class FooCommand implements Command{
    @Parameter(names = {"-?","--help"}, description = "display this help",help = true)
    private boolean helpRequested = false;
   @Parameter(description = "This command is used as base foo")
    private String usage=null;//this field is only for setting parameter
 }

The code seems to work, but I don’t like that there is a field usage that is not used. Maybe it is better to add support for such cases?

[raubel]

Having the possibility to display a global description of the command along with the help message. I also miss this feature a lot!

[jeremysolarz]

Dear @PashaTurok,

As you can see it is possible through a change to JCommander.

But it’s up to @cbeust if he considers the change necessary or not.

😄