1 | /* GLIB - Library of useful routines for C programming |
2 | * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald |
3 | * |
4 | * This library is free software; you can redistribute it and/or |
5 | * modify it under the terms of the GNU Lesser General Public |
6 | * License as published by the Free Software Foundation; either |
7 | * version 2.1 of the License, or (at your option) any later version. |
8 | * |
9 | * This library is distributed in the hope that it will be useful, |
10 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
11 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
12 | * Lesser General Public License for more details. |
13 | * |
14 | * You should have received a copy of the GNU Lesser General Public |
15 | * License along with this library; if not, see <http://www.gnu.org/licenses/>. |
16 | */ |
17 | |
18 | /* |
19 | * Modified by the GLib Team and others 1997-2000. See the AUTHORS |
20 | * file for a list of people on the GLib Team. See the ChangeLog |
21 | * files for a list of changes. These files are distributed with |
22 | * GLib at ftp://ftp.gtk.org/pub/gtk/. |
23 | */ |
24 | |
25 | #ifndef __G_DEPRECATED_MAIN_H__ |
26 | #define __G_DEPRECATED_MAIN_H__ |
27 | |
28 | #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) |
29 | #error "Only <glib.h> can be included directly." |
30 | #endif |
31 | |
32 | #include <glib/gmain.h> |
33 | |
34 | G_BEGIN_DECLS |
35 | |
36 | /* ============== Compat main loop stuff ================== */ |
37 | |
38 | /** |
39 | * g_main_new: |
40 | * @is_running: set to %TRUE to indicate that the loop is running. This |
41 | * is not very important since calling g_main_run() will set this |
42 | * to %TRUE anyway. |
43 | * |
44 | * Creates a new #GMainLoop for th default main context. |
45 | * |
46 | * Returns: a new #GMainLoop |
47 | * |
48 | * Deprecated: 2.2: Use g_main_loop_new() instead |
49 | */ |
50 | #define g_main_new(is_running) g_main_loop_new (NULL, is_running) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_loop_new) |
51 | |
52 | /** |
53 | * g_main_run: |
54 | * @loop: a #GMainLoop |
55 | * |
56 | * Runs a main loop until it stops running. |
57 | * |
58 | * Deprecated: 2.2: Use g_main_loop_run() instead |
59 | */ |
60 | #define g_main_run(loop) g_main_loop_run(loop) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_loop_run) |
61 | |
62 | /** |
63 | * g_main_quit: |
64 | * @loop: a #GMainLoop |
65 | * |
66 | * Stops the #GMainLoop. |
67 | * If g_main_run() was called to run the #GMainLoop, it will now return. |
68 | * |
69 | * Deprecated: 2.2: Use g_main_loop_quit() instead |
70 | */ |
71 | #define g_main_quit(loop) g_main_loop_quit(loop) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_loop_quit) |
72 | |
73 | /** |
74 | * g_main_destroy: |
75 | * @loop: a #GMainLoop |
76 | * |
77 | * Frees the memory allocated for the #GMainLoop. |
78 | * |
79 | * Deprecated: 2.2: Use g_main_loop_unref() instead |
80 | */ |
81 | #define g_main_destroy(loop) g_main_loop_unref(loop) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_loop_unref) |
82 | |
83 | /** |
84 | * g_main_is_running: |
85 | * @loop: a #GMainLoop |
86 | * |
87 | * Checks if the main loop is running. |
88 | * |
89 | * Returns: %TRUE if the main loop is running |
90 | * |
91 | * Deprecated: 2.2: Use g_main_loop_is_running() instead |
92 | */ |
93 | #define g_main_is_running(loop) g_main_loop_is_running(loop) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_loop_is_running) |
94 | |
95 | /** |
96 | * g_main_iteration: |
97 | * @may_block: set to %TRUE if it should block (i.e. wait) until an event |
98 | * source becomes ready. It will return after an event source has been |
99 | * processed. If set to %FALSE it will return immediately if no event |
100 | * source is ready to be processed. |
101 | * |
102 | * Runs a single iteration for the default #GMainContext. |
103 | * |
104 | * Returns: %TRUE if more events are pending. |
105 | * |
106 | * Deprecated: 2.2: Use g_main_context_iteration() instead. |
107 | */ |
108 | #define g_main_iteration(may_block) g_main_context_iteration (NULL, may_block) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_context_iteration) |
109 | |
110 | /** |
111 | * g_main_pending: |
112 | * |
113 | * Checks if any events are pending for the default #GMainContext |
114 | * (i.e. ready to be processed). |
115 | * |
116 | * Returns: %TRUE if any events are pending. |
117 | * |
118 | * Deprecated: 2.2: Use g_main_context_pending() instead. |
119 | */ |
120 | #define g_main_pending() g_main_context_pending (NULL) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_context_pending) |
121 | |
122 | /** |
123 | * g_main_set_poll_func: |
124 | * @func: the function to call to poll all file descriptors |
125 | * |
126 | * Sets the function to use for the handle polling of file descriptors |
127 | * for the default main context. |
128 | * |
129 | * Deprecated: 2.2: Use g_main_context_set_poll_func() again |
130 | */ |
131 | #define g_main_set_poll_func(func) g_main_context_set_poll_func (NULL, func) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_context_set_poll_func) |
132 | |
133 | G_END_DECLS |
134 | |
135 | #endif /* __G_DEPRECATED_MAIN_H__ */ |
136 | |