Bug 1192574
| Summary: | typos and poor grammar in subscription-manager-gui man page | ||
|---|---|---|---|
| Product: | Red Hat Enterprise Linux 6 | Reporter: | John Sefler <jsefler> |
| Component: | subscription-manager | Assignee: | William Poteat <wpoteat> |
| Status: | CLOSED ERRATA | QA Contact: | John Sefler <jsefler> |
| Severity: | low | Docs Contact: | |
| Priority: | low | ||
| Version: | 6.8 | CC: | bcourt, crog, csnyder, dgoodwin, skallesh, wpoteat |
| Target Milestone: | rc | Keywords: | Triaged |
| Target Release: | --- | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2016-05-10 20:36:23 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: | 1209535 | ||
|
Description
John Sefler
2015-02-13 18:21:16 UTC
[root@jsefler-os7 ~]# man subscription-manager-gui | grep DESCRIPTION -A12
DESCRIPTION
subscription-manager-gui opens the local client tool to manage sub‐
scriptions and installed products on Red Hat Enterprise Linux systems.
The same tasks that can be performed by invoking subscription-manager
can be performed in the GUI, including registering systems with a sub‐
scription management service, applying and removing subscriptions, and
viewing the subscription status of installed products.
The Subscription Manager UI can also be opened by selecting the Red Hat
Subscription Manager item from the Applications > System Tools menu in
RHEL 5.x or the System > Administration menu in RHEL 6.x.
Change this last paragraph to include RHEL 7.x as follows...
The Subscription Manager UI can also be opened by selecting the Red Hat
Subscription Manager item from the Applications > System Tools menu in
RHEL 5.x and RHEL7.x or the System > Administration menu in RHEL 6.x.
^^^^^^^^^^^
ADD HERE
[root@jsefler-os7 ~]# man subscription-manager-gui | head -1
subscription-manager-gui(8) System Manager's Manual subscription-manager-gui(8)
^^^^^^^^^^^^^^^^^^^^^^^
change to Subscription Management
[root@jsefler-os7 ~]# man subscription-manager-gui | grep REFERENCES -A5
REFERENCES
For procedures and tasks that can be performed in the Subscription Man‐
ager UI, check the Gnome help files (by pressing <F1>) or refer to the
RHEL Subscription Management Guide at <https://access.redhat.com/knowl‐
edge/docs/en-US/Red_Hat_Subscription_Management/1.0/html/Subscrip‐
tion_Management_Guide/index.html>.
The link referenced above from the the subscription-manager-gui man page is no longer found at https://access.redhat.com/documentation/en-US/Red_Hat_Subscription_Management/1.0/html/Subscription_Management_Guide/index.html
The document appears to have moved to...
https://access.redhat.com/documentation/en-US/Red_Hat_Subscription_Management/1/html/RHSM/index.html
Deferring to RHEL6.7 for resolution commit 589bf7debe8702d147f3a69f61f34c44ab47ef63
Author: Chris Rog <crog>
Date: Thu Apr 9 10:29:28 2015 -0400
1192574: Fixed typos and grammar issues in subman GUI man page
Marking bug as failed_qa because the space between the headings is missing, whereas the description and refernces have been changed
[root@pogo-cn1100-01 ~]# man subscription-manager-gui | head -1
subscription-manager-gui(8) Subscription Managementsubscription-manager-gui(8)
^^^ need a space here in between 2 words
-------------------------------------------------------------------------------
Description has been changed
[root@pogo-cn1100-01 ~]# man subscription-manager-gui | grep "Subscription Manager UI" -A12
The Subscription Manager UI can also be opened by selecting the Red Hat
Subscription Manager item from the Applications > System Tools menu in
RHEL 5.x and RHEL 7.x, or the System > Administration menu in RHEL 6.x.
---------------------------------------------------------------------------------
Link reference has been changed
REFERENCES
For procedures and tasks that can be performed in the Subscription Manager UI, check the Gnome help files (by pressing <F1>) or refer to the
RHEL Subscription Management Guide at <https://access.redhat.com/documentation/en-US/Red_Hat_Subscription_Management/1/html/RHSM/index.html>.
--------------------------------------------------------------------------------
Regarding the objection on comment 8... I found that the rendering of the exact same subscription-manager-gui man page (/usr/share/man/man8/subscription-manager-gui.8.gz) on RHEL6 and RHEL7 behaves slightly different with respect to the rendering of .TH and is therefore a bug in the version of groff installed on RHEL6. On RHEL6, the .TH appears to render as a fixed width in the terminal and since there are limited characters in the page width, the title runs into the name of the program as shown here... [root@jsefler-6 ~]# man subscription-manager-gui | head -1 subscription-manager-gui(8) Subscription Managementsubscription-manager-gui(8) [root@jsefler-6 ~]# rpm -qa | grep groff groff-1.18.1.4-21.el6.x86_64 Where as on RHEL7, the .TH will expand to the witch of the terminal. Hence a wider terminal will allow the .TH line to render with the title centered between the name of the program justified on the left and the right as shown here... [root@jsefler-7 ~]# man subscription-manager-gui | head -1 subscription-manager-gui(8) Subscription Management subscription-manager-gui(8) [root@jsefler-7 ~]# rpm -qa | grep groff groff-base-1.22.2-8.el7.x86_64 Moving this bug to VERIFIED as the original issues were fixed. The .TH formatting issue would be a groff bug on RHEL6 that appears to already have been fixed on RHEL7. 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. https://rhn.redhat.com/errata/RHBA-2016-0797.html |