Clarify Album.items() conflict

arsaboo · Aug 21, 2022 · bf8fbed · bf8fbed
1 parent 1cde938
commit bf8fbed
Showing 1 changed file with 4 additions and 2 deletions.
diff --git a/beets/library.py b/beets/library.py
@@ -1146,8 +1146,10 @@ def items(self):
         """Return an iterable over the items associated with this
         album.
 
-        This method predates the :meth:`LibModel.items` method inherited
-        from :meth:`beets.dbcore.Model.items`.
+        This method conflicts with :meth:`LibModel.items`, which is
+        inherited from :meth:`beets.dbcore.Model.items`.
+        Since :meth:`Album.items` predates these methods, and is
+        likely to be used by plugins, we keep this interface as-is.
         """
         return self._db.items(dbcore.MatchQuery('album_id', self.id))