Bug 2216055

Summary: DNF5 documented option --skip-broken throws a syntax error
Product: [Fedora] Fedora Reporter: Ian Laurie <nixuser>
Component: dnf5Assignee: rpm-software-management
Status: CLOSED EOL QA Contact:
Severity: low Docs Contact:
Priority: unspecified    
Version: 39CC: alekcejk, jkolarik, mblaha, mmalik, nsella, pkratoch, psplicha, rpm-software-management
Target Milestone: ---Keywords: Triaged
Target Release: ---   
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2024-11-27 21:13:39 UTC 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 Ian Laurie 2023-06-19 23:37:32 UTC
The man page for DNF5 in Rawhide shows --skip-broken to be a legal generic option, however it does not show up in a "dnf --help" and in practice its use results in this error:

Unknown argument "--skip-broken" for command "dnf5". Add "--help" for more information about the arguments. 

Reproducible: Always

Steps to Reproduce:
1. Launch DNF5 using the --skip-broken option.
2.
3.
Actual Results:  
Throws an error.

Expected Results:  
Documented option should work.

Considering that --help doesn't show the --skip-broken option this is probably a bug in the man page rather than DNF5.

Even if the option is useless in the current version of DNF, it may be a good idea to support it in DNF5, and simply ignore it, to maintain compatibility with existing automation scripts.

The man page also does not document the available legacy DNF compatibility options (for example --enablerepo for --enable-repo).

Comment 1 Marek Blaha 2023-06-20 06:02:04 UTC
Sorry, this is indeed a mistake in dnf5 man pages. The `--skip-broken` and `--skip-unavailable` options are not general for any command, but are implemented only for some dnf5 commands - currently distrosync, downgrade, group install, group upgrade, install, and reinstall.

Comment 2 Milos Malik 2023-06-23 10:59:25 UTC
Observation:

# dnf --skip-broken install filesystem
Unknown argument "--skip-broken" for command "dnf5". Add "--help" for more information about the arguments.
# dnf install --skip-broken filesystem
...
works as expected

Comment 3 Ian Laurie 2023-06-25 01:27:28 UTC
As suggested by my original report, and confirmed by Comment #1, the "bug" is in the man page, not in the operation of dnf.

Comment 4 nucleo 2023-07-13 14:37:49 UTC
Should --skip-broken with upgrade?

# dnf5 --skip-broken upgrade
Unknown argument "--skip-broken" for command "dnf5". Add "--help" for more information about the arguments.
# dnf5 upgrade --skip-broken
Unknown argument "--skip-broken" for command "upgrade". Add "--help" for more information about the arguments.

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

Comment 6 Aoife Moloney 2024-11-08 10:54:05 UTC
This message is a reminder that Fedora Linux 39 is nearing its end of life.
Fedora will stop maintaining and issuing updates for Fedora Linux 39 on 2024-11-26.
It is Fedora's policy to close all bug reports from releases that are no longer
maintained. At that time this bug will be closed as EOL if it remains open with a
'version' of '39'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, change the 'version' 
to a later Fedora Linux version. Note that the version field may be hidden.
Click the "Show advanced fields" button if you do not see it.

Thank you for reporting this issue and we are sorry that we were not 
able to fix it before Fedora Linux 39 is end of life. If you would still like 
to see this bug fixed and are able to reproduce it against a later version 
of Fedora Linux, you are encouraged to change the 'version' to a later version
prior to this bug being closed.

Comment 7 Aoife Moloney 2024-11-27 21:13:39 UTC
Fedora Linux 39 entered end-of-life (EOL) status on 2024-11-26.

Fedora Linux 39 is no longer maintained, which means that it
will not receive any further security or bug fix updates. As a result we
are closing this bug.

If you can reproduce this bug against a currently maintained version of Fedora Linux
please feel free to reopen this bug against that version. Note that the version
field may be hidden. Click the "Show advanced fields" button if you do not see
the version field.

If you are unable to reopen this bug, please file a new report against an
active release.

Thank you for reporting this bug and we are sorry it could not be fixed.