diff --git a/CHANGELOG.md b/CHANGELOG.md index 1c1350b51..3d808b405 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,10 @@ + +# librdkafka v2.11.2 (unreleased) + +## Fixes + +* C++ docs: Clarify ownership of `RdKafka::Conf::dump()` return value (#5166, @aryanrahar) +======= # librdkafka v2.12.0 librdkafka v2.12.0 is a feature release: @@ -19,6 +26,7 @@ librdkafka v2.12.0 is a feature release: + # librdkafka v2.11.1 librdkafka v2.11.1 is a maintenance release: diff --git a/src-cpp/rdkafkacpp.h b/src-cpp/rdkafkacpp.h index 8d8aebabe..af477a1c2 100644 --- a/src-cpp/rdkafkacpp.h +++ b/src-cpp/rdkafkacpp.h @@ -1436,8 +1436,17 @@ class RD_EXPORT Conf { virtual Conf::ConfResult get( SslCertificateVerifyCb *&ssl_cert_verify_cb) const = 0; - /** @brief Dump configuration names and values to list containing - * name,value tuples */ + /** @brief Dump configuration names and values to a list containing + * name,value tuples. + * + * @remark Ownership: The returned std::list is heap-allocated. + * The caller owns the list and must delete it when done, e.g.: + * @code + * std::list *lst = conf->dump(); + * // ... use lst ... + * delete lst; + * @endcode + */ virtual std::list *dump() = 0; /** @brief Use with \p name = \c \"consume_cb\" */