Bug 876356

Summary:	String Updates: Tweaks to 'subscription-manager help' module descriptions
Product:	Red Hat Enterprise Linux 6	Reporter:	Matt Reid <mreid>
Component:	subscription-manager	Assignee:	Alex Wood <awood>
Status:	CLOSED ERRATA	QA Contact:	IDM QE LIST <seceng-idm-qe-list>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	6.4	CC:	awood, jsefler
Target Milestone:	rc
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2013-02-21 09:00:38 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	771481, 840993

Description Matt Reid 2012-11-13 22:31:38 UTC

Description of problem:
There are a few strings in 'subscription-manager help' that we should clean up if we have time.

The register and unregister module descriptions are the only ones that don't start with a capital letter. These strings, along with a few others, also end with a '.' while the majority of the description strings do not. We should remove the periods at the end of the strings that have them, and ensure that all strings start with their first word capitalized. Finally, we should spell out the abbreviations we use in some of the descriptions to be the full word (orgs -> organizations, repos -> repositories, os -> operating system).

Register/unregister are also the only 2 times we use client, didn't check for that when I went through the System bz, so we should take this opportunity to replace 'the client' with 'this system'.

#: ../src/subscription_manager/branding/redhat_branding.py:7
msgid ""
"register the client to the Customer Portal or another subscription "
"management service."
1. "Register this system to the Customer Portal or another subscription management service"

#: ../src/subscription_manager/branding/redhat_branding.py:8
msgid ""
"unregister the client from the Customer Portal or another subscription "
"management service."
2. "Unregister this system from the Customer Portal or another subscription management service"

#: ../src/subscription_manager/managercli.py:1603
msgid ""
"List, set, or remove the configuration parameters in use by this system."
3. "List, set, or remove the configuration parameters in use by this system"

#: ../src/subscription_manager/managercli.py:1712
msgid "List subscription and product information for this system."
4. "List subscription and product information for this system"

#: ../src/subscription_manager/managercli.py:599
msgid "Display the orgs against which a user can register a system"
5. "Display the organizations against which a user can register a system"

#: ../src/subscription_manager/managercli.py:1511
msgid "List the repos which this machine is entitled to use"
6. "List the repositories which this system is entitled to use"

#: ../src/subscription_manager/managercli.py:1146
msgid "Configure what os release to use"
7. "Configure which operating system release to use"

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

Additional info:

Comment 1 Alex Wood 2012-11-14 20:09:18 UTC

commit fc32d80d66731c9ae3c493ef009964854f3e2096
Author: Alex Wood <awood>
Date:   Wed Nov 14 11:52:03 2012 -0500

    876356: Wording and punctuation changes.

Comment 3 Matt Reid 2012-11-15 15:42:20 UTC

I just did a git pull and built rpms this morning, and while I see most of the changes, I still see the config module's description (#3 above) and list's description (#4) with a period at the end. Rest of it looks good!

Comment 4 Alex Wood 2012-11-16 15:31:38 UTC

commit 3474faed0f908bb76d4110a1ca1e0b8e88d808ae
Author: Alex Wood <awood>
Date:   Fri Nov 16 10:10:17 2012 -0500

    876356: Punctuation changes.

Comment 6 John Sefler 2012-12-10 20:04:16 UTC

Verifying Version....
[root@jsefler-6 ~]# rpm -q subscription-manager
subscription-manager-1.1.11-1.el6.x86_64


> 1. "Register this system to the Customer Portal or another subscription management service"
[root@jsefler-6 ~]# subscription-manager register --help | head -4
Usage: subscription-manager register [OPTIONS]

Register this system to the Customer Portal or another subscription management
service

^^^^^ VERIFIED


> 2. "Unregister this system from the Customer Portal or another subscription management service"
[root@jsefler-6 ~]# subscription-manager unregister --help | head -4
Usage: subscription-manager unregister [OPTIONS]

Unregister this system from the Customer Portal or another subscription
management service

^^^^^ VERIFIED


> 3. "List, set, or remove the configuration parameters in use by this system"
[root@jsefler-6 ~]# subscription-manager config --help | head -4
Usage: subscription-manager config [OPTIONS]

List, set, or remove the configuration parameters in use by this system

^^^^^ VERIFIED


> 4. "List subscription and product information for this system"
[root@jsefler-6 ~]# subscription-manager list --help | head -4
Usage: subscription-manager list [OPTIONS]

List subscription and product information for this system

^^^^^ VERIFIED


> 5. "Display the organizations against which a user can register a system"
[root@jsefler-6 ~]# subscription-manager orgs --help | head -4
Usage: subscription-manager orgs [OPTIONS]

Display the organizations against which a user can register a system

^^^^^ VERIFIED


> 6. "List the repositories which this system is entitled to use"
[root@jsefler-6 ~]# subscription-manager repos --help | head -4
Usage: subscription-manager repos [OPTIONS]

List the repositories which this system is entitled to use

^^^^^ VERIFIED


> 7. "Configure which operating system release to use"
[root@jsefler-6 ~]# subscription-manager release --help | head -4
Usage: subscription-manager release [OPTIONS]

Configure which operating system release to use

^^^^^ VERIFIED

Comment 8 errata-xmlrpc 2013-02-21 09:00:38 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHBA-2013-0350.html