Bug 1249961 - error in the table on Security-related commands usable with yum updateinfo
error in the table on Security-related commands usable with yum updateinfo
Status: CLOSED CURRENTRELEASE
Product: Red Hat Enterprise Linux 7
Classification: Red Hat
Component: doc-Security_Guide (Show other bugs)
7.1
Unspecified Unspecified
urgent Severity low
: rc
: ---
Assigned To: Robert Krátký
ecs-bugs
: Documentation, EasyFix
Depends On:
Blocks:
  Show dependency treegraph
 
Reported: 2015-08-04 04:59 EDT by mertensb
Modified: 2015-09-15 06:45 EDT (History)
1 user (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Environment:
Last Closed: 2015-09-15 06:45:53 EDT
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)

  None (edit)
Description mertensb 2015-08-04 04:59:15 EDT
Document URL: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Security_Guide/chap-Keeping_Your_System_Up-to-Date.html#sec-Planning_and_Configuring_Security_Updates

Section Number and Name: 3.1.1. Planning and Configuring Security Updates

Describe the issue: 
Table 3.1. Security-related commands usable with yum updateinfo contains several commands and their syntax however the syntax of this table is inconsistent and the description of the advisory command contains an incorrect reference.
Incorrect reference: the optional argument to the advisory command is written as [advisories] while the description refers to this argument as "Replace advisory with an advisory number or numbers." When taken literally this will result in an error.
Syntax issue: the optional argument to the advisory command is written as [advisories] while the optional argument to the severity command command is written without brackets and in italic font. 

Suggestions for improvement: 
- use standard formatting for commands, and (optional) arguments
- use the correct reference "Replace advisories with an advisory number or numbers."

Additional information: 
The information on how to report errors in documentation appears to be missing from ALL documents I checked (both RHEL6 and RHEL7).  I suggest that you add this section again.
Comment 2 Robert Krátký 2015-08-04 06:54:36 EDT
Hi,

Thanks for reporting this. I fixed both the syntax and the description. It'll take probably about a week for the guide to get updated on the Customer Portal.

As for the information about bug reporting, I'll inquire about the possibility of putting it back into the guides.

Again, thanks for taking the time to report a bug even if the instructions were missing.

Robert
Comment 5 Robert Krátký 2015-09-15 06:45:53 EDT
The updated guide has been published as a part of the RHEL 7.2 Beta documentation set.

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7-Beta/html/Security_Guide/chap-Keeping_Your_System_Up-to-Date.html#sec-Planning_and_Configuring_Security_Updates

Note You need to log in before you can comment on or make changes to this bug.