From: Uwe Hermann <redacted>
Date: Sun, 3 Nov 2013 15:08:38 +0000 (+0100)
Subject: doxygen: @since tags document only last API change.
X-Git-Tag: libsigrok-0.2.2~14
X-Git-Url: https://sigrok.org/gitaction?a=commitdiff_plain;h=53f05fa80f1f9d7657f1173f24d9d1e2b740a312;p=libsigrok.git

doxygen: @since tags document only last API change.

If a function existed before but the API changed, the @since
tag only reflects the release of the last API change.
---

diff --git a/backend.c b/backend.c
index 42817158..0d1b4726 100644
--- a/backend.c
+++ b/backend.c
@@ -322,7 +322,7 @@ static int sanity_check_all_output_modules(void)
  *         the context will be free'd by sr_exit() as part of the libsigrok
  *         shutdown.
  *
- * @since 0.1.0 (but the API changed in 0.2.0)
+ * @since 0.2.0
  */
 SR_API int sr_init(struct sr_context **ctx)
 {
@@ -384,7 +384,7 @@ done:
  *
  * @return SR_OK upon success, a (negative) error code otherwise.
  *
- * @since 0.1.0 (but the API changed in 0.2.0)
+ * @since 0.2.0
  */
 SR_API int sr_exit(struct sr_context *ctx)
 {
diff --git a/device.c b/device.c
index 327ddc73..b261d6a7 100644
--- a/device.c
+++ b/device.c
@@ -80,7 +80,7 @@ SR_PRIV struct sr_probe *sr_probe_new(int index, int type,
  *
  * @return SR_OK on success, or SR_ERR_ARG on invalid arguments.
  *
- * @since 0.1.0 (but the API changed in 0.2.0)
+ * @since 0.2.0
  */
 SR_API int sr_dev_probe_name_set(const struct sr_dev_inst *sdi,
 		int probenum, const char *name)
@@ -154,7 +154,7 @@ SR_API int sr_dev_probe_enable(const struct sr_dev_inst *sdi, int probenum,
  *
  * @return SR_OK on success, or SR_ERR_ARG on invalid arguments.
  *
- * @since 0.1.0 (but the API changed in 0.2.0)
+ * @since 0.2.0
  */
 SR_API int sr_dev_trigger_set(const struct sr_dev_inst *sdi, int probenum,
 		const char *trigger)
@@ -196,7 +196,7 @@ SR_API int sr_dev_trigger_set(const struct sr_dev_inst *sdi, int probenum,
  *         FALSE is also returned on invalid input parameters or other
  *         error conditions.
  *
- * @since 0.1.0 (but the API changed in 0.2.0)
+ * @since 0.2.0
  */
 SR_API gboolean sr_dev_has_option(const struct sr_dev_inst *sdi, int key)
 {
@@ -352,7 +352,7 @@ SR_PRIV void sr_serial_dev_inst_free(struct sr_serial_dev_inst *serial)
  * @return The list of devices/instances of this driver, or NULL upon errors
  *         or if the list is empty.
  *
- * @since 0.1.0 (but the API changed in 0.2.0)
+ * @since 0.2.0
  */
 SR_API GSList *sr_dev_list(const struct sr_dev_driver *driver)
 {
diff --git a/filter.c b/filter.c
index 11cad5c3..8a00e76d 100644
--- a/filter.c
+++ b/filter.c
@@ -96,7 +96,7 @@
  *         If something other than SR_OK is returned, the values of
  *         out_unitsize, data_out, and length_out are undefined.
  *
- * @since 0.1.0 (but the API changed in 0.2.0)
+ * @since 0.2.0
  */
 SR_API int sr_filter_probes(unsigned int in_unitsize, unsigned int out_unitsize,
 			    const GArray *probe_array, const uint8_t *data_in,