File Explorer

1.. image:: https://translate.fedoraproject.org/widgets/dnf/-/dnf-master/svg-badge.svg2    :alt: Translation status3    :target: https://translate.fedoraproject.org/engage/dnf/?utm_source=widget4###############5 Dandified YUM6###############7 8.. image:: https://raw.githubusercontent.com/rpm-software-management/dnf/gh-pages/logos/DNF_logo.png9 10Dandified YUM (DNF) is the next upcoming major version of `YUM <http://yum.baseurl.org/>`_. It does package management using `RPM <http://rpm.org/>`_, `libsolv <https://github.com/openSUSE/libsolv>`_ and `hawkey <https://github.com/rpm-software-management/hawkey>`_ libraries. For metadata handling and package downloads it utilizes `librepo <https://github.com/tojaj/librepo>`_. To process and effectively handle the comps data it uses `libcomps <https://github.com/midnightercz/libcomps>`_.11 12============13 Installing14============15 16DNF and all its dependencies are available in Fedora 18 and later, including the17rawhide Fedora.18 19Optionally you can use repositories with DNF nightly builds for last 2 stable Fedora versions available at copr://rpmsoftwaremanagement/dnf-nightly. You can enable the repository e.g. using:: 20 21    dnf copr enable rpmsoftwaremanagement/dnf-nightly22 23Then install DNF typing::24 25    sudo yum install dnf26 27In other RPM-based distributions you need to build all the components from their28sources.29 30======================31 Building from source32======================33 34All commands should be run from the DNF git checkout directory.35 36To install the build dependencies::37 38    sudo dnf builddep dnf.spec39 40To build DNF::41 42    mkdir build;43    pushd build;44    cmake ..; # add '-DPYTHON_DESIRED="3"' option for Python 3 build45    make;46    popd;47 48To run DNF when compiled for Python2::49 50    PYTHONPATH=`readlink -f .` bin/dnf-2 <arguments>51 52To run DNF when compiled for Python3::53 54    PYTHONPATH=`readlink -f .` bin/dnf-3 <arguments>55 56If you want to build the manpages, use the option ``-DWITH_MAN=0`` with cmake.57 58Man pages will be located in ``build/doc`` and can be read with ``man -l``, e.g::59 60    man -l build/doc/dnf.861 62=============================63 Building and installing rpm64=============================65 66From the DNF git checkout directory::67 68    $ tito build --test --rpm69    # dnf install /tmp/tito/noarch/*70 71===============72 Running tests73===============74 75From the DNF git checkout directory::76 77    mkdir build;78    pushd build;79    cmake .. && make ARGS="-V" test;80    popd;81 82==============83 Contribution84==============85 86Here's the most direct way to get your work merged into the project.87 881. Fork the project89#. Clone down your fork90#. Implement your feature or bug fix and commit changes91#. If the change fixes a bug at `Red Hat bugzilla <https://bugzilla.redhat.com/>`_, or if it is important to the end user, add the following block to the commit message::92 93    = changelog =94    msg:           message to be included in the changelog95    type:          one of: bugfix/enhancement/security (this field is required when message is present)96    resolves:      URLs to bugs or issues resolved by this commit (can be specified multiple times)97    related:       URLs to any related bugs or issues (can be specified multiple times)98 99   * For example::100 101       = changelog =102       msg: Verify GPG signatures when running dnf-automatic103       type: bugfix104       resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1793298105 106   * For your convenience, you can also use git commit template by running the following command in the top-level directory of this project::107 108       git config commit.template ./.git-commit-template109 110#. In special commit add your name and email under ``DNF CONTRIBUTORS`` section in `authors file <https://github.com/rpm-software-management/dnf/blob/master/AUTHORS>`_ as a reward for your generosity111#. Push the branch up to your fork112#. Send a pull request for your branch113 114Please, do not create the pull requests with translation (.po) files improvements. Fix the translation on `Fedora Weblate <https://translate.fedoraproject.org/projects/dnf/>`_ instead.115 116===============117 Documentation118===============119 120The DNF package distribution contains man pages, dnf(8) and dnf.conf(8). It is also possible to `read the DNF documentation <http://dnf.readthedocs.org>`_ online, the page includes API documentation. There's also a `wiki <https://github.com/rpm-software-management/dnf/wiki>`_ meant for contributors to DNF and related projects.121 122====================123 Bug reporting etc.124====================125 126Please report discovered bugs to the `Red Hat bugzilla <https://bugzilla.redhat.com/>`_ following this `guide <https://github.com/rpm-software-management/dnf/wiki/Bug-Reporting>`_. If you planned to propose the patch in the report, consider `Contribution`_ instead.127 128Freenode's irc channel ``#yum`` is meant for discussions related to both YUM and DNF. Questions should be asked there, issues discussed. Remember: ``#yum`` is not a support channel and prior research is expected from the questioner.129