command line help needs to match command line design

[pde]

Over in this issue we have a design for the major verbs and different subcategories of options that the client needs to expose in order to be as swiftly comprehensible as possible to users.

Currently the client, if invoked with --help, prints this:

usage: letsencrypt [-h] [-d DOMAIN [DOMAIN ...]] [-s SERVER] [-k AUTHKEY]
                   [-B N] [-R] [--revoke-certificate REV_CERT]
                   [--revoke-key REV_KEY] [-b N] [-v] [-r] [--no-confirm] [-e]
                   [-t] [--config-dir CONFIG_DIR] [--work-dir WORK_DIR]
                   [--backup-dir BACKUP_DIR] [--key-dir KEY_DIR]
                   [--cert-dir CERT_DIR] [--le-vhost-ext LE_VHOST_EXT]
                   [--cert-path CERT_PATH] [--chain-path CHAIN_PATH]
                   [--apache-server-root APACHE_SERVER_ROOT]
                   [--apache-mod-ssl-conf APACHE_MOD_SSL_CONF]
                   [--apache-ctl APACHE_CTL] [--apache-enmod APACHE_ENMOD]
                   [--apache-init-script APACHE_INIT_SCRIPT]
                   [-c FILE [FILE ...]] [--export-conf-file [FILE]]

followed by a very long and seemingly randomly-ordered list of options.

It should list the major command verbs at the top, with [options] for each one, not an exhaustive list. Then enumerate the most important options, and save the subcategories of options for if the user runs with -h -h, or asks for help about options for a specific verb.

[pde]

Happy to provide a mockup of what this should look like if more clarity is needed : )

[jdkasten]

I think we should remove the top "usage" printout and leave only the detailed descriptions. The "usage section" is useless, but since this is autogenerated by ConfArgParse, I haven't looked into whether or not this is easily achieved.

I personally haven't spent any time organizing the list yet, though I think it can be greatly improved with sections.

There is also some cleanup/refactoring required for cert-path/cert-dir and key-path/key-dir. (Cert/Key named output). (These options were poorly transferred back from when we had a CONFIG.py file.)

[kuba]

I'm working on that in https://github.com/kuba/lets-encrypt-preview/tree/cli

This looks like a duplicate of #136. Can we close one?