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.
_______________________________________________ gnome-i18n mailing list gnome-i18n@gnome.org http://mail.gnome.org/mailman/listinfo/gnome-i18n
