From 1b2816d8bb4ea1f7ecafc9a5928ff3cf8fbb41fa Mon Sep 17 00:00:00 2001 From: Fellipe Henrique Date: Wed, 18 Feb 2026 14:23:33 -0300 Subject: [PATCH] Documenting dnf updateinfo subcommands Subcommands of `dnf updateinfo` are not documented in dnf, this commit include the necessary documentation. Resolves: RHEL-72476 Signed-off-by: Fellipe Henrique --- 0050-change-updateinfo-documentation.patch | 91 ++++++++++++++++++++++ dnf.spec | 7 +- 2 files changed, 97 insertions(+), 1 deletion(-) create mode 100644 0050-change-updateinfo-documentation.patch diff --git a/0050-change-updateinfo-documentation.patch b/0050-change-updateinfo-documentation.patch new file mode 100644 index 0000000..1af78aa --- /dev/null +++ b/0050-change-updateinfo-documentation.patch @@ -0,0 +1,91 @@ +commit 661b36e7 +Author: Fellipe Henrique +Date: Fri Aug 14 09:21:24 2026 -0300 + + Documenting dnf updateinfo subcommands + + Subcommands of `dnf updateinfo` are not documented in dnf, this commit include the necessary documentation. + + Signed-off-by: Fellipe Henrique + +diff --git a/doc/command_ref.rst b/doc/command_ref.rst +index fe3af6e9..f6ce7660 100644 +--- a/doc/command_ref.rst ++++ b/doc/command_ref.rst +@@ -1695,14 +1695,23 @@ Updateinfo Command + | Deprecated aliases: ``list-updateinfo``, ``list-security``, ``list-sec``, ``info-updateinfo``, ``info-security``, ``info-sec``, ``summary-updateinfo`` + + ``dnf [options] updateinfo [--summary|--list|--info] [] [...]`` ++ ++``dnf [options] updateinfo summary [] [...]`` ++ ++``dnf [options] updateinfo list [] [...]`` ++ ++``dnf [options] updateinfo info [] [...]`` ++ + Display information about update advisories. + + Depending on the output type, DNF displays just counts of advisory types + (omitted or ``--summary``), list of advisories (``--list``) or detailed +- information (``--info``). The ``-v`` option extends the output. When +- used with ``--info``, the information is even more detailed. When used +- with ``--list``, an additional column with date of the last advisory update +- is added. ++ information (``--info``). The output type may be selected either by passing ++ ``--summary``, ``--list``, or ``--info`` as an option, or by using ++ ``summary``, ``list``, or ``info`` as a subcommand. The ``-v`` option ++ extends the output. When used with ``--info``/``info``, the information is ++ even more detailed. When used with ``--list``/``list``, an additional column ++ with date of the last advisory update is added. + + ```` specifies whether advisories about newer versions of + installed packages (omitted or ``--available``), advisories about equal and +@@ -1721,8 +1730,8 @@ Updateinfo Command + + To print only advisories referencing a CVE or a bugzilla use ``--with-cve`` or + ``--with-bz`` options. When these switches are used also the output +- of the ``--list`` is altered - the ID of the CVE or the bugzilla is printed +- instead of the one of the advisory. ++ of the ``--list``/``list`` is altered - the ID of the CVE or the bugzilla is ++ printed instead of the one of the advisory. + + If given and if neither ID, type (``bugfix``, ``enhancement``, + ``security``/``sec``) nor a package name of an advisory matches +@@ -1730,7 +1739,36 @@ Updateinfo Command + case-sensitive and in the case of advisory IDs and package names, globbing + is supported. + +- Output of the ``--summary`` option is affected by the :ref:`autocheck_running_kernel ` configuration option. ++ Output of the ``--summary``/``summary`` option is affected by the :ref:`autocheck_running_kernel ` configuration option. ++ ++ The following provides details on each subcommand: ++ ++ ``dnf updateinfo summary`` ++ Displays a summary of the number of available advisories grouped by ++ type. This is the default when no subcommand or output type option is ++ given. The output includes counts for each advisory type: New Package ++ notices, Security notices (further broken down by severity: Critical, ++ Important, Moderate, Low), Bugfix notices, and Enhancement notices. ++ ++ ``dnf updateinfo list`` ++ Displays a list of available advisories. Each advisory is printed on a ++ single line with the following columns: the advisory ID, the advisory ++ type and severity (e.g. ``bugfix``, ``Important/Sec.``), and the package ++ NEVRA (Name-Epoch:Version-Release.Architecture). When used with ++ ``--all``, an additional marker at the beginning of each line indicates ++ whether the advisory is installed (``i``) or available (blank). When ++ used with the ``-v`` option, an additional column shows the date of the ++ last advisory update. ++ ++ ``dnf updateinfo info`` ++ Displays detailed information about each available advisory. Each ++ advisory is displayed as a block that includes: the advisory title ++ (as a header), Update ID, Type (bugfix, enhancement, security, ++ newpackage, or unknown), Updated date, associated Bugs (bugzilla ++ references), CVEs, a full Description, and Severity. When used with ++ the ``-v`` option, additional fields are shown: Rights and Files ++ (the RPM filenames related to the advisory). When used with ``--all``, ++ an Installed field (true/false) is also included. + + .. _upgrade_command-label: + diff --git a/dnf.spec b/dnf.spec index a789550..4f40f86 100644 --- a/dnf.spec +++ b/dnf.spec @@ -72,7 +72,7 @@ It supports RPMs, modules and comps groups & environments. Name: dnf Version: 4.20.0 -Release: 27%{?dist} +Release: 28%{?dist} Summary: %{pkg_summary} # For a breakdown of the licensing, see PACKAGE-LICENSING License: GPL-2.0-or-later AND GPL-1.0-only @@ -127,6 +127,7 @@ Patch46: 0046-Generalize-_BoolDefault-to-just-_Default-allow-choic.patch Patch47: 0047-Add-clean-command-lock-demand.patch Patch48: 0048-Configure-demands.clean_command_lock-for-commands-th.patch Patch49: 0049-print-number-of-nevra-unique-packages.patch +Patch50: 0050-change-updateinfo-documentation.patch BuildArch: noarch BuildRequires: cmake @@ -488,6 +489,10 @@ popd # bootc subpackage does not include any files %changelog +* Thu Aug 14 2026 Fellipe Henrique - 4.20.0-28 +- updateinfo: change documentation, adding more information summar, list and info + parameters (RHEL-72476) + * Fri Aug 07 2026 Marek Blaha - 4.20.0-27 - repoinfo: Print number of nevra unique packages (RHEL-78637)