summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorEmmanuele Bassi <ebassi@gnome.org>2021-11-22 13:13:39 +0000
committerEmmanuele Bassi <ebassi@gmail.com>2021-11-22 16:47:16 +0000
commit248e701f39d7c0965564eee94c35dc718f75583c (patch)
tree138aea7a26fbe34bc810846635a2a95247d13a66 /doc
parent23eb2c606193d884d13e04e069028a5a8e94c634 (diff)
downloadlibgweather-248e701f39d7c0965564eee94c35dc718f75583c.tar.gz
Remove nullable instance arguments
They are barely a C convenience API, since it's trivial to get the world location instead of passing NULL; consumers of the API through language bindings cannot have nullable instance arguments.
Diffstat (limited to 'doc')
-rw-r--r--doc/migrating-3to4.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/doc/migrating-3to4.md b/doc/migrating-3to4.md
index 7fe97c8..76c65cd 100644
--- a/doc/migrating-3to4.md
+++ b/doc/migrating-3to4.md
@@ -51,6 +51,13 @@ method has been returning `NULL` since then.
The Yahoo! provider was removed in libgweather 3.28.
+### Always pass a location to find and detect nearest location API
+
+The [`method@GWeather.Location.find_nearest_city`],
+[`method@GWeather.Location.find_nearest_city_full`], and
+[`method@GWeather.Location.detect_nearest_city`] methods do not accept
+`NULL` as the instance argument any more.
+
## Changes
The following changes in GWeather 4 are incompatible with GWeather 3.x, and