diff options
Diffstat (limited to '')
-rw-r--r-- | src/DatabasePlugin.hxx | 9 |
1 files changed, 8 insertions, 1 deletions
diff --git a/src/DatabasePlugin.hxx b/src/DatabasePlugin.hxx index 37df7f654..a175b3cd9 100644 --- a/src/DatabasePlugin.hxx +++ b/src/DatabasePlugin.hxx @@ -85,7 +85,8 @@ public: virtual void Close() {} /** - * Look up a song (including tag data) in the database. + * Look up a song (including tag data) in the database. When + * you don't need this anymore, call ReturnSong(). * * @param uri_utf8 the URI of the song within the music * directory (UTF-8) @@ -94,6 +95,12 @@ public: GError **error_r) const = 0; /** + * Mark the song object as "unused". Call this on objects + * returned by GetSong(). + */ + virtual void ReturnSong(struct song *song) const = 0; + + /** * Visit the selected entities. */ virtual bool Visit(const DatabaseSelection &selection, |