+++ This bug was initially created as a clone of Bug #876692 +++

Description of problem:

In an effort to have more consistency throughout subscription-manager and its associated tools and scripts, there's some cleanup we could do to remove some of our common inconsistencies (like capitalization, some description strings ending with a period, wording and layout throughout, etc).

This bz details things we can address to get us towards a consistent presentation through --helps in subscription-manager, subscription-manager-gui, rhsmcertd, rhsm-icon, install-num-migrate-to-rhsm, and rhn-migrate-classic-to-rhsm.

The standard we should strive for is to have description strings for modules start with a capital letter, with no ending punctuation, and to have description strings for options within those modules to not start with a capital letter, and again, no ending punctuation. 


Primary Modules
already filed under 876356

-------------------------------------------------------------------------

list --help

--consumed
#: ../src/subscription_manager/managercli.py:1726
msgid "show the subscriptions being consumed by this system."
1. "show the subscriptions being consumed by this system"

--servicelevel
#: ../src/subscription_manager/managercli.py:1728
msgid ""
"show only subscriptions matching the specified service level. Only used with "
"--available and --consumed"
2. "shows only subscriptions matching the specified service level, only used with --available and --consumed"

------------------------------------------------------------------------

redeem --help

--email
#: ../src/subscription_manager/managercli.py:1100
msgid "Email address to notify when subscription redemption is complete."
3. "email address to notify when subscription redemption is complete"

--locale
#: ../src/subscription_manager/managercli.py:1103
msgid ""
"Optional language to use for email notification when subscription redemption "
"is complete. Examples: en-us, de-de"
4. "optional language to use for email notification when subscription redemption "
"is complete (Examples: en-us, de-de)"

---------------------------------------------------------------------------

release -- help

--show 
#: ../src/subscription_manager/managercli.py:1151
msgid "shows current release setting. default command."
5. "shows current release setting, default command"

----------------------------------------------------------------------------

environments --help

--org 
#: ../src/subscription_manager/managercli.py:641
msgid "specify org for environment list"
6. "specify organization for environment list"

-----------------------------------------------------------------------------

rhsmcertd
Usage:
  rhsmcertd [OPTION...]

7. Change Usage statement to be on a single line (Usage: rhsmcertd...), matching sub-man, and change [OPTION...] to [OPTIONS]

8. Merge Help Options with App Options, rename section to Options:
 
Options:

--cert-interval
#: ../src/rhsmcertd.c:54
msgid "Interval to run cert check (in minutes)"
9. "interval to run cert check (in minutes)"

--heal-interval
#: ../src/rhsmcertd.c:57
msgid "Interval to run healing (in minutes)"
10. "interval to run auto-attach (in minutes)"
11. change --heal-interval to --attach-interval (do you think we need to call this --auto-attach-interval? --auto-interval?)

--now
#: ../src/rhsmcertd.c:60
msgid "Run the initial checks immediatly, with no delay."
12. "run the initial checks immediately, with no delay" (fix typo as well)

#: ../src/rhsm_icon.c:48 ../src/rhsmcertd.c:63
msgid "Show debug messages"
13. "show debug messages"

14. Show help options ->  "show this help message and exit" (not sure where this string lives, update to match our message in sub-man) 

15. remove newline at the end of the output of rhsmcertd --help

--------------------------------------------------------------------------

rhsm-icon --help
Usage:
 rhsm-icon [OPTION...]

16. make usage statement on single line, Usage: rhsm-icon [OPTIONS]


17. Rename [OPTION...] to [OPTIONS]

18. merge Help Options with Application Options into Options 

--check-period
#: ../src/rhsm_icon.c:46
msgid "How often to check for validity (in seconds)"
19. "how often to check for validity (in seconds)"

--debug
#: ../src/rhsm_icon.c:48 ../src/rhsmcertd.c:63
msgid "Show debug messages"
20. "show debug messages"

--force-icon
#: ../src/rhsm_icon.c:50
msgid "Force display of the icon (expired, partial or warning)"
21. "force display of the icon (expired, partial, or warning)"

--check-immediately
#: ../src/rhsm_icon.c:53
msgid "Run the first status check right away"
22. "run the first status check right away"

(not sure where these strings live)
23. Show help options -> show this help message and exit
24. Show all help options -> show all help options
25. Show GTK+ Options -> show GTK+ options

26. remove newline at the end of output

-------------------------------------------------------------------------


subscription-manager-gui --help
27. Usage: sub-man-gui [options] to [OPTIONS]

--register
28. "Launches the registration dialog on startup." -> "launches the registration dialog on startup"
(not sure where this lives)

-----------------------------------------------------------------------------

install-num-migrate-to-rhsm --help
usage: install-num-migrate-to-rhsm [options]
29. usage -> Usage
30. [options] -> [OPTIONS]

31. options: -> Options:

--instnumber
#: ../bin/install-num-migrate-to-rhsm:54
msgid "Install number to run against"
32. "install number to run against"

--dryrun
#: ../bin/install-num-migrate-to-rhsm:58
msgid "Only print the files which would be copied over"
33. "only print the files which would be copied over"

Version-Release number of selected component (if applicable):
subscription-manager-1.1.8-1

Additional info:

--- Additional comment from awood on 2012-11-14 16:12:14 EST ---

Some of these issues we are not able to fix since the strings come from the underlying option parsing library.

The issues are enumerated below

1 Fixable
2 Fixable
3 Fixable
4 Fixable
5 Fixable
6 Fixable
7 Can't fix
8 Can't fix
9 Fixable
10 Fixable
11 * I'd like to address this in a separate bug
12 Fixable
13 Fixable
14 Can't fix
15 Can't fix
16 Can't fix
17 Can't fix
18 Can't fix
19 Fixable
20 Fixable
21 Fixable
22 Fixable
23 Can't fix
24 Can't fix
25 Can't fix
26 Can't fix
27 Fixable
28 Fixable
29 Can't fix
30 Fixable
31 Can't fix
32 Fixable
33 Fixable