When command grouping is used (in dscondig for instance) the top level help...

lutoff

20.06.2007 7500817057f828ad193c5d0ddacdd7bc38e172e0

When command grouping is used (in dscondig for instance) the top level help displays:

    $ dsconfig --help
    This utility may be used to define a base configuration for the Directory
    Server
    Usage:  dsconfig {subcommand} {options}

    Available subcommands:
    --help-core
        Display subcommands relating to core server
    --help-database
        Display subcommands relating to caching and back-ends
    <...>
    
This modification replaces the help sentence ("Available subcommands") by "To get the list of subcommands use:"

    dsconfig --help
    This utility may be used to define a base configuration for the Directory
    Server
    Usage:  dsconfig {subcommand} {options}

    To get the list of subcommands use:
    --help-core
        Display subcommands relating to core server
    --help-database
        Display subcommands relating to caching and back-ends
    <...>

 opends/src/server/org/opends/server/messages/UtilityMessages.java

@@ -1744,6 +1744,12 @@
       CATEGORY_MASK_UTIL | SEVERITY_MASK_MILD_ERROR | 165;


  /**
   * The message ID for the message that will be used as the heading
   * for the table of sub-commands. This does not take any arguments.
   */
  public static final int MSGID_SUBCMDPARSER_SUBCMD_HELP_HEADING =
    CATEGORY_MASK_UTIL | SEVERITY_MASK_INFORMATIONAL | 166;


  /**
@@ -2298,6 +2304,8 @@
                    "Usage:");
    registerMessage(MSGID_SUBCMDPARSER_SUBCMD_HEADING,
                    "Available subcommands:");
    registerMessage(MSGID_SUBCMDPARSER_SUBCMD_HELP_HEADING,
                    "To get the list of subcommands use:");
    registerMessage(MSGID_SUBCMDPARSER_SUBCMD_REFERENCE,
                    "See \"%s --help-{category}\"");
    registerMessage(MSGID_SUBCMDPARSER_GLOBAL_HEADING,

 opends/src/server/org/opends/server/util/args/SubCommandArgumentParser.java

@@ -1623,7 +1623,14 @@
    buffer.append(EOL);
    buffer.append(EOL);

    if (c.isEmpty())
    {
      buffer.append(getMessage(MSGID_SUBCMDPARSER_SUBCMD_HELP_HEADING));
    }
    else
    {
    buffer.append(getMessage(MSGID_SUBCMDPARSER_SUBCMD_HEADING));
    }
    buffer.append(EOL);

    if (c.isEmpty()) {