--- a/src/upmpdcli.conf-dist
+++ b/src/upmpdcli.conf-dist
@@ -264,16 +264,28 @@
 
 # <var name="radiolist" type="fn"><brief>Path to an external file with radio
 # definitions.</brief><descr>Radio stations can be defined at the end of
-# the the main file, or in a separate one (or both). Using an external file
+# the the main file, or in an external file (or both). Using an external file
 # can ease distribution to multiple machines. Either way, each radio
-# station is defined as a section with a name beginning with "radio",
-# containing an URL parameter, and an optional icon URL. See details
-# further in the manual. Example:
+# station is defined as a section with a name beginning with 'radio',
+# containing a mandatory URL parameter, and optional values. The part of
+# the name after 'radio' will be the displayed radio name (as album title).
+#
+# - artUrl: an optional static radio icon URL.
+# - artScript: an optional script to retrieve an image for the current title
+# - metaScript: an optional script to retrieve metadata for the current
+#   title.
+#
+# See the xref:radio-definitions[section about radio station definitions]
+# for details about the scripts.
+#
+# Example:
+#
 # ----
 #     [radio My Radio]
 #     url = http://some.host/some/path.pls
 #     artUrl = http://some.host/icon/path.png
 #     artScript = /path/to/script/dynamic-art-getter
+#     metaScript = /path/to/script/metadata-getter
 # ----
 # </descr></var>
 #radiolist = /path/to/my/radio/list
@@ -404,12 +416,12 @@
 #scripts_dir = /usr/share/upmpdcli/src_scripts
 
 # Initial / default List of radios borrowed from misc sources. Edit to taste
+# See 'radiolist' above for a description of the entries.
 #
-# Maybe this should be XML, but it's not. The section markers are the radio
-# names, and then there are two possible entries:
-#  url (mandatory) points to the radio playlist or stream
-#  artUrl (optional) points to the radio icon
-
+# The section markers are the radio names. The definitions must be at the
+# end of the file because a section definition extends to the EOF and would
+# hide any parameters found inside which is not one of the radio
+# attributes.
 [radio FIP autour du rock]
 url = http://direct.fipradio.fr/live/fip-webradio1.mp3
 artUrl = http://www.fipradio.fr/sites/all/themes/custom/fip/img/logo_fip_header.png