Bug 169479

Summary: Missing man page for efibootmgr
Product: [Fedora] Fedora Reporter: Bryan Stillwell <stillwell>
Component: eliloAssignee: Jeremy Katz <katzj>
Status: CLOSED RAWHIDE QA Contact:
Severity: medium Docs Contact:
Priority: medium    
Version: rawhideCC: matt_domsch
Target Milestone: ---Keywords: FutureFeature
Target Release: ---   
Hardware: ia64   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2005-09-28 18:55:17 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Attachments:
Description Flags
Man page from debian none

Description Bryan Stillwell 2005-09-28 18:00:25 UTC 
From Bugzilla Helper:
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.7.12) Gecko/20050922 Firefox/1.0.7 (Ubuntu package 1.0.7)

Description of problem:
Using rpm to query the contents of the following package shows that there is not a valid man page for efibootmgr:

http://download.fedora.redhat.com/pub/fedora/linux/core/development/ia64/Fedora/RPMS/elilo-3.4-11.ia64.rpm

I checked on one of my Debian systems and there does appear to be a proper man page for this program with the following comment at the bottom:

"This man page was generated by dann frazier <dannf> for the Debian GNU/Linux operating system, but may be used by others."

I believe that it should be standard packaging policy to have man pages for any binary located in /bin, /sbin, /usr/bin, and /usr/sbin.

Version-Release number of selected component (if applicable):
elilo-3.4-11

How reproducible:
Always

Steps to Reproduce:
1. Run "man efibootmgr" and see if a proper man page is displayed.

Actual Results:  # man efibootmgr
No manual entry for efibootmgr

Expected Results:  Proper man page should be displayed.

Additional info:
Comment 1 Bryan Stillwell 2005-09-28 18:06:33 UTC 
Created attachment 119382 [details]
Man page from debian
Comment 2 Jeremy Katz 2005-09-28 18:27:52 UTC 
Matt -- want to add it to upstream efibootmgr and then I'll pull down a new
tarball? :)
Comment 3 Matt Domsch 2005-09-28 18:41:49 UTC 
It's already in the upstream efibootmgr.  I was glad that Dann wrote it.
It's a packaging bug in the elilo RPM script that it's not installing the 
manpage already in the package.  Something like this (untested, may not be to 
usual RPM spec standards):

--- elilo.spec.~1.14.~  2005-03-26 21:53:25.000000000 -0600
+++ elilo.spec  2005-09-28 13:42:15.000000000 -0500
@@ -48,6 +48,7 @@

 mkdir -p $RPM_BUILD_ROOT/usr/sbin
 install -m 755 efibootmgr-%{efibootmgr_ver}/src/efibootmgr/efibootmgr 
$RPM_BUILD_ROOT/usr/sbin
+install -m 644 efibootmgr-%{efibootmgr_ver}/src/man/man8/efibootmgr.8 
$RPM_BUILD_ROOT/usr/share/man/man8

 %clean
 rm -rf $RPM_BUILD_ROOT
@@ -57,6 +58,7 @@
 %doc docs/* README.* LIMITATIONS ChangeLog efibootmgr-%
{efibootmgr_ver}/efibootmgr-doc
 /boot/efi
 /usr/sbin/efibootmgr
+%doc /usr/share/man/man8/efibootmgr.8

 %changelog
 * Thu Mar  3 2005 Jeremy Katz <katzj> - 3.4-11
Comment 4 Jeremy Katz 2005-09-28 18:55:17 UTC 
That'll teach me to look closer.  Thanks, will add and do a build
Comment 5 Bryan Stillwell 2005-09-28 19:08:40 UTC 
Jeremy and Matt,

Thanks for the quick responses!  Is there any chance this fix can be marked for
inclusion into rhel4u2 or rhel4u3?

Thanks,
Bryan