isabella232 / dnf-plugins-extras

repository for DNF community plugins

Extras DNF Plugins

Community plugins to use with DNF.

Installation

RPM packages for individual plugins are available in official Fedora repositories:

dnf install dnf-plugin-kickstart
dnf install dnf-plugin-rpmconf
dnf install dnf-plugin-showvars
dnf install dnf-plugin-snapper
dnf install dnf-plugin-system-upgrade
dnf install dnf-plugin-torproxy
dnf install dnf-plugin-tracer

Nigthly builds can be installed from copr repository.

Building from source

From the dnf-plugins-extras git checkout directory:

mkdir build;
pushd build;
cmake .. && make;
popd;

Contribution

Here's the most direct way to get your work merged into the project.

1. Fork the project

2. Clone down your fork

3. Implement your feature or bug fix and commit changes

4. If the change fixes a bug at Red Hat bugzilla, or if it is important to the end user, add the following block to the commit message:

   = changelog =
   msg:           message to be included in the changelog
   type:          one of: bugfix/enhancement/security (this field is required when message is present)
   resolves:      URLs to bugs or issues resolved by this commit (can be specified multiple times)
   related:       URLs to any related bugs or issues (can be specified multiple times)
   

   • For example:

     = changelog =
     msg: Do not show Operation aborted as an error
     type: bugfix
     resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1797427
     

   • For your convenience, you can also use git commit template by running the following command in the top-level directory of this project:

     git config commit.template ./.git-commit-template
     

5. In a separate commit, add your name and email into the authors file as a reward for your generosity

6. Push the branch to your fork

7. Send a pull request for your branch

Please do not create pull requests with translation (.po) file improvements. Fix the translation on Fedora Weblate instead.

Documentation

The dnf-plugins-extras package distribution contains man pages dnf-<plugin-name>(8). It is also possible to read the dnf-plugins-extras documentation online.

Bug reporting etc.

Please report discovered bugs to the Red Hat bugzilla. If you plan to propose a patch, consider contribution instead.

Freenode'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.