From e3e81756abf9ba97b33e08682ffdea95968b3fa0 Mon Sep 17 00:00:00 2001
From: Marek Blaha <mblaha@redhat.com>
Date: Tue, 13 Feb 2024 15:00:00 +0100
Subject: [PATCH] versionlock: Tag new API with @since 5.1.13

---
 include/libdnf5/rpm/package_query.hpp      | 1 +
 include/libdnf5/rpm/package_sack.hpp       | 6 ++++++
 include/libdnf5/rpm/versionlock_config.hpp | 3 +++
 3 files changed, 10 insertions(+)

diff --git a/include/libdnf5/rpm/package_query.hpp b/include/libdnf5/rpm/package_query.hpp
index 8e187593d..d49e87465 100644
--- a/include/libdnf5/rpm/package_query.hpp
+++ b/include/libdnf5/rpm/package_query.hpp
@@ -718,6 +718,7 @@ class PackageQuery : public PackageSet {
     /// Filter out versionlock excluded packages.
     ///
     /// The packages versions excluded by versionlock are removed from the query.
+    /// @since 5.1.13
     void filter_versionlock();
 
 private:
diff --git a/include/libdnf5/rpm/package_sack.hpp b/include/libdnf5/rpm/package_sack.hpp
index 1b1cb8ef9..a371dc322 100644
--- a/include/libdnf5/rpm/package_sack.hpp
+++ b/include/libdnf5/rpm/package_sack.hpp
@@ -148,24 +148,30 @@ class PackageSack {
 
 
     /// Returns versionlock configuration
+    /// @since 5.1.13
     VersionlockConfig get_versionlock_config() const;
 
     /// Returns versionlock excluded package set
+    /// @since 5.1.13
     const PackageSet get_versionlock_excludes();
 
     /// Add package set to versionlock excluded packages
     /// @param excludes: packages to add to excludes
+    /// @since 5.1.13
     void add_versionlock_excludes(const PackageSet & excludes);
 
     /// Remove package set from versionlock excluded packages
     /// @param excludes: packages to remove from excludes
+    /// @since 5.1.13
     void remove_versionlock_excludes(const PackageSet & excludes);
 
     /// Resets versionlock excluded packages to a new value
     /// @param excludes: packages to exclude
+    /// @since 5.1.13
     void set_versionlock_excludes(const PackageSet & excludes);
 
     /// Clear versionlock excluded packages
+    /// @since 5.1.13
     void clear_versionlock_excludes();
 
     rpm::Package get_running_kernel();
diff --git a/include/libdnf5/rpm/versionlock_config.hpp b/include/libdnf5/rpm/versionlock_config.hpp
index f46af549c..f20807948 100644
--- a/include/libdnf5/rpm/versionlock_config.hpp
+++ b/include/libdnf5/rpm/versionlock_config.hpp
@@ -34,6 +34,7 @@ namespace libdnf5::rpm {
 /// Each condition consist of three parts: key, comparison operator, and value.
 /// Key can be one of "epoch", "evr", "arch".
 /// Supported comparison operators are "<", "<=", "=", ">=", ">", "!=".
+/// @since 5.1.13
 class VersionlockCondition {
 public:
     enum class Keys { EPOCH, EVR, ARCH };
@@ -78,6 +79,7 @@ class VersionlockCondition {
 /// One versionlock configuration file entry. It consists of the
 /// package name and a set of conditions. All conditions must be true
 /// for package version to get locked.
+/// @since 5.1.13
 class VersionlockPackage {
 public:
     /// Creates an instance of `VersionlockPackage` class specifying the
@@ -119,6 +121,7 @@ class VersionlockPackage {
 
 
 /// Class contains parsed versionlock configuration file.
+/// @since 5.1.13
 class VersionlockConfig {
 public:
     /// Get list of configured versionlock entries.