Re: Making the next gnome-applets depend on libgweather.

["Matthias Clasen" <matthias clasen gmail com>]

Here is a patch for the unstable dance.

Index: libgweather/weather.h
===================================================================
--- libgweather/weather.h	(revision 37)
+++ libgweather/weather.h	(working copy)
@@ -13,6 +13,12 @@
  *
  */
 
+
+#ifndef GWEATHER_I_KNOW_THIS_IS_UNSTABLE
+#error "libgweather should only be used if you understand that it's subject to change, and is not supported as a fixed API/ABI or as part of the platform"
+#endif
+
+
 #include <gdk-pixbuf/gdk-pixbuf-loader.h>
 
 G_BEGIN_DECLS
Index: libgweather/gweather-gconf.h
===================================================================
--- libgweather/gweather-gconf.h	(revision 37)
+++ libgweather/gweather-gconf.h	(working copy)
@@ -26,6 +26,12 @@
 #ifndef __GWEATHER_GCONF_WRAPPER_H__
 #define __GWEATHER_GCONF_WRAPPER_H__
 
+
+#ifndef GWEATHER_I_KNOW_THIS_IS_UNSTABLE
+#error "libgweather should only be used if you understand that it's subject to change, and is not supported as a fixed API/ABI or as part of the platform"
+#endif
+
+
 #include <glib/gmacros.h>
 #include <glib/gerror.h>
 #include <gconf/gconf-client.h>
Index: libgweather/gweather-prefs.h
===================================================================
--- libgweather/gweather-prefs.h	(revision 37)
+++ libgweather/gweather-prefs.h	(working copy)
@@ -11,6 +11,12 @@
 #ifndef __GWEATHER_PREFS_H_
 #define __GWEATHER_PREFS_H_
 
+
+#ifndef GWEATHER_I_KNOW_THIS_IS_UNSTABLE
+#error "libgweather should only be used if you understand that it's subject to change, and is not supported as a fixed API/ABI or as part of the platform"
+#endif
+
+
 #include <libgweather/weather.h>
 #include <libgweather/gweather-gconf.h>
 
Index: README
===================================================================
--- README	(revision 37)
+++ README	(working copy)
@@ -0,0 +1,11 @@
+libgweather is a library to access weather information from online
+services for numerous locations.
+
+libgweather isn't supported in the devel platform, which means OS vendors 
+won't guarantee the API/ABI long-term, but authors of open source apps
+should feel free to use libgweather as users can always recompile against
+a new version.  
+
+To use libgweather in your code, you need to define the 
+GWEATHER_I_KNOW_THIS_IS_UNSTABLE preprecessor symbol, e.g. by adding
+-DGWEATHER_I_KNOW_THIS_IS_UNSTABLE to your CFLAGS.