Drop gtk_true and gtk_false

These functions are entirely trivial, their documentation
is much longer than their implementation, and it contains
an example that is annotated as "don't do this"...
This commit is contained in:
Matthias Clasen 2017-12-31 12:49:53 -05:00
parent 75271c44c2
commit 4923da3550
3 changed files with 0 additions and 76 deletions

View File

@ -4814,10 +4814,6 @@ gtk_main_do_event
GtkModuleInitFunc
GtkModuleDisplayInitFunc
<SUBSECTION>
gtk_true
gtk_false
<SUBSECTION>
gtk_grab_add
gtk_grab_get_current

View File

@ -1906,73 +1906,6 @@ gtk_main_do_event (GdkEvent *event)
g_object_unref (rewritten_event);
}
/**
* gtk_true:
*
* All this function does it to return %TRUE.
*
* This can be useful for example if you want to inhibit the deletion
* of a window. Of course you should not do this as the user expects
* a reaction from clicking the close icon of the window...
*
* ## A persistent window
*
* |[<!-- language="C" -->
* #include <gtk/gtk.h>
*
* int
* main (int argc, char **argv)
* {
* GtkWidget *win, *but;
* const char *text = "Close yourself. I mean it!";
*
* gtk_init (&argc, &argv);
*
* win = gtk_window_new (GTK_WINDOW_TOPLEVEL);
* g_signal_connect (win,
* "delete-event",
* G_CALLBACK (gtk_true),
* NULL);
* g_signal_connect (win, "destroy",
* G_CALLBACK (gtk_main_quit),
* NULL);
*
* but = gtk_button_new_with_label (text);
* g_signal_connect_swapped (but, "clicked",
* G_CALLBACK (gtk_object_destroy),
* win);
* gtk_container_add (GTK_CONTAINER (win), but);
*
* gtk_widget_show (win);
*
* gtk_main ();
*
* return 0;
* }
* ]|
*
* Returns: %TRUE
*/
gboolean
gtk_true (void)
{
return TRUE;
}
/**
* gtk_false:
*
* Analogical to gtk_true(), this function does nothing
* but always returns %FALSE.
*
* Returns: %FALSE
*/
gboolean
gtk_false (void)
{
return FALSE;
}
static GtkWindowGroup *
gtk_main_get_window_group (GtkWidget *widget)
{

View File

@ -119,11 +119,6 @@ gboolean gtk_main_iteration (void);
GDK_AVAILABLE_IN_ALL
gboolean gtk_main_iteration_do (gboolean blocking);
GDK_AVAILABLE_IN_ALL
gboolean gtk_true (void) G_GNUC_CONST;
GDK_AVAILABLE_IN_ALL
gboolean gtk_false (void) G_GNUC_CONST;
GDK_AVAILABLE_IN_ALL
void gtk_grab_add (GtkWidget *widget);
GDK_AVAILABLE_IN_ALL