diff --git a/docs/reference/config.rst b/docs/reference/config.rst
index 5fcdce3ae..4d3d6fff1 100644
--- a/docs/reference/config.rst
+++ b/docs/reference/config.rst
@@ -571,10 +571,12 @@ default is ``apply``.
 languages
 ~~~~~~~~~
 
-A list of locale names to search for preferred aliases (e.g. ``en jp es``. For example, setting
-this to "en" uses the transliterated artist name "Pyotr Ilyich Tchaikovsky"
+A list of locale names to search for preferred aliases. For example, setting
+this to ``en`` uses the transliterated artist name "Pyotr Ilyich Tchaikovsky"
 instead of the Cyrillic script for the composer's name when tagging from
-MusicBrainz. Defaults to an empty list, meaning that no language is preferred.
+MusicBrainz. You can use a space-separated list of language abbreviations, like 
+``en jp es``, to specify a preference order. Defaults to an empty list, meaning 
+that no language is preferred.
 
 .. _detail: