Be more elaborate in background GC config example

1 files changed, 9 insertions, 2 deletions

diff --git a/docs/rabbitmq.config.example b/docs/rabbitmq.config.example
index 5feb2430e9..aaffcab2d8 100644
--- a/docs/rabbitmq.config.example
+++ b/docs/rabbitmq.config.example
@@ -333,11 +333,18 @@
    %%
    %% {queue_index_embed_msgs_below, 4096},
 
-   %% Whether or not to enable background GC.
+   %% Whether or not to enable background periodic GC of all
+   %% Erlang processes in "waiting" state.
+   %%
+   %% Disabling background GC may reduce latency for client operations,
+   %% keeping it enabled may reduce median RAM usage.
    %%
    %% {background_gc_enabled, true},
    %%
-   %% Interval (in milliseconds) at which we run background GC.
+   %% Target (desired) interval (in milliseconds) at which we run background GC.
+   %% The actual interval will vary depending on how long it takes to execute
+   %% the operation (can be higher than this interval). Values less than
+   %% 30000 milliseconds are not recommended.
    %%
    %% {background_gc_target_interval, 60000}