diff --git a/docs/plugins.rst b/docs/plugins.rst
index 9dddce70..16d697fa 100644
--- a/docs/plugins.rst
+++ b/docs/plugins.rst
@@ -20,12 +20,12 @@ Alternatively, another method is to import them and add them to the list::
     from package import myplugin
     PLUGINS = [myplugin,]
 
-If your plugins are not in an importable path, you can specify a ``PLUGIN_PATH``
-in the settings. ``PLUGIN_PATH`` can be an absolute path or a path relative to
-the settings file::
+If your plugins are not in an importable path, you can specify a list of paths
+via the ``PLUGIN_PATH`` setting. As shown in the following example, paths in
+the ``PLUGIN_PATH`` list can be absolute or relative to the settings file::
 
-    PLUGIN_PATH = ["list", "of", plugins path"]
-    PLUGINS = ["list", "of", "plugins"]
+    PLUGIN_PATH = ["plugins", "/srv/pelican/plugins"]
+    PLUGINS = ["assets", "liquid_tags", "sitemap"]
 
 Where to find plugins
 =====================
diff --git a/pelican/settings.py b/pelican/settings.py
index 7caffa61..ee337386 100644
--- a/pelican/settings.py
+++ b/pelican/settings.py
@@ -144,7 +144,7 @@ def read_settings(path=None, override=None):
                     local_settings[p] = absp
 
         if isinstance(local_settings['PLUGIN_PATH'], six.string_types):
-            logger.warning("Detected misconfiguration with %s setting ""(must be a list)" % 'PLUGIN_PATH')
+            logger.warning("Defining %s setting as string has been deprecated (should be a list)" % 'PLUGIN_PATH')
             local_settings['PLUGIN_PATH'] = [local_settings['PLUGIN_PATH']]
         else:
             if 'PLUGIN_PATH' in local_settings and local_settings['PLUGIN_PATH'] is not None: