richardphibel / rpms / libdnf

Forked from rpms/libdnf 2 years ago
Clone
2d633e
From 44d75a36d7c8a933119e5b63f180a8c23715ec51 Mon Sep 17 00:00:00 2001
2d633e
From: Jaroslav Rohel <jrohel@redhat.com>
2d633e
Date: Mon, 28 Mar 2022 07:51:45 +0200
2d633e
Subject: [PATCH] context: Fix doc dnf_context_install/remove/update/distrosync
2d633e
2d633e
Functions do not support groups - only packages are supported.
2d633e
2d633e
The `dnf_context_remove` function marks all matching packages for removal
2d633e
- not just the oldest one.
2d633e
---
2d633e
 libdnf/dnf-context.cpp | 10 +++++-----
2d633e
 1 file changed, 5 insertions(+), 5 deletions(-)
2d633e
2d633e
diff --git a/libdnf/dnf-context.cpp b/libdnf/dnf-context.cpp
2d633e
index 4b055f03..fe005430 100644
2d633e
--- a/libdnf/dnf-context.cpp
2d633e
+++ b/libdnf/dnf-context.cpp
2d633e
@@ -2379,7 +2379,7 @@ dnf_context_run(DnfContext *context, GCancellable *cancellable, GError **error)
2d633e
 /**
2d633e
  * dnf_context_install:
2d633e
  * @context: a #DnfContext instance.
2d633e
- * @name: A package or group name, e.g. "firefox" or "@gnome-desktop"
2d633e
+ * @name: A package specification (NEVRA forms, provide, file provide, globs supported) e.g. "firefox"
2d633e
  * @error: A #GError or %NULL
2d633e
  *
2d633e
  * Finds a remote package and marks it to be installed.
2d633e
@@ -2422,12 +2422,12 @@ dnf_context_install(DnfContext *context, const gchar *name, GError **error) try
2d633e
 /**
2d633e
  * dnf_context_remove:
2d633e
  * @context: a #DnfContext instance.
2d633e
- * @name: A package or group name, e.g. "firefox" or "@gnome-desktop"
2d633e
+ * @name: A package specification (NEVRA forms, provide, file provide, globs supported) e.g. "firefox"
2d633e
  * @error: A #GError or %NULL
2d633e
  *
2d633e
  * Finds an installed package and marks it to be removed.
2d633e
  *
2d633e
- * If multiple packages are available then only the oldest package is removed.
2d633e
+ * If multiple packages are available, all of them will be removed.
2d633e
  *
2d633e
  * Returns: %TRUE for success, %FALSE otherwise
2d633e
  *
2d633e
@@ -2470,7 +2470,7 @@ dnf_context_remove(DnfContext *context, const gchar *name, GError **error) try
2d633e
 /**
2d633e
  * dnf_context_update:
2d633e
  * @context: a #DnfContext instance.
2d633e
- * @name: A package or group name, e.g. "firefox" or "@gnome-desktop"
2d633e
+ * @name: A package specification (NEVRA forms, provide, file provide, globs supported) e.g. "firefox"
2d633e
  * @error: A #GError or %NULL
2d633e
  *
2d633e
  * Finds an installed and remote package and marks it to be updated.
2d633e
@@ -2548,7 +2548,7 @@ dnf_context_update_all (DnfContext  *context,
2d633e
 /**
2d633e
  * dnf_context_distrosync:
2d633e
  * @context: a #DnfContext instance.
2d633e
- * @name: A package or group name, e.g. "firefox" or "@gnome-desktop"
2d633e
+ * @name: A package specification (NEVRA forms, provide, file provide, globs supported) e.g. "firefox"
2d633e
  * @error: A #GError or %NULL
2d633e
  *
2d633e
  * Finds an installed and remote package and marks it to be synchronized with remote version.
2d633e
-- 
2d633e
2.36.1
2d633e