mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-09-20 22:10:40 +00:00
84 lines
2.2 KiB
Plaintext
84 lines
2.2 KiB
Plaintext
|
The GLIB, GDK, and GTK libraries have extensive support for
|
||
|
|
debugging the library and your programs.
|
||
|
|
|
||
|
|
The amount of debugging being done can be determined both
|
||
|
|
at run time and compile time.
|
||
|
|
|
||
|
|
COMPILE TIME OPTIONS
|
||
|
|
--------------------
|
||
|
|
|
||
|
|
At compile time, the amount of debugging support included is
|
||
|
|
determined by four macros:
|
||
|
|
|
||
|
|
G_ENABLE_DEBUG
|
||
|
|
If set, enable support for runtime checking.
|
||
|
|
|
||
|
|
G_DISABLE_ASSERT
|
||
|
|
If set, disable g_assert macros
|
||
|
|
|
||
|
|
G_DISABLE_CHECKS
|
||
|
|
If set, disable the g_return_if_fail and g_return_val_if_fail macros
|
||
|
|
|
||
|
|
GTK_NO_CHECK_CASTS
|
||
|
|
If set, don't check casts between different object types
|
||
|
|
|
||
|
|
|
||
|
|
Whether these macros are defined is controlled at configuration
|
||
|
|
time by the --enable-debug option.
|
||
|
|
|
||
|
|
--enable-debug=minimum [default]
|
||
|
|
Enable only inexpensive sanity checking
|
||
|
|
sets GTK_NO_CHECK_CASTS
|
||
|
|
|
||
|
|
--enable-debug=yes
|
||
|
|
Enable all debugging support
|
||
|
|
sets G_ENABLE_DEBUG
|
||
|
|
|
||
|
|
--enable-debug=no (or --disable-debug)
|
||
|
|
Disable all debugging support (fastest)
|
||
|
|
sets G_DISABLE_ASSERT, G_DISABLE_CHECKS, and GTK_NO_CHECK_CASTS
|
||
|
|
|
||
|
|
|
||
|
|
RUN TIME OPTIONS
|
||
|
|
----------------
|
||
|
|
|
||
|
|
At run time, if GTK+ was compiled with debugging enabled,
|
||
|
|
different types of debugging information can be printed
|
||
|
|
out by setting the --gtk-debug and --gdk-debug command line
|
||
|
|
options, or the GTK_DEBUG and GDK_DEBUG environment
|
||
|
|
variables. (The command line options override the environment
|
||
|
|
variables)
|
||
|
|
|
||
|
|
Each of these can either be the special value ALL,
|
||
|
|
or a sequence of ':' separated options. (Note, case is
|
||
|
|
significant)
|
||
|
|
|
||
|
|
As noted below, some of these are useful in application
|
||
|
|
debugging, but most are only interested to those debugging
|
||
|
|
the libraries
|
||
|
|
|
||
|
|
GTK_DEBUG
|
||
|
|
---------
|
||
|
|
|
||
|
|
Application relevant options:
|
||
|
|
|
||
|
|
'objects' - Trace the creation and destruction of objects, print
|
||
|
|
out a summary at program termination
|
||
|
|
|
||
|
|
Options only interesting to library maintainers:
|
||
|
|
|
||
|
|
GDK_DEBUG
|
||
|
|
---------
|
||
|
|
|
||
|
|
Application relevant options:
|
||
|
|
|
||
|
|
'events' - Show all events received by GTK
|
||
|
|
|
||
|
|
Options only interesting to library maintainers:
|
||
|
|
|
||
|
|
'misc' - Miscellaneous information
|
||
|
|
'dnd' - Information about drag-and-drop
|
||
|
|
'color-context' - Information about the internal workings of
|
||
|
|
GdkColorContext
|
||
|
|
'xim' - Information about X Input Method support
|