64 lines
2.8 KiB
Diff
64 lines
2.8 KiB
Diff
|
From a74209ff53c9a51293b45434196dff49002c5691 Mon Sep 17 00:00:00 2001
|
||
|
|
From: Evan Goode <mail@evangoo.de>
|
||
|
|
Date: Tue, 30 May 2023 20:48:54 +0000
|
||
|
|
Subject: [PATCH] Document symbols in `dnf history list` output
|
||
|
|
|
||
|
|
This patch adds documentation for the symbols shown in the "Action(s)"
|
||
|
|
and "Altered" columns of `dnf history list`
|
||
|
|
|
||
|
|
The "Action(s)" column abbreviates the names of transaction actions when
|
||
|
|
there was more than one action, e.g. a transaction that both installs
|
||
|
|
and upgrades packages would be displayed as "I, U".
|
||
|
|
|
||
|
|
The "Altered" column prints some extra symbols when something unusual
|
||
|
|
happened with the transaction, like if any warnings were printed or if
|
||
|
|
it completed with a non-zero status.
|
||
|
|
|
||
|
|
Some language was taken from the yum man pages:
|
||
|
|
https://github.com/rpm-software-management/yum/blob/master/docs/yum.8.
|
||
|
|
It appears we no longer use the "P" or "s" symbols.
|
||
|
|
|
||
|
|
Resolves https://bugzilla.redhat.com/show_bug.cgi?id=2172067
|
||
|
|
(RhBug:2172067)
|
||
|
|
|
||
|
|
= changelog =
|
||
|
|
msg: Document the symbols in the output of `dnf history list`
|
||
|
|
type: bugfix
|
||
|
|
resolves: https://bugzilla.redhat.com/show_bug.cgi?id=2172067
|
||
|
|
---
|
||
|
|
doc/command_ref.rst | 18 ++++++++++++++++++
|
||
|
|
1 file changed, 18 insertions(+)
|
||
|
|
|
||
|
|
diff --git a/doc/command_ref.rst b/doc/command_ref.rst
|
||
|
|
index 7279b3a4..f8149e86 100644
|
||
|
|
--- a/doc/command_ref.rst
|
||
|
|
+++ b/doc/command_ref.rst
|
||
|
|
@@ -701,6 +701,24 @@ transactions and act according to this information (assuming the
|
||
|
|
which specifies a transaction by a package which it manipulated. When no
|
||
|
|
transaction is specified, list all known transactions.
|
||
|
|
|
||
|
|
+ The "Action(s)" column lists each type of action taken in the transaction. The possible values are:
|
||
|
|
+
|
||
|
|
+ * Install (I): a new package was installed on the system
|
||
|
|
+ * Downgrade (D): an older version of a package replaced the previously-installed version
|
||
|
|
+ * Obsolete (O): an obsolete package was replaced by a new package
|
||
|
|
+ * Upgrade (U): a newer version of the package replaced the previously-installed version
|
||
|
|
+ * Remove (E): a package was removed from the system
|
||
|
|
+ * Reinstall (R): a package was reinstalled with the same version
|
||
|
|
+ * Reason change (C): a package was kept in the system but its reason for being installed changed
|
||
|
|
+
|
||
|
|
+ The "Altered" column lists the number of actions taken in each transaction, possibly followed by one or two the following symbols:
|
||
|
|
+
|
||
|
|
+ * ``>``: The RPM database was changed, outside DNF, after the transaction
|
||
|
|
+ * ``<``: The RPM database was changed, outside DNF, before the transaction
|
||
|
|
+ * ``*``: The transaction aborted before completion
|
||
|
|
+ * ``#``: The transaction completed, but with a non-zero status
|
||
|
|
+ * ``E``: The transaction completed successfully, but had warning/error output
|
||
|
|
+
|
||
|
|
``--reverse``
|
||
|
|
The order of ``history list`` output is printed in reverse order.
|
||
|
|
|
||
|
|
--
|
||
|
|
2.40.1
|
||
|
|
|