[tahoe-lafs-trac-stream] [Tahoe-LAFS] #2233: CLI: 'tahoe $SUBCOMMAND --help' no longer shows "global" options

[Tahoe-LAFS]

#2233: CLI: 'tahoe $SUBCOMMAND --help' no longer shows "global" options
--------------------------+------------------------------------------------
     Reporter:  daira     |      Owner:
         Type:  defect    |     Status:  new
     Priority:  normal    |  Milestone:  soon
    Component:  code-     |    Version:  1.10.0
  frontend-cli            |   Keywords:  cli regression usability docs help
   Resolution:            |
Launchpad Bug:            |
--------------------------+------------------------------------------------

Comment (by daira):

 The desired output is:
 {{{
 $ bin/tahoe start --help
 Usage:  tahoe [global-opts] start [options] [NODEDIR]
 Global options:
   -q, --quiet             Operate silently.
   -V, --version           Display version numbers.
       --version-and-path  Display version numbers and paths to their
 locations.
   -d, --node-directory=   Specify an empty directory to be used for the
 new Tahoe node.
                           [default for most commands:
 '/home/davidsarah/.tahoe']
 Options:
   -p, --profile   Run under the Python profiler, putting results in
                   'profiling_results.prof'.
       --syslog    Tell the node to log to syslog, not a file.
   -C, --basedir=  Same as --node-directory.
       --version
       --help      Display this help and exit.
 }}}

 Notice that the desired description of `-d` for `create-*` subcommands is
 not the one that is currently printed for `tahoe --help`:
 {{{
 $ bin/tahoe --help

 Usage: tahoe [global-opts] <command> [command-options]
 Options:
   -q, --quiet             Operate silently.
   -V, --version           Display version numbers.
       --version-and-path  Display version numbers and paths to their
 locations.
   -d, --node-directory=   Specify which Tahoe node directory should be
 used. The
                           directory should either contain a full Tahoe
 node, or
                           a file named node.url that points to some other
 Tahoe
                           node. It should also contain a file named
                           'private/aliases' which contains the mapping
 from
                           alias name to root dirnode URI. [default for
 most
                           commands: '/home/davidsarah/.tahoe']
       --help              Display this help and exit.
 }}}

--
Ticket URL: <https://tahoe-lafs.org/trac/tahoe-lafs/ticket/2233#comment:1>
Tahoe-LAFS <https://Tahoe-LAFS.org>
secure decentralized storage