Hi, Attached is a patch which documents API changes between libmpdclient versions, making it easier to add client support for old versions of libmpdclient.
Regards, Kim Tore Jensen
From bc7951bf857c1d8195eb576a9582ca1c9dbf9118 Mon Sep 17 00:00:00 2001
From: Kim Tore Jensen <k...@incendio.no>
Date: Thu, 27 Aug 2015 13:19:19 +0200
Subject: [PATCH] Document API changes between each libmpdclient version
---
include/mpd/async.h | 2 ++
include/mpd/audio_format.h | 3 +++
include/mpd/connection.h | 9 +++++++++
include/mpd/database.h | 2 ++
include/mpd/directory.h | 2 ++
include/mpd/idle.h | 3 +++
include/mpd/message.h | 30 ++++++++++++++++++++++++++++++
include/mpd/mixer.h | 4 ++++
include/mpd/output.h | 4 ++++
include/mpd/player.h | 18 ++++++++++++++++++
include/mpd/playlist.h | 2 ++
include/mpd/queue.h | 28 ++++++++++++++++++++++++++++
include/mpd/search.h | 6 ++++++
include/mpd/settings.h | 12 ++++++++++++
include/mpd/song.h | 8 ++++++++
include/mpd/status.h | 10 ++++++++++
include/mpd/sticker.h | 20 ++++++++++++++++++++
include/mpd/tag.h | 4 ++++
18 files changed, 167 insertions(+)
diff --git a/include/mpd/async.h b/include/mpd/async.h
index 1400589..9f6d24c 100644
--- a/include/mpd/async.h
+++ b/include/mpd/async.h
@@ -148,6 +148,8 @@ mpd_async_get_fd(const struct mpd_async *async);
*
* @param async the #mpd_async object
* @param keepalive whether TCP keepalives should be enabled
+ *
+ * @since libmpdclient 2.10
*/
void mpd_async_set_keepalive(struct mpd_async *async,
bool keepalive);
diff --git a/include/mpd/audio_format.h b/include/mpd/audio_format.h
index eccb33a..f9d0936 100644
--- a/include/mpd/audio_format.h
+++ b/include/mpd/audio_format.h
@@ -65,6 +65,9 @@ struct mpd_audio_format {
* currently always signed. Supported values are 8, 16, 24,
* 32 and the special values #MPD_SAMPLE_FORMAT_FLOAT,
* #MPD_SAMPLE_FORMAT_DSD.
+ *
+ * @since libmpdclient 2.10 added support for #MPD_SAMPLE_FORMAT_FLOAT and
+ * #MPD_SAMPLE_FORMAT_DSD.
*/
uint8_t bits;
diff --git a/include/mpd/connection.h b/include/mpd/connection.h
index 467e826..e1f1211 100644
--- a/include/mpd/connection.h
+++ b/include/mpd/connection.h
@@ -95,6 +95,9 @@ extern "C" {
* mpd_connection_set_timeout()
* @return a mpd_connection object (which may have failed to connect),
* or NULL on out-of-memory
+ *
+ * @since libmpdclient 2.3 added support for #MPD_HOST, #MPD_PORT and
+ * #MPD_TIMEOUT.
*/
mpd_malloc
struct mpd_connection *
@@ -127,6 +130,8 @@ void mpd_connection_free(struct mpd_connection *connection);
/**
* Returns the settings which were used to connect to the server. May
* be NULL if the settings are not known.
+ *
+ * @since libmpdclient 2.4
*/
const struct mpd_settings *
mpd_connection_get_settings(const struct mpd_connection *connection);
@@ -142,6 +147,8 @@ mpd_connection_get_settings(const struct mpd_connection *connection);
*
* @param connection the connection to MPD
* @param keepalive whether TCP keepalives should be enabled
+ *
+ * @since libmpdclient 2.10
*/
void mpd_connection_set_keepalive(struct mpd_connection *connection,
bool keepalive);
@@ -220,6 +227,8 @@ mpd_connection_get_server_error(const struct mpd_connection *connection);
* command list. Calling this function is only valid in a command
* list response, and if mpd_connection_get_error() returned
* #MPD_ERROR_SERVER.
+ *
+ * @since libmpdclient 2.4
*/
mpd_pure
unsigned
diff --git a/include/mpd/database.h b/include/mpd/database.h
index 2d7090a..c80c50a 100644
--- a/include/mpd/database.h
+++ b/include/mpd/database.h
@@ -95,6 +95,8 @@ mpd_send_list_meta(struct mpd_connection *connection, const char *path);
* @param path the relative path of the song file within the music
* directory or an arbitrary file path starting with file:///
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.9
*/
bool
mpd_send_read_comments(struct mpd_connection *connection, const char *path);
diff --git a/include/mpd/directory.h b/include/mpd/directory.h
index b883e10..1d93ff2 100644
--- a/include/mpd/directory.h
+++ b/include/mpd/directory.h
@@ -84,6 +84,8 @@ mpd_directory_get_path(const struct mpd_directory *directory);
/**
* @return the POSIX UTC time stamp of the last modification, or 0 if
* that is unknown
+ *
+ * @since libmpdclient 2.9
*/
mpd_pure
time_t
diff --git a/include/mpd/idle.h b/include/mpd/idle.h
index c6da7ef..3a1aedf 100644
--- a/include/mpd/idle.h
+++ b/include/mpd/idle.h
@@ -48,6 +48,9 @@ struct mpd_connection;
/**
* This enum contains bit masks for all idle events.
+ *
+ * @since libmpdclient 2.5 added support for #MPD_IDLE_STICKER,
+ * #MPD_IDLE_SUBSCRIPTION and #MPD_IDLE_MESSAGE.
*/
enum mpd_idle {
/** song database has been updated*/
diff --git a/include/mpd/message.h b/include/mpd/message.h
index de9eb5a..645998f 100644
--- a/include/mpd/message.h
+++ b/include/mpd/message.h
@@ -57,6 +57,8 @@ extern "C" {
* @param pair the first pair in this message (name must be "channel")
* @return the new #mpd_entity object, or NULL on error (out of
* memory, or pair name is not "channel")
+ *
+ * @since libmpdclient 2.5
*/
mpd_malloc
struct mpd_message *
@@ -69,18 +71,24 @@ mpd_message_begin(const struct mpd_pair *pair);
* @return true if the pair was parsed and added to the message (or if
* the pair was not understood and ignored), false if this pair is the
* beginning of the next message
+ *
+ * @since libmpdclient 2.5
*/
bool
mpd_message_feed(struct mpd_message *output, const struct mpd_pair *pair);
/**
* Frees a #mpd_message object.
+ *
+ * @since libmpdclient 2.5
*/
void
mpd_message_free(struct mpd_message *message);
/**
* Returns the channel name.
+ *
+ * @since libmpdclient 2.5
*/
mpd_pure
const char *
@@ -88,6 +96,8 @@ mpd_message_get_channel(const struct mpd_message *message);
/**
* Returns the message text.
+ *
+ * @since libmpdclient 2.5
*/
mpd_pure
const char *
@@ -99,6 +109,8 @@ mpd_message_get_text(const struct mpd_message *message);
* @param connection the connection to MPD
* @param channel the channel name
* @return true on success
+ *
+ * @since libmpdclient 2.5
*/
bool
mpd_send_subscribe(struct mpd_connection *connection, const char *channel);
@@ -109,6 +121,8 @@ mpd_send_subscribe(struct mpd_connection *connection, const char *channel);
* @param connection the connection to MPD
* @param channel the channel name
* @return true on success
+ *
+ * @since libmpdclient 2.5
*/
bool
mpd_run_subscribe(struct mpd_connection *connection, const char *channel);
@@ -120,6 +134,8 @@ mpd_run_subscribe(struct mpd_connection *connection, const char *channel);
* @param connection the connection to MPD
* @param channel the channel name
* @return true on success
+ *
+ * @since libmpdclient 2.5
*/
bool
mpd_send_unsubscribe(struct mpd_connection *connection, const char *channel);
@@ -130,6 +146,8 @@ mpd_send_unsubscribe(struct mpd_connection *connection, const char *channel);
* @param connection the connection to MPD
* @param channel the channel name
* @return true on success
+ *
+ * @since libmpdclient 2.5
*/
bool
mpd_run_unsubscribe(struct mpd_connection *connection, const char *channel);
@@ -141,6 +159,8 @@ mpd_run_unsubscribe(struct mpd_connection *connection, const char *channel);
* @param channel the channel name
* @param text the message text
* @return true on success
+ *
+ * @since libmpdclient 2.5
*/
bool
mpd_send_send_message(struct mpd_connection *connection,
@@ -153,6 +173,8 @@ mpd_send_send_message(struct mpd_connection *connection,
* @param channel the channel name
* @param text the message text
* @return true on success
+ *
+ * @since libmpdclient 2.5
*/
bool
mpd_run_send_message(struct mpd_connection *connection,
@@ -163,6 +185,8 @@ mpd_run_send_message(struct mpd_connection *connection,
*
* @param connection the connection to MPD
* @return true on success
+ *
+ * @since libmpdclient 2.5
*/
bool
mpd_send_read_messages(struct mpd_connection *connection);
@@ -173,6 +197,8 @@ mpd_send_read_messages(struct mpd_connection *connection);
*
* @return a mpd_message object on success, NULL on error or
* end-of-response
+ *
+ * @since libmpdclient 2.5
*/
mpd_malloc
struct mpd_message *
@@ -183,6 +209,8 @@ mpd_recv_message(struct mpd_connection *connection);
*
* @param connection the connection to MPD
* @return true on success
+ *
+ * @since libmpdclient 2.5
*/
bool
mpd_send_channels(struct mpd_connection *connection);
@@ -196,6 +224,8 @@ mpd_send_channels(struct mpd_connection *connection);
* @param connection a #mpd_connection
* @returns a "channel" pair, or NULL on error or if the end of the
* response is reached
+ *
+ * @since libmpdclient 2.5
*/
mpd_malloc
static inline struct mpd_pair *
diff --git a/include/mpd/mixer.h b/include/mpd/mixer.h
index a222f02..49521af 100644
--- a/include/mpd/mixer.h
+++ b/include/mpd/mixer.h
@@ -71,6 +71,8 @@ mpd_run_set_volume(struct mpd_connection *connection, unsigned volume);
* @param connection the connection to MPD
* @param relative_volume the relative volume, an integer between -100 and 100
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.9
*/
bool
mpd_send_change_volume(struct mpd_connection *connection, int relative_volume);
@@ -81,6 +83,8 @@ mpd_send_change_volume(struct mpd_connection *connection, int relative_volume);
* @param connection the connection to MPD
* @param relative_volume the relative volume, an integer between -100 and 100
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.9
*/
bool
mpd_run_change_volume(struct mpd_connection *connection, int relative_volume);
diff --git a/include/mpd/output.h b/include/mpd/output.h
index 37b9809..7dae7e6 100644
--- a/include/mpd/output.h
+++ b/include/mpd/output.h
@@ -178,6 +178,8 @@ mpd_run_disable_output(struct mpd_connection *connection, unsigned output_id);
* @param output_id an identifier for the output device (see
* mpd_recv_output())
* @return true on success
+ *
+ * @since libmpdclient 2.9
*/
bool
mpd_send_toggle_output(struct mpd_connection *connection, unsigned output_id);
@@ -189,6 +191,8 @@ mpd_send_toggle_output(struct mpd_connection *connection, unsigned output_id);
* @param output_id an identifier for the output device (see
* mpd_recv_output())
* @return true on success
+ *
+ * @since libmpdclient 2.9
*/
bool
mpd_run_toggle_output(struct mpd_connection *connection, unsigned output_id);
diff --git a/include/mpd/player.h b/include/mpd/player.h
index 0f7bb42..70b2eae 100644
--- a/include/mpd/player.h
+++ b/include/mpd/player.h
@@ -199,21 +199,39 @@ mpd_send_crossfade(struct mpd_connection *connection, unsigned seconds);
bool
mpd_run_crossfade(struct mpd_connection *connection, unsigned seconds);
+/**
+ * @since libmpdclient 2.2
+ */
bool
mpd_send_mixrampdb(struct mpd_connection *connection, float db);
+/**
+ * @since libmpdclient 2.2
+ */
bool
mpd_run_mixrampdb(struct mpd_connection *connection, float db);
+/**
+ * @since libmpdclient 2.2
+ */
bool
mpd_send_mixrampdelay(struct mpd_connection *connection, float seconds);
+/**
+ * @since libmpdclient 2.2
+ */
bool
mpd_run_mixrampdelay(struct mpd_connection *connection, float seconds);
+/**
+ * @since libmpdclient 2.4
+ */
bool
mpd_send_clearerror(struct mpd_connection *connection);
+/**
+ * @since libmpdclient 2.4
+ */
bool
mpd_run_clearerror(struct mpd_connection *connection);
diff --git a/include/mpd/playlist.h b/include/mpd/playlist.h
index 16381a3..07bb737 100644
--- a/include/mpd/playlist.h
+++ b/include/mpd/playlist.h
@@ -121,6 +121,8 @@ mpd_playlist_feed(struct mpd_playlist *playlist, const struct mpd_pair *pair);
*
* @param connection the connection to MPD
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.5
*/
bool
mpd_send_list_playlists(struct mpd_connection *connection);
diff --git a/include/mpd/queue.h b/include/mpd/queue.h
index ce2372d..357a8e0 100644
--- a/include/mpd/queue.h
+++ b/include/mpd/queue.h
@@ -62,6 +62,8 @@ mpd_send_list_queue_meta(struct mpd_connection *connection);
* @param end the end position of the range (excluding); the special
* value "(unsigned)-1" makes the end of the range open
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.8 added support for "(unsigned)-1"
*/
bool
mpd_send_list_queue_range_meta(struct mpd_connection *connection,
@@ -237,6 +239,8 @@ mpd_run_delete(struct mpd_connection *connection, unsigned pos);
* @param end the end position of the range (excluding); the special
* value "(unsigned)-1" makes the end of the range open
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.8 added support for "(unsigned)-1"
*/
bool
mpd_send_delete_range(struct mpd_connection *connection,
@@ -250,6 +254,8 @@ mpd_send_delete_range(struct mpd_connection *connection,
* @param end the end position of the range (excluding); the special
* value "(unsigned)-1" makes the end of the range open
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.8 added support for "(unsigned)-1"
*/
bool
mpd_run_delete_range(struct mpd_connection *connection,
@@ -297,6 +303,8 @@ mpd_run_shuffle(struct mpd_connection *connection);
* @param start the start position of the range (including)
* @param end the end position of the range (excluding); the special
* value "(unsigned)-1" makes the end of the range open
+ *
+ * @since libmpdclient 2.8 added support for "(unsigned)-1"
*/
bool
mpd_send_shuffle_range(struct mpd_connection *connection, unsigned start, unsigned end);
@@ -308,6 +316,8 @@ mpd_send_shuffle_range(struct mpd_connection *connection, unsigned start, unsign
* @param start the start position of the range (including)
* @param end the end position of the range (excluding); the special
* value "(unsigned)-1" makes the end of the range open
+ *
+ * @since libmpdclient 2.8 added support for "(unsigned)-1"
*/
bool
mpd_run_shuffle_range(struct mpd_connection *connection,
@@ -378,6 +388,8 @@ mpd_run_move_id(struct mpd_connection *connection, unsigned from, unsigned to);
* value "(unsigned)-1" makes the end of the range open
* @param to the new position of the song range
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.8 added support for "(unsigned)-1"
*/
bool
mpd_send_move_range(struct mpd_connection *connection,
@@ -392,6 +404,8 @@ mpd_send_move_range(struct mpd_connection *connection,
* value "(unsigned)-1" makes the end of the range open
* @param to the new position of the song range
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.8 added support for "(unsigned)-1"
*/
bool
mpd_run_move_range(struct mpd_connection *connection,
@@ -443,6 +457,8 @@ mpd_run_swap_id(struct mpd_connection *connection, unsigned id1, unsigned id2);
* @param connection the connection to MPD
* @param priority a number between 0 and 255
* @param position the position of the song
+ *
+ * @since libmpdclient 2.6
*/
bool
mpd_send_prio(struct mpd_connection *connection, int priority,
@@ -454,6 +470,8 @@ mpd_send_prio(struct mpd_connection *connection, int priority,
* @param connection the connection to MPD
* @param priority a number between 0 and 255
* @param position the position of the song
+ *
+ * @since libmpdclient 2.6
*/
bool
mpd_run_prio(struct mpd_connection *connection, int priority,
@@ -467,6 +485,9 @@ mpd_run_prio(struct mpd_connection *connection, int priority,
* @param start the start position of the range (including)
* @param end the end position of the range (excluding); the special
* value "(unsigned)-1" makes the end of the range open
+ *
+ * @since libmpdclient 2.6
+ * @since libmpdclient 2.8 added support for "(unsigned)-1"
*/
bool
mpd_send_prio_range(struct mpd_connection *connection, int priority,
@@ -480,6 +501,9 @@ mpd_send_prio_range(struct mpd_connection *connection, int priority,
* @param start the start position of the range (including)
* @param end the end position of the range (excluding); the special
* value "(unsigned)-1" makes the end of the range open
+ *
+ * @since libmpdclient 2.6
+ * @since libmpdclient 2.8 added support for "(unsigned)-1"
*/
bool
mpd_run_prio_range(struct mpd_connection *connection, int priority,
@@ -491,6 +515,8 @@ mpd_run_prio_range(struct mpd_connection *connection, int priority,
* @param connection the connection to MPD
* @param priority a number between 0 and 255
* @param id the id of the song
+ *
+ * @since libmpdclient 2.6
*/
bool
mpd_send_prio_id(struct mpd_connection *connection, int priority,
@@ -502,6 +528,8 @@ mpd_send_prio_id(struct mpd_connection *connection, int priority,
* @param connection the connection to MPD
* @param priority a number between 0 and 255
* @param id the id of the song
+ *
+ * @since libmpdclient 2.6
*/
bool
mpd_run_prio_id(struct mpd_connection *connection, int priority,
diff --git a/include/mpd/search.h b/include/mpd/search.h
index 430254c..bb137d2 100644
--- a/include/mpd/search.h
+++ b/include/mpd/search.h
@@ -135,6 +135,8 @@ bool mpd_count_db_songs(struct mpd_connection *connection);
* @param oper reserved, pass #MPD_OPERATOR_DEFAULT
* @param value the URI relative to the music directory
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.9
*/
bool
mpd_search_add_base_constraint(struct mpd_connection *connection,
@@ -189,6 +191,8 @@ mpd_search_add_any_tag_constraint(struct mpd_connection *connection,
* @param oper reserved, pass #MPD_OPERATOR_DEFAULT
* @param value the reference time stamp
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.10
*/
bool
mpd_search_add_modified_since_constraint(struct mpd_connection *connection,
@@ -203,6 +207,8 @@ mpd_search_add_modified_since_constraint(struct mpd_connection *connection,
* @param type The tag type of the constraint
* @param value The value of the constraint
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.10
*/
bool
mpd_search_add_window(struct mpd_connection *connection,
diff --git a/include/mpd/settings.h b/include/mpd/settings.h
index 99d13f0..10a2825 100644
--- a/include/mpd/settings.h
+++ b/include/mpd/settings.h
@@ -69,6 +69,8 @@ extern "C" {
* @param password the password, or NULL to use the default (MPD_HOST
* before "@")
* @return a #mpd_settings object or NULL if out of memory
+ *
+ * @since libmpdclient 2.4
*/
struct mpd_settings *
mpd_settings_new(const char *host, unsigned port, unsigned timeout_ms,
@@ -76,30 +78,40 @@ mpd_settings_new(const char *host, unsigned port, unsigned timeout_ms,
/**
* Releases a #mpd_settings object.
+ *
+ * @since libmpdclient 2.4
*/
void
mpd_settings_free(struct mpd_settings *settings);
/**
* Returns the host name (without password/port), or NULL if unknown.
+ *
+ * @since libmpdclient 2.4
*/
const char *
mpd_settings_get_host(const struct mpd_settings *settings);
/**
* Returns the port number, or 0 if not applicable.
+ *
+ * @since libmpdclient 2.4
*/
unsigned
mpd_settings_get_port(const struct mpd_settings *settings);
/**
* Returns the timeout in milliseconds, or 0 if unknown.
+ *
+ * @since libmpdclient 2.4
*/
unsigned
mpd_settings_get_timeout_ms(const struct mpd_settings *settings);
/**
* Returns the password, or NULL if none was configured.
+ *
+ * @since libmpdclient 2.4
*/
const char *
mpd_settings_get_password(const struct mpd_settings *settings);
diff --git a/include/mpd/song.h b/include/mpd/song.h
index a1d1976..bc9f377 100644
--- a/include/mpd/song.h
+++ b/include/mpd/song.h
@@ -111,6 +111,8 @@ mpd_song_get_duration(const struct mpd_song *song);
/**
* Returns the duration of this song in milliseconds. 0 means the
* duration is unknown.
+ *
+ * @since libmpdclient 2.10
*/
mpd_pure
unsigned
@@ -119,6 +121,8 @@ mpd_song_get_duration_ms(const struct mpd_song *song);
/**
* Returns the start of the virtual song within the physical file in
* seconds.
+ *
+ * @since libmpdclient 2.3
*/
mpd_pure
unsigned
@@ -128,6 +132,8 @@ mpd_song_get_start(const struct mpd_song *song);
* Returns the end of the virtual song within the physical file in
* seconds. Zero means that the physical song file is played to the
* end.
+ *
+ * @since libmpdclient 2.3
*/
mpd_pure
unsigned
@@ -170,6 +176,8 @@ mpd_song_get_id(const struct mpd_song *song);
/**
* Returns the priority of this song in the playlist. The value is
* undefined if you did not obtain this song from the queue.
+ *
+ * @since libmpdclient 2.8
*/
mpd_pure
unsigned
diff --git a/include/mpd/status.h b/include/mpd/status.h
index 827cc66..24b3ad9 100644
--- a/include/mpd/status.h
+++ b/include/mpd/status.h
@@ -194,6 +194,8 @@ mpd_status_get_crossfade(const struct mpd_status *status);
/**
* Returns mixrampdb setting in db.
+ *
+ * @since libmpdclient 2.2
*/
mpd_pure
float
@@ -202,6 +204,8 @@ mpd_status_get_mixrampdb(const struct mpd_status *status);
/**
* Returns mixrampdelay setting in seconds. Negative means mixramp is
* disabled.
+ *
+ * @since libmpdclient 2.2
*/
mpd_pure
float
@@ -227,6 +231,8 @@ mpd_status_get_song_id(const struct mpd_status *status);
/**
* The same as mpd_status_get_next_song_pos, but for the next song to be
* played.
+ *
+ * @since libmpdclient 2.7
*/
mpd_pure
int
@@ -235,6 +241,8 @@ mpd_status_get_next_song_pos(const struct mpd_status *status);
/**
* Returns the id of the next song to be played. If it is not known, -1 is
* returned.
+ *
+ * @since libmpdclient 2.7
*/
mpd_pure
int
@@ -251,6 +259,8 @@ mpd_status_get_elapsed_time(const struct mpd_status *status);
/**
* Returns time in milliseconds that have elapsed in the currently
* playing/paused song.
+ *
+ * @since libmpdclient 2.1
*/
mpd_pure
unsigned
diff --git a/include/mpd/sticker.h b/include/mpd/sticker.h
index f9a1f1d..b11966f 100644
--- a/include/mpd/sticker.h
+++ b/include/mpd/sticker.h
@@ -57,6 +57,8 @@ extern "C" {
* @param name the name of the sticker
* @param value the value of the sticker
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.1
*/
bool
mpd_send_sticker_set(struct mpd_connection *connection, const char *type,
@@ -71,6 +73,8 @@ mpd_send_sticker_set(struct mpd_connection *connection, const char *type,
* @param name the name of the sticker
* @param value the value of the sticker
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.1
*/
bool
mpd_run_sticker_set(struct mpd_connection *connection, const char *type,
@@ -84,6 +88,8 @@ mpd_run_sticker_set(struct mpd_connection *connection, const char *type,
* @param uri the URI of the object
* @param name the name of the sticker
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.1
*/
bool
mpd_send_sticker_delete(struct mpd_connection *connection, const char *type,
@@ -97,6 +103,8 @@ mpd_send_sticker_delete(struct mpd_connection *connection, const char *type,
* @param uri the URI of the object
* @param name the name of the sticker
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.1
*/
bool
mpd_run_sticker_delete(struct mpd_connection *connection, const char *type,
@@ -110,6 +118,8 @@ mpd_run_sticker_delete(struct mpd_connection *connection, const char *type,
* @param uri the URI of the object
* @param name the name of the sticker
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.1
*/
bool
mpd_send_sticker_get(struct mpd_connection *connection, const char *type,
@@ -123,6 +133,8 @@ mpd_send_sticker_get(struct mpd_connection *connection, const char *type,
* @param type the object type, e.g. "song"
* @param uri the URI of the object
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.1
*/
bool
mpd_send_sticker_list(struct mpd_connection *connection, const char *type,
@@ -137,6 +149,8 @@ mpd_send_sticker_list(struct mpd_connection *connection, const char *type,
* NULL to search for all objects of the specified type
* @param name the name of the sticker
* @return true on success, false on error
+ *
+ * @since libmpdclient 2.1
*/
bool
mpd_send_sticker_find(struct mpd_connection *connection, const char *type,
@@ -150,6 +164,8 @@ mpd_send_sticker_find(struct mpd_connection *connection, const char *type,
* @param name_length_r the length of the name (starting at the
* beginning of the input string) is returned here
* @return a pointer to the sticker value, or NULL on error
+ *
+ * @since libmpdclient 2.1
*/
const char *
mpd_parse_sticker(const char *input, size_t *name_length_r);
@@ -161,6 +177,8 @@ mpd_parse_sticker(const char *input, size_t *name_length_r);
* @param connection the connection to MPD
* @return a #mpd_pair object on success, NULL on end of response or
* error
+ *
+ * @since libmpdclient 2.1
*/
mpd_malloc
struct mpd_pair *
@@ -168,6 +186,8 @@ mpd_recv_sticker(struct mpd_connection *connection);
/**
* Free the pair returned by mpd_recv_sticker().
+ *
+ * @since libmpdclient 2.1
*/
void
mpd_return_sticker(struct mpd_connection *connection, struct mpd_pair *pair);
diff --git a/include/mpd/tag.h b/include/mpd/tag.h
index bd1eee7..181cfc5 100644
--- a/include/mpd/tag.h
+++ b/include/mpd/tag.h
@@ -33,6 +33,10 @@
#ifndef LIBMPDCLIENT_TAG_H
#define LIBMPDCLIENT_TAG_H
+/**
+ * @since libmpdclient 2.10 added support for #MPD_TAG_MUSICBRAINZ_RELEASETRACKID.
+ * @since libmpdclient 2.11 added support for #MPD_TAG_ARTIST_SORT and #MPD_TAG_ALBUM_ARTIST_SORT.
+ */
enum mpd_tag_type
{
/**
--
1.9.1
signature.asc
Description: Digital signature
_______________________________________________ mpd-devel mailing list mpd-devel@musicpd.org http://mailman.blarg.de/listinfo/mpd-devel
