1 The GLIB, GDK, and GTK libraries have extensive support for
2 debugging the library and your programs.
4 The amount of debugging being done can be determined both
5 at run time and compile time.
10 At compile time, the amount of debugging support included is
11 determined by four macros:
14 If set, enable support for runtime checking.
17 If set, disable g_assert macros
20 If set, disable the g_return_if_fail and g_return_val_if_fail macros
23 If set, don't check casts between different object types
26 Whether these macros are defined is controlled at configuration
27 time by the --enable-debug option.
29 --enable-debug=minimum [default]
30 Enable only inexpensive sanity checking
31 sets GTK_NO_CHECK_CASTS
34 Enable all debugging support
37 --enable-debug=no (or --disable-debug)
38 Disable all debugging support (fastest)
39 sets G_DISABLE_ASSERT, G_DISABLE_CHECKS, and GTK_NO_CHECK_CASTS
45 At run time, if GTK+ was compiled with debugging enabled, different
46 types of debugging information can be printed out. This is controlled
49 GTK_DEBUG and GDK_DEBUG environment variables
50 --gtk-debug and --gdk-debug command line options
51 --gtk-no-debug and --gdk-no-debug command line options
53 First the environment variables are applied, then the command line
54 options are applied in the order given on the command line.
56 Each of these can either be the special value 'all', or a sequence of
57 ':' separated options. (case is ignored). The environment variables
58 and the --gtk-debug and --gdk-debug options add debugging options and
59 the --gtk-no-debug and --gdk-no-debug options remove them.
61 As noted below, some of these are useful in application debugging, but
62 most are only interested to those debugging the libraries
66 GDK_DEBUG_FLAGS=misc:dnd testgtk --gdk-no-debug dnd --gdk-debug events
68 runs testgtk with the 'misc' and 'events' debugging options.
70 See glib/docs/debugging.txt for information about debugging signal emission
71 and the object system.
77 Application relevant options:
79 'events' - Show all events received by GTK
81 Options only interesting to library maintainers:
83 'misc' - Miscellaneous information
84 'dnd' - Information about drag-and-drop
85 'xim' - Information about X Input Method support
91 Options only interesting to library maintainers:
93 'misc' - Miscellaneous information
94 'text' - Information about text widget internals
95 'tree' - Information about tree widget internals
96 'updates' - Visual feedback about window updates
99 - Owen Taylor <owt1@cornell.edu>