Bug 525659

Summary: Missing man-pages
Product: [Fedora] Fedora Reporter: Ivana Varekova <varekova>
Component: logrotateAssignee: Daniel Novotny <dnovotny>
Status: CLOSED ERRATA QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: medium Docs Contact:
Priority: medium    
Version: 12CC: dnovotny, tsmetana
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: 3.7.8-5.fc12 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2009-11-18 14:07:25 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:
Bug Depends On:    
Bug Blocks: 527378, 528649    
Attachments:
Description Flags
patch for adding a new man page none

Description Ivana Varekova 2009-09-25 08:47:59 UTC
Description of problem:
There are missing man page(s) for these tools or config files:
 /etc/logrotate.conf

If the man-pages are in a different package, please describe the details here.

In case the config file has the description inside and no additional man page is needed, please post a comment describing this situation here and set the bug status to CLOSE NOTABUG.

Short description on how to create man pages can be found here:

 https://fedoraproject.org/wiki/User:Varekova/man-pages

Actual results:
no man pages

Expected results:
man pages available

Comment 1 Daniel Novotny 2009-09-25 10:08:53 UTC
hello Ivana,

the format of the logrotate configuration file is described in detail in the logrotate's man page ("man logrotate")

is this OK for you, or do I need to split this man page into two? we (Red Hat) are also upstream for the package, so this would be no prob...

Comment 2 Ivana Varekova 2009-09-25 11:07:13 UTC
The standard solution is to have two man pages - one for the tool and one for the configuration file. Probably the less time consuming solution is to create a man page logrotate.conf.5 as a link to logrotate.8 man-page: put                   ".so man8/logrotate.8"
to logrotate.conf.5 man page. There is a mention about logrotate man page in the config file and it seems to contains description itself, so the link seems sufficient for me.

Comment 3 Daniel Novotny 2009-09-29 13:38:23 UTC
Created attachment 363005 [details]
patch for adding a new man page

Comment 4 Daniel Novotny 2009-09-29 13:39:37 UTC
fixed in logrotate-3.7.8-5.fc13 

f12 build will follow after the devel freeze is over

Comment 5 Fedora Update System 2009-11-12 17:23:42 UTC
logrotate-3.7.8-5.fc12 has been submitted as an update for Fedora 12.
http://admin.fedoraproject.org/updates/logrotate-3.7.8-5.fc12

Comment 6 Fedora Update System 2009-11-16 07:35:37 UTC
logrotate-3.7.8-5.fc12 has been pushed to the Fedora 12 testing repository.  If problems still persist, please make note of it in this bug report.
 If you want to test the update, you can install it with 
 su -c 'yum --enablerepo=updates-testing update logrotate'.  You can provide feedback for this update here: http://admin.fedoraproject.org/updates/F12/FEDORA-2009-11600

Comment 7 Bug Zapper 2009-11-16 12:55:11 UTC
This bug appears to have been reported against 'rawhide' during the Fedora 12 development cycle.
Changing version to '12'.

More information and reason for this action is here:
http://fedoraproject.org/wiki/BugZappers/HouseKeeping

Comment 8 Fedora Update System 2009-11-18 14:07:20 UTC
logrotate-3.7.8-5.fc12 has been pushed to the Fedora 12 stable repository.  If problems still persist, please make note of it in this bug report.