From bf8fbed2e8f390eecb5299818475eb459a0da077 Mon Sep 17 00:00:00 2001
From: Callum Brown <callum@calcuode.com>
Date: Sun, 21 Aug 2022 14:34:18 +0100
Subject: [PATCH] Clarify Album.items() conflict

---
 beets/library.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/beets/library.py b/beets/library.py
index 7f6669366..1f8a89695 100644
--- a/beets/library.py
+++ b/beets/library.py
@@ -1146,8 +1146,10 @@ class Album(LibModel):
         """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))