[gexiv2/wip/Jehan/no-warnings-only-gerrors] gexiv2: add various "Since: 0.12.2" doc comments.

[Jehan <jehanp src gnome org>]

commit d64f145b0b0b87851541dc919eb70394e3d459d7
Author: Jehan <jehan girinstud io>
Date:   Mon Dec 14 20:44:05 2020 +0100

    gexiv2: add various "Since: 0.12.2" doc comments.

 gexiv2/gexiv2-metadata.h | 38 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)
---
diff --git a/gexiv2/gexiv2-metadata.h b/gexiv2/gexiv2-metadata.h
index fe9bfe4..717f0f1 100644
--- a/gexiv2/gexiv2-metadata.h
+++ b/gexiv2/gexiv2-metadata.h
@@ -401,6 +401,8 @@ gboolean            gexiv2_metadata_is_xmp_tag                              (const gchar* 
tag);
  * The Exiv2 Tag Reference can be found at <ulink url="http://exiv2.org/metadata.html";></ulink>
  *
  * Returns: (transfer none) (allow-none): The tag's label
+ *
+ * Since: 0.12.2
  */
 const gchar*   gexiv2_metadata_try_get_tag_label               (const gchar *tag, GError **error);
 
@@ -425,6 +427,8 @@ const gchar*        gexiv2_metadata_get_tag_label           (const gchar *tag);
  * The Exiv2 Tag Reference can be found at <ulink url="http://exiv2.org/metadata.html";></ulink>
  *
  * Returns: (transfer none) (allow-none): The tag's description
+ *
+ * Since: 0.12.2
  */
 const gchar*   gexiv2_metadata_try_get_tag_description (const gchar *tag, GError **error);
 
@@ -452,6 +456,8 @@ const gchar*        gexiv2_metadata_get_tag_description     (const gchar *tag);
  * The Exiv2 Tag Reference can be found at <ulink url="http://exiv2.org/metadata.html";></ulink>
  *
  * Returns: (transfer none) (allow-none): The tag's type name.
+ *
+ * Since: 0.12.2
  */
 const gchar*   gexiv2_metadata_try_get_tag_type        (const gchar *tag, GError **error);
 
@@ -610,6 +616,8 @@ gboolean            gexiv2_metadata_set_tag_string          (GExiv2Metadata *self, const 
gchar* ta
  * The Exiv2 Tag Reference can be found at <ulink url="http://exiv2.org/metadata.html";></ulink>
  *
  * Returns: TRUE on success
+ *
+ * Since: 0.12.2
  */
 gboolean gexiv2_metadata_try_set_xmp_tag_struct (GExiv2Metadata *self, const gchar* tag, GExiv2StructureType 
type, GError **error);
 
@@ -640,6 +648,8 @@ gboolean gexiv2_metadata_set_xmp_tag_struct (GExiv2Metadata *self, const gchar*
  * The Exiv2 Tag Reference can be found at <ulink url="http://exiv2.org/metadata.html";></ulink>
  *
  * Returns: (transfer full) (allow-none): The tag's interpreted value as a string
+ *
+ * Since: 0.12.2
  */
 gchar*                 gexiv2_metadata_try_get_tag_interpreted_string (GExiv2Metadata *self, const gchar* 
tag, GError **error);
 
@@ -669,6 +679,8 @@ gchar*                      gexiv2_metadata_get_tag_interpreted_string (GExiv2Metadata 
*self, const
  * The Exiv2 Tag Reference can be found at <ulink url="http://exiv2.org/metadata.html";></ulink>
  *
  * Returns: The tag's value as a glong
+ *
+ * Since: 0.12.2
  */
 glong                  gexiv2_metadata_try_get_tag_long        (GExiv2Metadata *self, const gchar* tag, 
GError **error);
 
@@ -696,6 +708,8 @@ glong                       gexiv2_metadata_get_tag_long            (GExiv2Metadata 
*self, const gchar* tag);
  * The Exiv2 Tag Reference can be found at <ulink url="http://exiv2.org/metadata.html";></ulink>
  *
  * Returns: TRUE on success
+ *
+ * Since: 0.12.2
  */
 gboolean               gexiv2_metadata_try_set_tag_long        (GExiv2Metadata *self, const gchar* tag, 
glong value, GError **error);
 
@@ -791,6 +805,8 @@ gboolean            gexiv2_metadata_set_tag_multiple        (GExiv2Metadata *self, const 
gchar* t
  * The Exiv2 Tag Reference can be found at <ulink url="http://exiv2.org/metadata.html";></ulink>
  *
  * Returns: (transfer full) (allow-none): The tag's raw value as a byte array
+ *
+ * Since: 0.12.2
  */
 GBytes*                        gexiv2_metadata_try_get_tag_raw         (GExiv2Metadata *self, const gchar* 
tag, GError **error);
 
@@ -851,6 +867,8 @@ gchar**                     gexiv2_metadata_get_exif_tags           (GExiv2Metadata 
*self);
  * @den the denominator of the fraction on successful return.
  *
  * Returns: (skip): Boolean success value
+ *
+ * Since: 0.12.2
  */
 gboolean               gexiv2_metadata_try_get_exif_tag_rational (GExiv2Metadata *self, const gchar* tag, 
gint* nom, gint* den, GError **error);
 
@@ -866,6 +884,8 @@ gboolean            gexiv2_metadata_try_get_exif_tag_rational (GExiv2Metadata *self, const
  * @den the denominator of the fraction.
  *
  * Returns: (skip): Boolean success value
+ *
+ * Since: 0.12.2
  */
 gboolean               gexiv2_metadata_try_set_exif_tag_rational (GExiv2Metadata *self, const gchar* tag, 
gint nom, gint den, GError **error);
 
@@ -985,6 +1005,8 @@ void                       gexiv2_metadata_clear_xmp                       
(GExiv2Metadata *self);
  * Encode the XMP packet as a %NULL-terminated string.
  *
  * Returns: (transfer full) (allow-none): Encode the XMP packet and return as a %NULL-terminated string.
+ *
+ * Since: 0.12.2
  */
 gchar*         gexiv2_metadata_try_generate_xmp_packet (GExiv2Metadata *self, GExiv2XmpFormatFlags 
xmp_format_flags, guint32 padding, GError **error);
 
@@ -1009,6 +1031,8 @@ gchar*            gexiv2_metadata_generate_xmp_packet     (GExiv2Metadata *self, 
GExiv2XmpForm
  * @error: (allow-none): A return location for a #GError or %NULL
  *
  * Returns: (transfer full) (allow-none): The currently-encoded XMP packet (see 
gexiv2_metadata_generate_xmp_packet).
+ *
+ * Since: 0.12.2
  */
 gchar*                 gexiv2_metadata_try_get_xmp_packet      (GExiv2Metadata *self, GError **error);
 
@@ -1254,6 +1278,8 @@ gint                      gexiv2_metadata_get_iso_speed           (GExiv2Metadata 
*self);
  * Query the longitude stored in the GPS tags of @self
  *
  * Returns: (skip): Boolean success value
+ *
+ * Since: 0.12.2
  */
 gboolean               gexiv2_metadata_try_get_gps_longitude                   (GExiv2Metadata *self, 
gdouble *longitude, GError **error);
 
@@ -1266,6 +1292,8 @@ gboolean          gexiv2_metadata_try_get_gps_longitude                   
(GExiv2Metadata *self, gdouble
  * Query the latitude stored in the GPS tags of @self
  *
  * Returns: (skip): Boolean success value
+ *
+ * Since: 0.12.2
  */
 gboolean               gexiv2_metadata_try_get_gps_latitude                    (GExiv2Metadata *self, 
gdouble *latitude, GError **error);
 
@@ -1279,6 +1307,8 @@ gboolean          gexiv2_metadata_try_get_gps_latitude                    
(GExiv2Metadata *self, gdouble
  * image
  *
  * Returns: (skip): Boolean success value
+ *
+ * Since: 0.12.2
  */
 gboolean               gexiv2_metadata_try_get_gps_altitude            (GExiv2Metadata *self, gdouble 
*altitude, GError **error);
 
@@ -1336,6 +1366,8 @@ gboolean          gexiv2_metadata_get_gps_altitude                        
(GExiv2Metadata *self, gdouble *alt
  * Convenience function to query all available GPS information at once.
  *
  * Returns: (skip): Boolean success value.
+ *
+ * Since: 0.12.2
  */
 gboolean               gexiv2_metadata_try_get_gps_info                        (GExiv2Metadata *self, 
gdouble *longitude, gdouble *latitude, gdouble *altitude, GError **error);
 
@@ -1368,6 +1400,8 @@ gboolean          gexiv2_metadata_get_gps_info                            
(GExiv2Metadata *self, gdouble *longit
  * just modifying the GPS data.
  *
  * Returns: (skip): Boolean success value.
+ *
+ * Since: 0.12.2
  */
 gboolean               gexiv2_metadata_try_set_gps_info                        (GExiv2Metadata *self, 
gdouble longitude, gdouble latitude, gdouble altitude, GError **error);
 
@@ -1401,7 +1435,7 @@ gboolean          gexiv2_metadata_set_gps_info                            
(GExiv2Metadata *self, gdouble longitu
  *
  * Returns: (skip): Boolean success value.
  *
- * Since: 0.12.1
+ * Since: 0.12.2
  */
 gboolean               gexiv2_metadata_try_update_gps_info                     (GExiv2Metadata *self, 
gdouble longitude, gdouble latitude, gdouble altitude, GError **error);
 
@@ -1428,6 +1462,8 @@ gboolean          gexiv2_metadata_update_gps_info                         
(GExiv2Metadata *self, gdouble long
  * @self: An instance of #GExiv2Metadata
  *
  * Removes all GPS metadata from the loaded image
+ *
+ * Since: 0.12.2
  */
 void                   gexiv2_metadata_try_delete_gps_info                     (GExiv2Metadata *self, GError 
**error);