diff --git a/mdbx.h b/mdbx.h
index cc422981..65940cff 100644
--- a/mdbx.h
+++ b/mdbx.h
@@ -4031,7 +4031,7 @@ LIBMDBX_API int mdbx_txn_renew(MDBX_txn *txn);
 /** \brief The fours integers markers (aka "canary") associated with the
  * environment.
  * \ingroup c_crud
- * \see mdbx_canary_set()
+ * \see mdbx_canary_put()
  * \see mdbx_canary_get()
  *
  * The `x`, `y` and `z` values could be set by \ref mdbx_canary_put(), while the
@@ -4069,10 +4069,10 @@ LIBMDBX_API int mdbx_canary_put(MDBX_txn *txn, const MDBX_canary *canary);
 /** \brief Returns fours integers markers (aka "canary") associated with the
  * environment.
  * \ingroup c_crud
- * \see mdbx_canary_set()
+ * \see mdbx_canary_put()
  *
  * \param [in] txn     A transaction handle returned by \ref mdbx_txn_begin().
- * \param [in] canary  The address of an MDBX_canary structure where the
+ * \param [in] canary  The address of an \ref MDBX_canary structure where the
  *                     information will be copied.
  *
  * \returns A non-zero error value on failure and 0 on success. */
diff --git a/mdbx.h++ b/mdbx.h++
index 1e996d8a..54d30088 100644
--- a/mdbx.h++
+++ b/mdbx.h++
@@ -3002,7 +3002,8 @@ public:
 
   /// \brief Database geometry for size management.
   /// \see env_managed::create_parameters
-  /// \see env_managed::env_managed(const ::std::string &pathname, const create_parameters &, const operate_parameters &, bool accede)
+  /// \see env_managed::env_managed(const ::std::string &pathname, const
+  /// create_parameters &, const operate_parameters &, bool accede)
 
   struct LIBMDBX_API_TYPE geometry {
     enum : int64_t {
@@ -3662,7 +3663,8 @@ public:
                        bool accede = true);
 
   /// \brief Additional parameters for creating a new database.
-  /// \see env_managed(const ::std::string &pathname, const create_parameters &, const operate_parameters &, bool accede)
+  /// \see env_managed(const ::std::string &pathname, const create_parameters &,
+  /// const operate_parameters &, bool accede)
   struct create_parameters {
     env::geometry geometry;
     mdbx_mode_t file_mode_bits{0640};