Add G_GNUC_WARN_UNUSED_RESULT to clutter_init and init_with_args

Many people expect clutter_init to work the same way as gtk_init which
exits the program on init failure. clutter_init however returns a
status code on failure which applications need to handle because if
the init fails then any further Clutter calls are likely to crash. In
Clutter 2.0 we may want to change this to be more like GTK+.

http://bugzilla.clutter-project.org/show_bug.cgi?id=2574
This commit is contained in:
Neil Roberts 2011-02-22 12:38:19 +00:00
parent aece642adb
commit 3d34d9fea1

View File

@ -79,13 +79,15 @@ GQuark clutter_init_error_quark (void);
/* Initialisation */ /* Initialisation */
void clutter_base_init (void); void clutter_base_init (void);
ClutterInitError clutter_init (int *argc, ClutterInitError clutter_init (int *argc,
char ***argv); char ***argv)
G_GNUC_WARN_UNUSED_RESULT;
ClutterInitError clutter_init_with_args (int *argc, ClutterInitError clutter_init_with_args (int *argc,
char ***argv, char ***argv,
const char *parameter_string, const char *parameter_string,
GOptionEntry *entries, GOptionEntry *entries,
const char *translation_domain, const char *translation_domain,
GError **error); GError **error)
G_GNUC_WARN_UNUSED_RESULT;
GOptionGroup * clutter_get_option_group (void); GOptionGroup * clutter_get_option_group (void);
GOptionGroup * clutter_get_option_group_without_init (void); GOptionGroup * clutter_get_option_group_without_init (void);