Deprecations

While the deprecations here are denoted in C++ they also include bindings versions of the API.

Currently deprecated methods:

Member libdnf5::cli::output::IRepoInfo::get_gpgcheck  () const =0

Use get_pkg_gpgcheck() const

Member libdnf5::ConfigMain::get_errorlevel_option  ()

The option does nothing

Member libdnf5::ConfigMain::get_errorlevel_option  () const

The option does nothing

Member libdnf5::ConfigMain::get_gpgcheck_option  ()

Use get_pkg_gpgcheck_option()

Member libdnf5::ConfigMain::get_gpgcheck_option  () const

Use get_pkg_gpgcheck_option() const

Member libdnf5::ConfigMain::get_metadata_timer_sync_option  ()

The metadata_timer_sync option does nothing

Member libdnf5::ConfigMain::get_metadata_timer_sync_option  () const

The metadata_timer_sync option does nothing

Member libdnf5::ConfigMain::get_strict_option  ()

Use get_skip_broken_option() and get_skip_unavailable_option()

Member libdnf5::ConfigMain::get_strict_option  () const

Use get_skip_broken_option() const and get_skip_unavailable_option() const

Member libdnf5::repo::ConfigRepo::get_gpgcheck_option  ()

Use get_pkg_gpgcheck_option()

Member libdnf5::repo::ConfigRepo::get_gpgcheck_option  () const

Use get_pkg_gpgcheck_option() const

Member libdnf5::repo::RepoSack::update_and_load_enabled_repos  (bool load_system)

Use load_repos() which allows specifying repo type.

📢 Deprecation signaling

  • build-time warnings using [[deprecated]] attribute, see: cppreference

  • run-time warnings on stderr via LIBDNF5_DEPRECATED(msg)

  • deprecated API is marked in documentation using the @deprecated tag

  • deprecations should be publicly announced on mailing list and GitHub

  • deprecations should include guidance on what to use instead

Example:

foo.hpp
/// @deprecated Use baz()
[[deprecated("Use baz()")]]
void foo();
foo.cpp
#include "utils/deprecate.hpp"

void foo() {
    LIBDNF5_DEPRECATED("Use baz()");
    ...
}