diff --git a/doc/jemalloc.xml.in b/doc/jemalloc.xml.in
index fe322e1d..4acc2123 100644
--- a/doc/jemalloc.xml.in
+++ b/doc/jemalloc.xml.in
@@ -992,6 +992,24 @@ mallctl("arena." STRINGIFY(MALLCTL_ARENAS_ALL) ".decay",
number of CPUs, or one if there is a single CPU.
+
+
+ opt.oversize_threshold
+ (size_t)
+ r-
+
+ The threshold in bytes of which requests are considered
+ oversize. Allocation requests with greater sizes are fulfilled from a
+ dedicated arena (automatically managed, however not within
+ narenas), in order to reduce fragmentation by not
+ mixing huge allocations with small ones. In addition, the reserved
+ special arena may have its own default decay settings. Note that
+ requests with arena index specified via
+ MALLOCX_ARENA, or threads associated with explicit
+ arenas will not be considered. The default threshold is 8MiB. Values
+ not within large size classes disables this feature.
+
+
opt.percpu_arena
@@ -1013,7 +1031,7 @@ mallctl("arena." STRINGIFY(MALLCTL_ARENAS_ALL) ".decay",
opt.background_thread
- (const bool)
+ (bool)
r-Internal background worker threads enabled/disabled.
@@ -1028,7 +1046,7 @@ mallctl("arena." STRINGIFY(MALLCTL_ARENAS_ALL) ".decay",
opt.max_background_threads
- (const size_t)
+ (size_t)
r-Maximum number of background threads that will be created
@@ -1059,7 +1077,11 @@ mallctl("arena." STRINGIFY(MALLCTL_ARENAS_ALL) ".decay",
linkend="arena.i.dirty_decay_ms">arena.<i>.dirty_decay_ms
for related dynamic control options. See opt.muzzy_decay_ms
- for a description of muzzy pages.
+ for a description of muzzy pages.for a description of muzzy pages. Note
+ that when the oversize_threshold
+ feature is enabled, the arenas reserved for oversize requests may have
+ its own default decay settings.