Description of problem: The dnf.conf man page is in the wrong mandb section. Version-Release number of selected component (if applicable): 0.6.2-1.fc21 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.
Thank you for report. We will fix it.
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
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. Michal
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.
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. https://admin.fedoraproject.org/updates/dnf-plugins-core-0.1.5-1.fc21,hawkey-0.5.3-2.fc21,dnf-0.6.4-1.fc21
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: https://admin.fedoraproject.org/updates/FEDORA-2015-2139/dnf-plugins-core-0.1.5-1.fc21,hawkey-0.5.3-2.fc21,dnf-0.6.4-1.fc21 then log in and leave karma (feedback).
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.