[libgweather/ebassi/gtk4] docs: Remove all "Since" annotations



commit dd2bd8668c5bf20955a6a6b1877208e9e2b39754
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Wed Oct 13 12:43:48 2021 +0100

    docs: Remove all "Since" annotations
    
    The major API has been reset, there's no need to have a "Since"
    annotation, as all symbols are available from this version until the
    next major API break.

 libgweather/gweather-location.c   | 16 ++--------------
 libgweather/gweather-timezone.c   |  2 --
 libgweather/gweather-version.h.in | 12 ------------
 3 files changed, 2 insertions(+), 28 deletions(-)
---
diff --git a/libgweather/gweather-location.c b/libgweather/gweather-location.c
index f999050f..5ef6c456 100644
--- a/libgweather/gweather-location.c
+++ b/libgweather/gweather-location.c
@@ -338,7 +338,6 @@ gweather_location_get_sort_name (GWeatherLocation *loc)
  * Gets @loc's English name.
  *
  * Return value: @loc's English name
- * Since: 3.36
  **/
 const char *
 gweather_location_get_english_name (GWeatherLocation *loc)
@@ -364,7 +363,6 @@ gweather_location_get_english_name (GWeatherLocation *loc)
  * user input against a location name.
  *
  * Return value: @loc's English name for sorting
- * Since: 3.38
  **/
 const char *
 gweather_location_get_english_sort_name (GWeatherLocation *loc)
@@ -488,8 +486,6 @@ gweather_location_get_parent (GWeatherLocation *loc)
  * ]|
  *
  * Returns: (transfer full) (nullable): The next child, or %NULL
- *
- * Since: 40
  **/
 GWeatherLocation*
 gweather_location_next_child  (GWeatherLocation  *loc, GWeatherLocation  *_child)
@@ -715,9 +711,7 @@ find_nearest_city (GWeatherLocation *location,
  * @loc, or are in the same region and timezone as the return value.
  *
  * Returns: (transfer full): the city closest to (@lat, @lon), in the
- *          region or administrative district of @loc.
- *
- * Since: 3.12
+ *   region or administrative district of @loc.
  */
 GWeatherLocation *
 gweather_location_find_nearest_city (GWeatherLocation *loc,
@@ -768,9 +762,7 @@ gweather_location_find_nearest_city (GWeatherLocation *loc,
  * This restriction may be lifted in a future version.
  *
  * Returns: (transfer full): the city closest to (@lat, @lon), in the
- *          region or administrative district of @loc with validation of filter function.
- *
- * Since: 3.12
+ *   region or administrative district of @loc with validation of filter function.
  */
 GWeatherLocation *
 gweather_location_find_nearest_city_full (GWeatherLocation  *loc,
@@ -863,8 +855,6 @@ _got_place (GObject      *source_object,
  *
  * @loc must be at most a %GWEATHER_LOCATION_ADM1 location.
  * This restriction may be lifted in a future version.
- *
- * Since: 3.12
  */
 void
 gweather_location_detect_nearest_city (GWeatherLocation    *loc,
@@ -908,8 +898,6 @@ gweather_location_detect_nearest_city (GWeatherLocation    *loc,
  * Fetches the location from @result.
  *
  * Returns: (transfer full): Customized GWeatherLocation
- *
- * Since: 3.12
  */
 
 GWeatherLocation *
diff --git a/libgweather/gweather-timezone.c b/libgweather/gweather-timezone.c
index 7b4327cc..590b4b14 100644
--- a/libgweather/gweather-timezone.c
+++ b/libgweather/gweather-timezone.c
@@ -182,8 +182,6 @@ _gweather_timezone_ref_for_idx (GWeatherDb       *db,
  * Prior to version 40 no reference was returned.
  *
  * Returns: (transfer full): A #GWeatherTimezone.
- *
- * Since: 3.12
  */
 GWeatherTimezone *
 gweather_timezone_get_by_tzid (const char *tzid)
diff --git a/libgweather/gweather-version.h.in b/libgweather/gweather-version.h.in
index 799e4010..776438f8 100644
--- a/libgweather/gweather-version.h.in
+++ b/libgweather/gweather-version.h.in
@@ -40,8 +40,6 @@
  * GWEATHER_MAJOR_VERSION:
  *
  * LibGweather major version component (e.g. 1 if %GWEATHER_VERSION is 1.2.3)
- *
- * Since: 3.12
  */
 #mesondefine GWEATHER_MAJOR_VERSION
 
@@ -49,8 +47,6 @@
  * GWEATHER_MINOR_VERSION:
  *
  * LibGweather minor version component (e.g. 2 if %GWEATHER_VERSION is 1.2.3)
- *
- * Since: 3.12
  */
 #mesondefine GWEATHER_MINOR_VERSION
 
@@ -60,8 +56,6 @@
  * LibGweather micro version component (e.g. 3 if %GWEATHER_VERSION is 1.2.3)
  *
  * Since version 40 of the library, always 0.
- *
- * Since: 3.12
  */
 #mesondefine GWEATHER_MICRO_VERSION
 
@@ -69,8 +63,6 @@
  * GWEATHER_VERSION
  *
  * LibGweather version.
- *
- * Since: 3.12
  */
 #mesondefine GWEATHER_VERSION
 
@@ -79,8 +71,6 @@
  *
  * LibGweather version, encoded as an hexadecimal number, useful for
  * integer comparisons.
- *
- * Since: 3.12
  */
 #define GWEATHER_VERSION_HEX                (GWEATHER_MAJOR_VERSION << 24 | \
                                              GWEATHER_MINOR_VERSION << 16 | \
@@ -94,8 +84,6 @@
  *
  * Compile-time version checking. Evaluates to %TRUE if the version
  * of LibGweather is greater than the required one.
- *
- * Since: 3.12
  */
 #define GWEATHER_CHECK_VERSION(major,minor,micro)   \
         (GWEATHER_MAJOR_VERSION > (major) || \


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]