Bug 1192646

Summary: typos and poor grammar in rhsm.conf man page
Product: Red Hat Enterprise Linux 6 Reporter: John Sefler <jsefler>
Component: subscription-managerAssignee: Chris "Ceiu" Rog <crog>
Status: CLOSED ERRATA QA Contact: John Sefler <jsefler>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 6.7CC: crog, dgoodwin, skallesh
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: 2016-05-10 20:36:27 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 23:03:29 UTC
Description of problem:
There are a few typos and grammar improvements that can be made in the rhsm.conf man page.  See the comments that follow for each.

Version-Release number of selected component (if applicable):
[root@jsefler-os7 ~]# rpm -q subscription-manager
subscription-manager-1.13.19-1.el7.x86_64

Comment 2 John Sefler 2015-02-13 23:17:10 UTC
[root@jsefler-os7 ~]# man rhsm.conf | grep mananager
       rhsm.conf - Configuration file for the subscription-mananager tooling
                                              ^^^^^^^^^^^^^^^^^^^^^^

typo in "subscription-mananager"; should be "subscription-manager"

Comment 3 John Sefler 2015-02-13 23:18:14 UTC
[root@jsefler-os7 ~]# man rhsm.conf | grep "pulldown"
           with the server and to pulldown content.
                                  ^^^^^^^^

"pulldown" is not a word; should be "pull down"

Comment 4 John Sefler 2015-02-14 16:23:11 UTC
[root@jsefler-os7 ~]# man -P cat rhsm.conf | grep "COPYING" -A5
COPYING
       Copyright (c) 2010-2012 Red Hat, Inc. This is licensed under the GNU General Public
       License, version 2 (GPLv2). A copy of this license is available at
       http://www.gnu.org/licenses/old- licenses/gpl-2.0.txt.
                                       ^
                                       ^
                                       ^

remove the stray space in "old- licenses"

Comment 5 John Sefler 2015-02-14 16:58:39 UTC
[root@jsefler-os7 ~]# man -P cat rhsm.conf | tail -1
rhsm.conf                 11/07/2014              RHSM.CONF(5)
                          ^^^^^^^^^^
                          REMOVE THIS DATE

It was decided in bug 1145828 comments 6 and 7  to remove the dates and versions from the man pages owned by subscription-manager,

Comment 6 John Sefler 2015-02-24 16:25:38 UTC
Deferring to RHEL6.7 for resolution

Comment 7 John Sefler 2015-03-10 18:45:17 UTC
[root@jsefler-os6 ~]# man rhsm.conf | grep "plugin"
       pluginDir
           The directory to search for subscription manager plugins
       pluginConfDir
           The directory to search for plugin configuration files


"plugins" and "plugin" should be hyphenated in the descriptions according to http://www.oxforddictionaries.com/

Comment 8 Chris "Ceiu" Rog 2015-06-04 14:58:23 UTC
commit 5157378c714de78fbb0ca9f5b47b567ac44efa84
Author: Chris Rog <crog>
Date:   Thu Apr 9 10:36:41 2015 -0400

    1192646: Fixed typos and grammar issues in the RHSM conf man page



Note: The plugin change was not made, as it (and the BZ regarding several other instances of it) were NACK'd by the team.

Comment 11 Shwetha Kallesh 2015-12-09 08:15:57 UTC
Marking verified 

[root@pogo-cn1100-01 ~]# subscription-manager  version
server type: Red Hat Subscription Management
subscription management server: 0.9.51.11-1
subscription management rules: 5.15
subscription-manager: 1.16.6-1.el6
python-rhsm: 1.16.4-1.el6


Date has been removed:

[root@pogo-cn1100-01 ~]# man -P cat rhsm.conf | tail -1
rhsm.conf                              -                          RHSM.CONF(5)


----------------------------------------------------------------------------
Manager spelling has been corrected


[root@pogo-cn1100-01 ~]# man rhsm.conf | grep mananager

[root@pogo-cn1100-01 ~]# man rhsm.conf | grep manager
       rhsm.conf - Configuration file for the subscription-manager tooling

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

Pull down has been corrected:

[root@pogo-cn1100-01 ~]# man rhsm.conf | grep "pulldown"
[root@pogo-cn1100-01 ~]# man rhsm.conf | grep "pull down"
           with the server and to pull down content.

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

Stray space has been removed

[root@pogo-cn1100-01 ~]# man -P cat rhsm.conf | grep "Copyright" -A5
       Copyright (c) 2010-2012 Red Hat, Inc. This is licensed under the GNU
       General Public License, version 2 (GPLv2). A copy of this license is
       available at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.

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

Plugin and plugins have been hyphenated in the descriptions

[root@pogo-cn1100-01 ~]# man rhsm.conf | grep "plugin" -A2
       pluginDir
           The directory to search for subscription manager plug-ins

       pluginConfDir
           The directory to search for plug-in configuration files

Comment 13 errata-xmlrpc 2016-05-10 20:36:27 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.

https://rhn.redhat.com/errata/RHBA-2016-0797.html