Supercommands and subcommands share the same set of possible command
directives. They differ mainly in the way the documentation is
-formated. There can only be one supercommand but arbitrary many
+formatted. There can only be one supercommand but arbitrary many
subcommands. For example, the supercommand could be the name of
the application, and the subcommands could be "load", "save" "info"
and "quit". The subcommand would be passed as the first non-option
and
.BR [/conclusion] .
Both texts will become part of the manual page, but are not not part
-of the short or long help. Like for the
-.B section
-directive, arbitrary roff source may be included here.
+of the short or long help.
.TP
.B aux_info_prefix
This text is shown at the bottom of each command before the value of the
this situation is to parse command line and config file separately,
then merge the two parse results and check in the application if the
option is given in the merged parse result.
+
+There is another disadvantage of this flag: if the parser fails due
+to a missing option that was declared required, it is not possible to
+detect if other options were given. For example, if the suite defines
+the --help option, and the application is executed with this option
+only, the parser will still return a parse error.
.B
.IP ignored
This flag indicates that the current option is in fact not a real option.