Add dnf5.conf man page

add dnf5.conf.todo.5.rst page which documents differences between dnf4 and dnf5 config options
rpm-software-management · Sep 6, 2023 · ebff4ac · ebff4ac
1 parent 6d7cb37
commit ebff4ac
Show file tree

Hide file tree

Showing 7 changed files with 1,580 additions and 0 deletions.
diff --git a/dnf5.spec b/dnf5.spec
@@ -276,6 +276,7 @@ It supports RPM packages, modulemd modules, and comps groups & environments.
 # TODO(jkolarik): modularity is not ready yet
 # %%{_mandir}/man7/dnf5-modularity.7.*
 %{_mandir}/man7/dnf5-specs.7.*
+%{_mandir}/man5/dnf5.conf.5.*
 
 # ========== libdnf5 ==========
 %package -n libdnf5

diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
@@ -87,6 +87,7 @@ if(WITH_MAN)
         install(FILES ${CMAKE_CURRENT_BINARY_DIR}/man/dnf5-builddep.8 DESTINATION share/man/man8)
         install(FILES ${CMAKE_CURRENT_BINARY_DIR}/man/dnf5-copr.8 DESTINATION share/man/man8)
         install(FILES ${CMAKE_CURRENT_BINARY_DIR}/man/dnf5-repoclosure.8 DESTINATION share/man/man8)
+        install(FILES ${CMAKE_CURRENT_BINARY_DIR}/man/dnf5.conf.5 DESTINATION share/man/man5)
     endif()
 
 endif()
diff --git a/doc/conf.py.in b/doc/conf.py.in
@@ -139,6 +139,7 @@ man_pages = [
     ('dnf_daemon/dnf5daemon_client.8', 'dnf5daemon-client', 'Command-line interface for Dnf5daemon', AUTHORS, 8),
     ('dnf_daemon/dnf5daemon_server.8', 'dnf5daemon-server', 'Package management service with a DBus interface', AUTHORS, 8),
     ('dnf_daemon/dnf5daemon_dbus_api.8', 'dnf5daemon-dbus-api', 'DBus API Reference for Dnf5daemon', AUTHORS, 8),
+    ('dnf5.conf.5', 'dnf5.conf', 'DNF5 Configuration Reference', AUTHORS, 5),
 ]
 
 rst_prolog = """

diff --git a/doc/dnf5.8.rst b/doc/dnf5.8.rst
@@ -16,6 +16,8 @@
     You should have received a copy of the GNU General Public License
     along with libdnf.  If not, see <https://www.gnu.org/licenses/>.
 
+.. _command_ref-label:
+
 ################################
  DNF5 Package Management Utility
 ################################
@@ -361,6 +363,7 @@ Miscellaneous:
     | :manpage:`dnf5-comps(7)`, :ref:`Comps groups and environments <comps_misc_ref-label>`
     | :manpage:`dnf5-installroot(7)`, :ref:`Installroot parameter <installroot_misc_ref-label>`
     | :manpage:`dnf5-specs(7)`, :ref:`Patterns specification <specs_misc_ref-label>`
+    | :manpage:`dnf5-conf(5)`, :ref:`DNF5 Configuration Reference <dnf5_conf-label>`
 
 ..
     # TODO(jkolarik): Filtering is not ready yet