docs for partial album matches (#260)

docs/changelog.rst

@@ -17,6 +17,9 @@ Changelog
   fingerprinting service. This replaces the old ``lastid`` plugin, which used
   Last.fm fingerprinting and is now deprecated. Fingerprinting with this library
   should be faster and more reliable.
+* The importer can now perform **partial matches**. This means that, if you're
+  missing a few tracks from an album, beets can still tag the remaining tracks
+  as a single album. (Thanks to `Simon Chopin`_.)
 * The new :doc:`/plugins/lastgenre` automatically assigns genres to imported
   albums and items based on Last.fm tags and an internal whitelist. (Thanks to
   `KraYmer`_.)
@@ -46,6 +49,7 @@ Changelog
 .. _python-musicbrainz-ngs: https://github.com/alastair/python-musicbrainz-ngs
 .. _acoustid: http://acoustid.org/
 .. _Peter Brunner: https://github.com/Lugoues
+.. _Simon Chopin: https://github.com/laarmen
 
 1.0b10 (September 22, 2011)
 ---------------------------

docs/guides/tagger.rst

@@ -218,15 +218,14 @@ If you're having trouble tagging a particular album with beets, you might want t
   site to make sure it's cataloged there. If not, anyone can edit
   MusicBrainz---so consider adding the data yourself.
 
-* Beets won't show you possibilities from MusicBrainz with a mismatched number
-  of tracks. That is, if your album is missing tracks or has additional tracks
-  beyond what the MB database reflects, then you'll never see a match for that
-  album. (This is because beets wouldn't know how to apply metadata to your
-  files in this case.) `Issue #33`_ proposes adding a system that automatically
-  detects and reports this situation.
+* Beets won't show you possibilities from MusicBrainz that have *fewer* tracks
+  than the current album. In other words, if you have extra tracks that aren't
+  included on the release, that candidate won't be displayed. (The tagger
+  should, on the other hand, show you candidates that have *more* tracks than
+  you do in the case that you're missing some of the album's songs. Beets will
+  warn you when any candidate is a partial match.)
 
 .. _the MusicBrainz database: http://musicbrainz.org/
-.. _Issue #33: http://code.google.com/p/beets/issues/detail?id=33
 
 If neither of these situations apply and you're still having trouble tagging
 something, please `file a bug report`_.

docs/plugins/lastgenre.rst

@@ -55,3 +55,6 @@ pyyaml``). Then set the ``canonical`` configuration value::
 Leaving this value blank will use a built-in canonicalization tree. You can also
 set it to a path, just like the ``whitelist`` config value, to use your own
 tree.
+
+.. _YAML: http://www.yaml.org/
+.. _pyyaml: http://pyyaml.org/