From 7b2eee91afde2ba490279850981d3681c2b0b14e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=9B=D0=B5=D0=BE=D0=BD=D0=B8=D0=B4=20=D0=AE=D1=80=D1=8C?=
 =?UTF-8?q?=D0=B5=D0=B2=20=28Leonid=20Yuriev=29?= <leo@yuriev.ru>
Date: Fri, 4 Nov 2022 21:06:24 +0300
Subject: [PATCH] =?UTF-8?q?mdbx:=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB?=
 =?UTF-8?q?=D0=B5=D0=BD=D0=BE=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8?=
 =?UTF-8?q?=D0=B5=20=D0=BF=D0=B0=D1=80=D0=B0=D0=BC=D0=B5=D1=82=D1=80=D0=BE?=
 =?UTF-8?q?=D0=B2=20`MDBX=5Fdebug=5Ffunc`=20=D0=B8=20`MDBX=5Fdebug=5Ffunc`?=
 =?UTF-8?q?=20(backport).?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 mdbx.h | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/mdbx.h b/mdbx.h
index 360ed93a..c30c4897 100644
--- a/mdbx.h
+++ b/mdbx.h
@@ -958,8 +958,16 @@ DEFINE_ENUM_FLAG_OPERATORS(MDBX_debug_flags_t)
  * called before printing the message and aborting.
  * \see mdbx_setup_debug()
  *
- * \param [in] env  An environment handle returned by \ref mdbx_env_create().
- * \param [in] msg  The assertion message, not including newline. */
+ * \param [in] loglevel  The severity of message.
+ * \param [in] function  The function name which emits message,
+ *                       may be NULL.
+ * \param [in] line      The source code line number which emits message,
+ *                       may be zero.
+ * \param [in] fmt       The printf-like format string with message.
+ * \param [in] args      The variable argument list respectively for the
+ *                       format-message string passed by `fmt` argument.
+ *                       Maybe NULL or invalid if the format-message string
+ *                       don't contain `%`-specification of arguments. */
 typedef void MDBX_debug_func(MDBX_log_level_t loglevel, const char *function,
                              int line, const char *fmt,
                              va_list args) MDBX_CXX17_NOEXCEPT;
@@ -978,8 +986,12 @@ LIBMDBX_API int mdbx_setup_debug(MDBX_log_level_t log_level,
  * called before printing the message and aborting.
  * \see mdbx_env_set_assert()
  *
- * \param [in] env  An environment handle returned by mdbx_env_create().
- * \param [in] msg  The assertion message, not including newline. */
+ * \param [in] env       An environment handle.
+ * \param [in] msg       The assertion message, not including newline.
+ * \param [in] function  The function name where the assertion check failed,
+ *                       may be NULL.
+ * \param [in] line      The line number in the source file
+ *                       where the assertion check failed, may be zero. */
 typedef void MDBX_assert_func(const MDBX_env *env, const char *msg,
                               const char *function,
                               unsigned line) MDBX_CXX17_NOEXCEPT;