changelog and docs for #597

docs/changelog.rst

@@ -4,6 +4,9 @@ Changelog
 1.3.4 (in development)
 ----------------------
 
+One note for upgraders: the :doc:`/plugins/fetchart` has a new dependency, the
+`requests`_ module.
+
 New stuff:
 
 * Added a :ref:`config-cmd` command to manage your configuration. It can show
@@ -38,6 +41,11 @@ Fixes:
   again to geigerzaehler.
 * Fix a crash when reading WMA files whose boolean-valued fields contain
   strings. Thanks to johtso.
+* :doc:`/plugins/fetchart`: The plugin now sends "beets" as the User-Agent
+  when making scraping requests. This helps resolve some blocked requests. The
+  plugin now also depends on the `requests`_ Python library.
+
+.. _requests: http://www.python-requests.org/
 
 
 1.3.3 (February 26, 2014)

docs/plugins/fetchart.rst

@@ -4,13 +4,20 @@ FetchArt Plugin
 The ``fetchart`` plugin retrieves album art images from various sources on the
 Web and stores them as image files.
 
+To use the plugin, first enable it in your configuration (see
+:ref:`using-plugins`). Then, install the `requests`_ library by typing::
+
+    pip install requests
+
+The plugin uses `requests`_ to fetch album art from the Web.
+
+.. _requests: http://docs.python-requests.org/en/latest/
 
 Fetching Album Art During Import
 --------------------------------
 
-To automatically get album art for every album you import, just enable the
-plugin by putting ``fetchart`` on your config file's ``plugins`` line (see
-:doc:`/plugins/index`).
+When the plugin is enabled, it automatically gets album art for every album
+you import.
 
 By default, beets stores album art image files alongside the music files for an
 album in a file called ``cover.jpg``. To customize the name of this file, use