Bug 1232168

Summary: grubby man page does not mention a grub2 option
Product: Red Hat Enterprise Linux 7 Reporter: Stephen Wadeley <swadeley>
Component: grubbyAssignee: rmarshall
Status: CLOSED ERRATA QA Contact: Release Test Team <release-test-team-automation>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 7.1CC: mbanas, pholica, rmarshall, sauchter
Target Milestone: rc   
Target Release: 7.3   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: grubby-8.28-18 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-11-04 07:52:24 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:

Description Stephen Wadeley 2015-06-16 08:24:12 UTC
Description of problem:

The grubby(8) manual page has:  

             [--grub] [--lilo] [--yaboot] [--silo] [--zipl]

but no mention of a grub2 option, or of GRUB 2 being the default when the command is used.

Version-Release number of selected component (if applicable):
[root@localhost ~]# rpm -q grubby
grubby-8.28-11.el7.x86_64

Actual results:


Expected results:

I expected to see a --grub2 option or an explanation that this is the default and that therefore there is no such option. The current man page leaves room for uncertainty.

Additional info:
------------------
The grubby man page says:

"It is primarily designed to be used from scripts which install new kernels ..."

and:
 "BUGS
       The command line syntax is more than a little baroque. This probably won't be fixed as grubby is only intended to be called from shell scripts which can get it right."
------------------------------------------

This text is at odds with the explanation in BZ#1149275 that grubby is the preferred tool for editing grub.cfg

Please change this text to make it clear that it not only *can* but *should* be used for manual updates to grub.cfg

Thank you

Comment 1 rmarshall 2016-07-01 20:02:50 UTC
The man page has been updated with the missing options.

grubby may be used on the command line, however, it was indeed designed to be called from scripts. The verbage will not change at this time.

Comment 5 errata-xmlrpc 2016-11-04 07:52:24 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-2525.html