--- 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