Document Album.items() / LibModel.items() conflict

Closes: beetbox#4404
arsaboo · Jul 12, 2022 · 1cde938 · 1cde938
1 parent 7209c5f
commit 1cde938
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 0 deletions.
diff --git a/beets/library.py b/beets/library.py
@@ -1145,6 +1145,9 @@ def _getters(cls):
     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`.
         """
         return self._db.items(dbcore.MatchQuery('album_id', self.id))
 

diff --git a/docs/dev/library.rst b/docs/dev/library.rst
@@ -99,6 +99,10 @@ synchronized (via load or store) with the database.
 
     .. automethod:: items
 
+    .. note::
+       The :py:meth:`Album.items` method is not inherited from
+       :py:meth:`LibModel.items` for historical reasons.
+
     .. automethod:: get
 
 Item
@@ -207,6 +211,8 @@ metadata field.
 
     .. automethod:: item_dir
 
+    .. automethod:: items
+
     Albums extend the normal model interface to also forward changes to their
     items: