diff --git a/doc/mpdconf.example b/doc/mpdconf.example
index 866832d7f..7f7ad01be 100644
--- a/doc/mpdconf.example
+++ b/doc/mpdconf.example
@@ -382,16 +382,6 @@ input {
 #
 #replaygain			"album"
 #
-# This setting enables or disables ReplayGain limiting.
-# MPD calculates actual amplification based on the ReplayGain tags
-# and replaygain_preamp / replaygain_missing_preamp setting.
-# If replaygain_limit is enabled, MPD will use the peak from the
-# ReplayGain tags to minimize clipping.  If replaygain_limit is
-# disabled, MPD will allow clipping of some quiet tracks.
-# By default, this setting is enabled.
-#
-#replaygain_limit		"yes"
-#
 ###############################################################################
 
 # Character Encoding ##########################################################
diff --git a/doc/user.rst b/doc/user.rst
index 6dcd66abe..79cfaee42 100644
--- a/doc/user.rst
+++ b/doc/user.rst
@@ -686,6 +686,11 @@ On songs without ReplayGain tags, the setting
 configured, then no ReplayGain is applied to such songs, and they will
 appear too loud.
 
+The setting ``replaygain_limit`` enables or disables ReplayGain
+limiting.  When enabled (the default), MPD will use the peak from the
+ReplayGain tags to minimize clipping; disabling it will allow clipping
+of some quiet tracks.
+
 ReplayGain is usually implemented with a software volume filter (which
 prevents `Bit-perfect playback`_).  To use a hardware mixer, set
 ``replay_gain_handler`` to ``mixer`` in the ``audio_output`` section