Bug 2217933

Summary: No manual how to install a missing dnf5 command plugin (e.g. builddep)
Product: [Fedora] Fedora Reporter: Jan Pazdziora <jpazdziora>
Component: dnf5Assignee: Jan Kolarik <jkolarik>
Status: POST --- QA Contact:
Severity: medium Docs Contact:
Priority: unspecified    
Version: 39CC: jkolarik, jpazdziora, nsella, petersen, pkratoch, ppisar, rpm-software-management
Target Milestone: ---Keywords: Regression, Triaged
Target Release: ---   
Hardware: Unspecified   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Jan Pazdziora 2023-06-27 14:16:57 UTC
The dnf5 command builddep does not work.

The man dnf5(8) says

   Plugin commands
       Here is the list of the commands available as plugins.
       builddep
              Install missing dependencies for building an RPM package.
[...]

       --enable-plugin=PLUGIN_NAME,...
              Enable specified plugins for the purpose of the current DNF5 command.
              This is a list option which can be specified multiple times.
              Accepted values are names, or a glob of names.

[...]

SEE ALSO
[...]
       Plugins:
              dnf5-builddep(8), Builddep command

But neither dnf5 --enable-plugin=builddep builddep, nor man 8 dnf5-builddep works either.


Reproducible: Always

Steps to Reproduce:

1. dnf5 builddep ~/rpmbuild/SPECS/lasso.spec
2. dnf5 --enable-plugin=builddep builddep ~/rpmbuild/SPECS/lasso.spec
3. man 8 dnf5-builddep
Actual Results:  

# dnf5 builddep ~/rpmbuild/SPECS/lasso.spec
Unknown argument "builddep" for command "dnf5". Add "--help" for more information about the arguments.
# dnf5 --enable-plugin=builddep builddep ~/rpmbuild/SPECS/lasso.spec
Unknown argument "builddep" for command "dnf5". Add "--help" for more information about the arguments.
# man 8 dnf5-builddep
No manual entry for dnf5-builddep in section 8


Expected Results:  
Either dnf5 builddep working out of box, or clear information either in the man page or on the command line how to proceed.

For example, dnf-4.16.1-2.fc39.noarch says

# dnf builddep ~/rpmbuild/SPECS/lasso.spec 
No such command: builddep. Please use /usr/bin/dnf --help
It could be a DNF plugin command, try: "dnf install 'dnf-command(builddep)'"

clearly telling the user how to proceed.

Comment 1 Jan Pazdziora 2023-06-27 14:17:49 UTC
The new Fedora bug filing form did not ask for that information but the described experience is with dnf5-5.0.14-1.fc39.x86_64.

Comment 2 Jan Kolarik 2023-06-27 14:25:20 UTC
Hi, I guess the "dnf5-plugins" package is not installed in your environment.

Comment 3 Jan Pazdziora 2023-06-27 14:29:17 UTC
Indeed, it was not installed and after installing it, the command works.

Can that information be added to the dnf5(8) man page and/or to the dnf5 output when it fails to understand the command, like dnf 4 does? Also, similar to dnf4, I'd expect something like dnf5 install 'dnf5-command(builddep)' to work.

Comment 4 Jan Kolarik 2023-06-27 14:59:22 UTC
I will discuss it with the team to find the best way how to inform the user. Regarding the command provides, there is already an existing issue submitted in upstream: https://github.com/rpm-software-management/dnf5/issues/566. Thanks for the report!

Comment 5 Jan Kolarik 2023-06-30 10:19:37 UTC
A note to the main man page is added by the following PR: https://github.com/rpm-software-management/dnf5/pull/687.

Comment 6 Jens Petersen 2023-07-06 10:19:53 UTC
(I think it would be more useful in the help/error message than in the manpage)

dnf5-plugins is already installed in current Rawhide images at least.

Nevertheless I think it would be a good idea if dnf5 had weak dependency to pull in dnf5-plugins?
This should also improve/fix the upgrade experience for users coming from F38.
I will open a separate RFE for that.

Comment 7 Fedora Release Engineering 2023-08-16 08:11:28 UTC
This bug appears to have been reported against 'rawhide' during the Fedora Linux 39 development cycle.
Changing version to 39.