summaryrefslogtreecommitdiff
path: root/doc/migrating-3to4.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/migrating-3to4.md')
-rw-r--r--doc/migrating-3to4.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/migrating-3to4.md b/doc/migrating-3to4.md
new file mode 100644
index 0000000..b067061
--- /dev/null
+++ b/doc/migrating-3to4.md
@@ -0,0 +1,13 @@
+Title: Migrating from GWeather 3.x to GWeather 4
+
+## Migrating from GWeather 3.x to GWeather 4
+
+GWeather 4 is a new major version that breaks API and ABI compared with
+GWeather 3.
+
+### Stop using `GWeatherLocationEntry` and `GWeatherTimezoneMenu`
+
+GWeather 4 does not provide GTK widgets for selecting a location or a time
+zone. Applications should provide their own UI, if needed, according to the
+best practices of the [GNOME human interface
+guidelines](https://developer.gnome.org/hig/).