libgweather r39 - in trunk: . libgweather

[federico svn gnome org]

Author: federico
Date: Mon Jan 14 16:56:15 2008
New Revision: 39
URL: http://svn.gnome.org/viewvc/libgweather?rev=39&view=rev

Log:
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>


Modified:
   trunk/ChangeLog
   trunk/README
   trunk/libgweather/gweather-gconf.h
   trunk/libgweather/gweather-prefs.h
   trunk/libgweather/weather.h

Modified: trunk/README
==============================================================================
--- trunk/README	(original)
+++ trunk/README	Mon Jan 14 16:56:15 2008
@@ -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.

Modified: trunk/libgweather/gweather-gconf.h
==============================================================================
--- trunk/libgweather/gweather-gconf.h	(original)
+++ trunk/libgweather/gweather-gconf.h	Mon Jan 14 16:56:15 2008
@@ -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>

Modified: trunk/libgweather/gweather-prefs.h
==============================================================================
--- trunk/libgweather/gweather-prefs.h	(original)
+++ trunk/libgweather/gweather-prefs.h	Mon Jan 14 16:56:15 2008
@@ -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>
 

Modified: trunk/libgweather/weather.h
==============================================================================
--- trunk/libgweather/weather.h	(original)
+++ trunk/libgweather/weather.h	Mon Jan 14 16:56:15 2008
@@ -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