diff --git a/config-dist.php b/config-dist.php
index e74d2eb477c..e22d246d37d 100644
--- a/config-dist.php
+++ b/config-dist.php
@@ -111,9 +111,11 @@ $CFG->directorypermissions = 02777;
 //=========================================================================
 // A very few webhosts use /admin as a special URL for you to access a
 // control panel or something.  Unfortunately this conflicts with the
-// standard location for the Moodle admin pages.  You can fix this by
-// renaming the admin directory in your installation, and putting that
-// new name here.  eg "moodleadmin".  This will fix admin links in Moodle.
+// standard location for the Moodle admin pages.  You can work around this
+// by renaming the admin directory in your installation, and putting that
+// new name here.  eg "moodleadmin".  This should fix all admin links in Moodle.
+// After any change you need to visit your new admin directory
+// and purge all caches.
 
 $CFG->admin = 'admin';