Add docs for history --contains-pkgs=.. option

Also enhances description of `group` `--contains-pkgs=..` option and history command changes.
rpm-software-management · Jan 3, 2025 · 9cfa03d · 9cfa03d
1 parent 457d22a
commit 9cfa03d
Show file tree

Hide file tree

Showing 3 changed files with 7 additions and 1 deletion.
diff --git a/doc/changes_from_dnf4.7.rst b/doc/changes_from_dnf4.7.rst
@@ -201,6 +201,8 @@ Changes to individual commands
   * Dropped. The functionality is replaced by the ``--help`` option.
 
 ``history``
+  * Subcommands are now mandatory: ``dnf history`` has to be now ``dnf5 history list``.
+  * The ``history`` commands now only accept transaction ID arguments; to filter by packages, use the ``--contains-pkgs=PACKAGE_NAME,...`` option, available for ``list`` and ``info``.
   * ``undo`` subcommand now accepts ``--ignore-extras`` and ``--ignore-installed`` like original ``history replay`` command.
   * ``store`` subcommand now creates a directory with transaction JSON file instead of a single transaction JSON file directly.
   * ``store`` subcommand's ``--output`` option now accepts a directory path instead of a file. The default is ``./transaction``.

diff --git a/doc/commands/group.8.rst b/doc/commands/group.8.rst
@@ -98,7 +98,7 @@ Options for ``list`` and ``info``
 ``--hidden``
     | Show also hidden groups.
 
-``--contains-pkgs``
+``--contains-pkgs=PACKAGE_NAME,...``
     | Show only groups containing packages with specified names. List option, supports globs.
 
 

diff --git a/doc/commands/history.8.rst b/doc/commands/history.8.rst
@@ -69,6 +69,10 @@ Options for ``list`` and ``info``
 ``--reverse``
     | Reverse the order of transactions in the output.
 
+``--contains-pkgs=PACKAGE_NAME,...``
+    | Show only transactions containing packages with specified names.
+    | This is a list option. Globs are supported.
+
 
 Options for ``undo``, ``rollback`` and ``redo``
 ===============================================