diff --git a/mopidy/backends/__init__.py b/mopidy/backends/__init__.py index 9a591894..e800f6b2 100644 --- a/mopidy/backends/__init__.py +++ b/mopidy/backends/__init__.py @@ -256,7 +256,14 @@ class BasePlaybackController(object): @property def next_track(self): - """The next :class:`mopidy.models.Track` in the playlist.""" + """ + The next :class:`mopidy.models.Track` in the playlist. + + For normal playback this is the next track in the playlist. If repeat + is enabled the next track can loop around the playlist. When random is + enabled this should be a random track, all tracks should be played once + before the list repeats. + """ if self.current_track is None: return None try: @@ -278,7 +285,12 @@ class BasePlaybackController(object): @property def previous_track(self): - """The previous :class:`mopidy.models.Track` in the playlist.""" + """ + The previous :class:`mopidy.models.Track` in the playlist. + + For normal playback this is the next track in the playlist. If random + and/or consume is enabled it should return the current track instead. + """ if self.current_track is None: return None try: