From 1727b697a0d8a88ca019ace74a1678832cdb7b81 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?= Date: Wed, 3 Apr 2024 19:05:34 +0300 Subject: [PATCH] =?UTF-8?q?mdbx-doc:=20=D1=83=D1=81=D1=82=D1=80=D0=B0?= =?UTF-8?q?=D0=BD=D0=B5=D0=BD=D0=B8=D0=B5=20=D0=BE=D1=82=D0=BB=D0=BE=D0=B6?= =?UTF-8?q?=D0=B5=D0=BD=D0=BD=D1=8B=D1=85=20=D0=BD=D0=B5=D0=B4=D0=BE=D1=80?= =?UTF-8?q?=D0=B0=D0=B1=D0=BE=D1=82=D0=BE=D0=BA=20=D0=B2=20=D0=B4=D0=BE?= =?UTF-8?q?=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D1=86=D0=B8=D0=B8.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- mdbx.h++ | 4 +++- src/options.h | 8 +++++--- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/mdbx.h++ b/mdbx.h++ index 884fb216..5bc42809 100644 --- a/mdbx.h++ +++ b/mdbx.h++ @@ -354,7 +354,7 @@ static MDBX_CXX20_CONSTEXPR void *memcpy(void *dest, const void *src, static MDBX_CXX20_CONSTEXPR int memcmp(const void *a, const void *b, size_t bytes) noexcept; -/// \brief Legacy default allocator +/// \brief Legacy allocator /// but it is recommended to use \ref polymorphic_allocator. using legacy_allocator = ::std::string::allocator_type; @@ -3681,6 +3681,8 @@ public: struct LIBMDBX_API_TYPE operate_options { /// \copydoc MDBX_NOTLS bool orphan_read_transactions{false}; + /// \brief Разрешает вложенные транзакции ценой отключения + /// \ref MDBX_WRITEMAP и увеличением накладных расходов. bool nested_write_transactions{false}; /// \copydoc MDBX_EXCLUSIVE bool exclusive{false}; diff --git a/src/options.h b/src/options.h index 21dd57bc..73d892af 100644 --- a/src/options.h +++ b/src/options.h @@ -147,7 +147,7 @@ #error MDBX_DPL_PREALLOC_FOR_RADIXSORT must be defined as 0 or 1 #endif /* MDBX_DPL_PREALLOC_FOR_RADIXSORT */ -/** Controls dirty pages tracking, spilling and persisting in MDBX_WRITEMAP +/** Controls dirty pages tracking, spilling and persisting in `MDBX_WRITEMAP` * mode. 0/OFF = Don't track dirty pages at all, don't spill ones, and use * msync() to persist data. This is by-default on Linux and other systems where * kernel provides properly LRU tracking and effective flushing on-demand. 1/ON @@ -164,14 +164,16 @@ #error MDBX_AVOID_MSYNC must be defined as 0 or 1 #endif /* MDBX_AVOID_MSYNC */ -/** FIXME */ +/** Управляет механизмом поддержки разреженных наборов DBI-хендлов для снижения + * накладных расходов при запуске и обработке транзакций. */ #ifndef MDBX_ENABLE_DBI_SPARSE #define MDBX_ENABLE_DBI_SPARSE 1 #elif !(MDBX_ENABLE_DBI_SPARSE == 0 || MDBX_ENABLE_DBI_SPARSE == 1) #error MDBX_ENABLE_DBI_SPARSE must be defined as 0 or 1 #endif /* MDBX_ENABLE_DBI_SPARSE */ -/** FIXME */ +/** Управляет механизмом отложенного освобождения и поддержки пути быстрого + * открытия DBI-хендлов без захвата блокировок. */ #ifndef MDBX_ENABLE_DBI_LOCKFREE #define MDBX_ENABLE_DBI_LOCKFREE 1 #elif !(MDBX_ENABLE_DBI_LOCKFREE == 0 || MDBX_ENABLE_DBI_LOCKFREE == 1)