Bug 1167982 - dnf.conf man page is in the wrong section
Summary: dnf.conf man page is in the wrong section
Alias: None
Product: Fedora
Classification: Fedora
Component: dnf
Version: 21
Hardware: Unspecified
OS: Unspecified
Target Milestone: ---
Assignee: Michal Luscon
QA Contact: Fedora Extras Quality Assurance
Depends On:
TreeView+ depends on / blocked
Reported: 2014-11-25 19:17 UTC by Mario Blättermann
Modified: 2015-02-20 08:32 UTC (History)
7 users (show)

Clone Of:
Last Closed: 2015-02-20 08:32:37 UTC

Attachments (Terms of Use)

Description Mario Blättermann 2014-11-25 19:17:01 UTC
Description of problem:
The dnf.conf man page is in the wrong mandb section.

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

If someone searches for man pages of configuration files, the usual command would be "man 5 name.conf". But this doesn't work for dnf. Please move dnf.conf.8 to dnf.conf.5, where such files usually resides.

With "man man" you'll get more information about the purpose of certain mandb sections.

Comment 1 Michal Luscon 2014-11-26 16:13:36 UTC
Thank you for report. We will fix it.

Comment 2 Mario Blättermann 2014-12-11 13:23:10 UTC
OK, nothing happened since your response, and a new version of dnf has been released... It's terribly simple to fix, here's the patch:

diff --git a/doc/conf.py b/doc/conf.py
index f16f912..a77d27b 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -241,7 +241,7 @@ man_pages = [
     ('command_ref', 'dnf', u'DNF Command Reference',
      AUTHORS, 8),
     ('conf_ref', 'dnf.conf', u'DNF Configuration Reference',
-     AUTHORS, 8),
+     AUTHORS, 5),
 # If true, show URL addresses after external links.

(You can download it from https://mariobl.fedorapeople.org/Patches/dnf.conf.diff)

After applying the patch I get the following terminal output, and the man page lands in dnf/doc/dnf.conf.5:

[mariobl@localhost dnf]$ make doc-man
[100%] Building manpage documentation
Running Sphinx v1.2.2
loading pickled environment... not yet created
building [man]: all manpages
updating environment: 23 added, 0 changed, 0 removed
reading sources... [100%] user_faq                                             
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... dnf.automatic.8 { } dnf.8 { } dnf.conf.5 { } 
build succeeded.
[100%] Built target doc-man

Comment 3 Michal Luscon 2014-12-12 08:40:01 UTC
Hi Mario,

my pull request has not been merged yet, probably as this is a non-critical issue(https://github.com/rpm-software-management/dnf/pull/182). The state of this bugzilla will be updated once the PR is merged. 


Comment 4 Mario Blättermann 2014-12-12 19:23:42 UTC
OK, no problem. I had assumed you have direct write access to the DNF sources, and after all, the maintainer Jan Silhan is in the CC list of this ticket anyway. However, DNF upstream releases come quite often, so we (hopefully!) don't have to wait that long to get this fixed.

Comment 5 Fedora Update System 2015-02-16 00:03:24 UTC
dnf-plugins-core-0.1.5-1.fc21,hawkey-0.5.3-2.fc21,dnf-0.6.4-1.fc21 has been submitted as an update for Fedora 21.

Comment 6 Fedora Update System 2015-02-17 08:04:18 UTC
Package hawkey-0.5.3-2.fc21, dnf-plugins-core-0.1.5-1.fc21, dnf-0.6.4-1.fc21:
* should fix your issue,
* was pushed to the Fedora 21 testing repository,
* should be available at your local mirror within two days.
Update it with:
# su -c 'yum update --enablerepo=updates-testing hawkey-0.5.3-2.fc21 dnf-plugins-core-0.1.5-1.fc21 dnf-0.6.4-1.fc21'
as soon as you are able to.
Please go to the following url:
then log in and leave karma (feedback).

Comment 7 Fedora Update System 2015-02-20 08:32:37 UTC
hawkey-0.5.3-2.fc21, dnf-plugins-core-0.1.5-1.fc21, dnf-0.6.4-1.fc21 has been pushed to the Fedora 21 stable repository.  If problems still persist, please make note of it in this bug report.

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