GTK+ Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
All GTK+ applications support a number of standard commandline options. These are removed from argv by gtk_init(). Modules may parse and remove further options.
--gtk-module module. A list of modules to load in addition to those specified in the GTK_MODULES environment variable.
--g-fatal-warnings. Make GTK+ abort on all warnings. This is useful to stop on the first warning in a debugger, if your application is printing multiple warnings. It's almost always best to start debugging with the first warning that occurs.
--gtk-debug options. A list of debug options to turn on in addition to those specified in the GTK_DEBUG environment variable. This option is only available if GTK+ has been configured with --enable-debug=yes.
--gtk-no-debug options. A list of debug options to turn off. This option is only available if GTK+ has been configured with --enable-debug=yes.
The following options are really used by GDK, not by GTK+, but we list them here for completeness nevertheless.
--class class. Sets the program class; see gdk_set_program_class().
--name name. Sets the program name.
--gdk-debug options. A list of debug options to turn on in addition to those specified in the GDK_DEBUG environment variable. This option is only available if GTK+ has been configured with --enable-debug=yes.
--gdk-no-debug options. A list of debug options to turn off. This option is only available if GTK+ has been configured with --enable-debug=yes.
--display display. The name of the X display to open instead of the one specified in the DISPLAY. This option is only available if GTK+ has been configured with --gdk-target=x11.
--sync. Makes all X requests synchronously. This is a useful option for debugging, but it will slow down the performance considerably. This option is only available if GTK+ has been configured with --gdk-target=x11.
--gxid-host host. The host to contact the gxid daemon on; overwrites the GXID_HOST environment variable. This option is only available if GTK+ has been configured with --gdk-target=x11.
--gxid-port port. The port for the connection to gxid; overwrites the GXID_PORT environment variable. This option is only available if GTK+ has been configured with --gdk-target=x11.
GTK+ inspects a number of environment variables in addition to standard variables like LANG, PATH, HOME or DISPLAY; mostly to determine paths to look for certain files.
GTK_MODULES. A list of modules to load.
GTK_MODULE_PATH. A list of directories to search for modules before the default module directory, which is <libdir>/gtk-2.0/modules. (If GTK_EXE_PREFIX is defined, <libdir> is $GTK_EXE_PREFIX/lib. Otherwise it is the libdir specified when GTK+ was configured, usually /usr/local/lib.) For each directory in the list, GTK+ actually looks first in a subdirectory named after the version number of GTK+, then in the directory itself and finally in the system-specific library path.
GTK_IM_MODULE. Specifies an IM module to use in preference to the one determined from the locale.
GTK_RC_FILES. Specifies a list of RC files to parse instead of the default ones; see Resource Files.
GTK_EXE_PREFIX. If set, GTK+ uses $GTK_EXE_PREFIX/lib instead of the libdir configured when GTK+ was compiled.
GTK_DATA_PREFIX. If set, makes GTK+ use $GTK_DATA_PREFIX instead of the prefix configured when GTK+ was compiled.
The following environment variables are used by GdkPixbuf, GDK or Pango, not by GTK+ itself, but we list them here for completeness nevertheless.
GDK_PIXBUF_MODULEDIR. Specifies the directory to look for GdkPixbuf loader modules. By default, GdkPixbuf looks for its loaders in <libdir>/gtk-2.0/<version>/loaders.
GDK_USE_XFT. If this variable is set to 1, GTK+ will use the Pango Xft backend instead of the X backend when possible (i.e. when the X server supports the XRender extension and Pango has been built with Xft support).