doc fixes

TODO

@@ -46,3 +46,7 @@ TODO:
 - possibly figure out how to name albums with credited artist; look at gorky and spiritualized electric mainline
 - when shortening file name then reripping, it rerips since it doesn't know
   the shortened name; see sufjan stevens
+- if a disc output dir is already there, see if it was properly finished;
+  complain if it was, to not overwrite
+- if multiple releases with different artist match the disc id, stop and
+  let user continue by choosing one

morituri/common/musicbrainzngs.py

@@ -75,7 +75,9 @@ class DiscMetadata(object):
 
 def _getMetadata(release, discid):
     """
-    @type  release: L{musicbrainz2.model.Release}
+    @type  release: C{dict}
+    @param release: a release dict as returned in the value for key release
+                    from get_release_by_id
 
     @rtype: L{DiscMetadata} or None
     """