Guard header files for unstable API

2008-01-14  Matthias Clasen  <mclasen@redhat.com>

	* Guard header files with a GWEATHER_I_KNOW_THIS_IS_UNSTABLE
	preprocessor symbol.
Signed-off-by: Federico Mena Quintero <federico@gnu.org>

svn path=/trunk/; revision=39

ChangeLog

+2008-01-14  Matthias Clasen  <mclasen@redhat.com>
+
+	* Guard header files with a GWEATHER_I_KNOW_THIS_IS_UNSTABLE
+	preprocessor symbol.
+
 2008-01-11  Matthias Clasen  <mclasen@redhat.com>
 
 	* libgweather/gweather-prefs.c (get_translated_unit): Fix

README

+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.

libgweather/gweather-gconf.h

@@ -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>

libgweather/gweather-prefs.h

@@ -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>
 

libgweather/weather.h

@@ -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