Ability to customize the usage text

[ehelms]

Could this provide a way to customize the usage text and prevent it from getting obtusely verbose? Example of current output:

usage: rop deploy [-h] [-v] [-e EXTRA_VARS] [--candlepin-database-name CANDLEPIN_DATABASE_NAME] [--candlepin-database-password CANDLEPIN_DATABASE_PASSWORD] [--candlepin-database-user CANDLEPIN_DATABASE_USER]
                  [--certificate-source {default,installer}] [--database-host DATABASE_HOST] [--database-mode {internal,external}] [--database-port DATABASE_PORT] [--database-ssl-ca DATABASE_SSL_CA]
                  [--database-ssl-mode {disable,allow,prefer,require,verify-ca,verify-full}] [--foreman-database-name FOREMAN_DATABASE_NAME] [--foreman-database-password FOREMAN_DATABASE_PASSWORD]
                  [--foreman-database-user FOREMAN_DATABASE_USER] [--pulp-database-name PULP_DATABASE_NAME] [--pulp-database-password PULP_DATABASE_PASSWORD] [--pulp-database-user PULP_DATABASE_USER]

[evgeni]

What would your desired target look like?
Or would you want to just override it completely?

[ehelms]

I'll borrow an example that I think tends to work well:

Usage:
  podman images [options] [IMAGE]

Examples:
  podman images --format json
  podman images --sort repository --format "table {{.ID}} {{.Repository}} {{.Tag}}"
  podman images --filter dangling=true

I would swap [options] and parameters though, e.g.

Usage: rop deploy [target] [options]