gnome-std-options.5(5) Standards, Environments, and Macros gnome-std-options.5(5)
NAME
gnome-std-options - standard options available for most GNOME applications
DESCRIPTION
A number of GNOME standard options are available for most GNOME applications. These options are based on GTK+, libbonobo, and libgnome.
OPTIONS
The following options are supported:
--class=class Set the class of a GTK+ program, for use by the window manager.
--disable-crash-Disable the crash dialog.
--disable-sound Disable sound server usage.
--display=displaSpecify an X Display to use, where display is in the following format:
hostname:displaynumber.screennumber
--enable-sound Enable sound server usage.
--espeaker=hostnSpecifytthe location of the sound server to use.
--g-fatal-warninMake all GTK+ warnings fatal. This will cause the application to be killed when a warning is issued, rather than reporting
this warning to sdterr.
--gdk-debug=flagSpecify a list of GDK debug flags to set, in addition to those specified in the GDK_DEBUG environment variable. This option
is only available if GTK+ has been configured with the --enable-debug=yes option. Valid flags values are as follows:
o colormap
o cursor
o dnd
o events
o gc
o gdkrgb
o image
o input
o misc
o
multihead
o nograbs
o pixmap
o xim
For more information, please refer to the GTK+ source code.
--gdk-no-debug=fSpecify a list of GDK debug flags to unset. This option is only available if GTK+ has been configured with the --enable-
debug=yes option. Valid flags values are the same as for the --gdk-debug option. For more information, please refer to the
GTK+ source code.
--geometry=geomeSpecify the X geometry location for the application being launched, where geometry is in the following format:
widthxheight+xoff+yoff
--gtk-debug=flagSpecify a list of GTK+ options to set, in addition to those specified in the GTK_DEBUG environment variable. This option is
only available if GTK+ has been configured with the --enable-debug=yes option. Valid flags values are as follows:
o keybindings
o misc
o multihead
o plugsocket
o text
o tree
o updates
For more information, please refer to the GTK+ source code.
--gtk-module=modSpecify a list of GTK+ modules to load, in addition to those specifed in the GTK_MODULES environment variable.
--gtk-no-debug=fSpecify a list of GTK+ options to unset. This option is only available if GTK+ has been configured with --enable-debug=yes
option. Valid flags values are the same as for the --gtk-debug option. For more information, please refer to the GTK+
source code.
--gxid-host=hostSpecify a host on which to connect the gxid daemon. This option overrides the GXID_HOST environment variable. This option
is only available if GTK+ has been configured with the --gdk-target=x11 option. gxid is the GNOME X Input Daemon, which is
distributed as part of GTK+.
--gxid-port=portSpecify a port for the connection to the gxid daemon. This option overrides the GXID_PORT environment variable. This option
is only available if GTK+ has been configured with the --gdk-target=x11 option. gxid is the GNOME X Input Daemon, which is
distributed as part of GTK+.
--help Display detailed usage message. You can also use -? to specify this option.
--name=name Set the name of a GTK+ program, for use by the window manager.
--oaf-activate-iSpecify an IID to activate.
--oaf-ior-fd=fd Specify a File Descriptor on which to print IOR.
--oaf-private Prevent registering of server with OAF.
--screen=screen Specify an X Screen to use. This is only useful if more than one physical monitor is available. The default screen is 0.
screen is an integer value in the range 0 to {NumberOfScreens - 1}.
--sm-client-id=iSpecify a session management ID.
--sm-config-prefSpecifyithe prefix of a saved configuration.
--sm-disable Disable the connection to the session manager.
--sync Specify that requests to the X Server should be sent synchronously. By default, such requests are sent asynchronously. This
option is generally used when debugging an application, and should not be used in normal execution.
--usage Display a brief usage message.
--version Print the version information for the command. You can also use -v to specify this option.
EXAMPLES
Example 1: Getting gnome-calculator usage
example% gnome-calculator -usage
Example 2: Launching ghex2 on host "Labrynth" with display 0 and screen 0
example% ghex2 --display=Labrynth:0.0
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment variables:
DISPLAY X Display on which the application should display.
GDK_DEBUG If GTK+ has been configured with the --enable-debug=yes option, this variable can be set to a list of debug options
that should be set for GDK.
GTK_DEBUG If GTK+ has been configured with the --enable-debug=yes option, this variable can be set to a list of debug options
that should be set for GTK.
GTK_MODULES A list of GTK+ modules to load.
GTK_PATH A list of directories to search when GTK+ is looking for dynamically loaded objects.
GXID_HOST Host to which the gxid daemon should connect.
GXID_PORT Port for the connection to the gxid daemon.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWgnome-* |
+-----------------------------+-----------------------------+
|Interface stability |External |
+-----------------------------+-----------------------------+
SEE ALSO
X(5), metacity(1), gtk-x11-2.0(1), gdk-x11-2.0(1), attributes(5), environ(5), libbonoboui(3), libbonobo-2(3), libbonobo-activation(3),
gnome-session(1), libgnome-2(3), libesd(3)
GTK+ source code
Latest version of the GNOME Desktop User Guide for your platform.
NOTES
Written by Matt Keenan, Sun Microsystems Inc., 2003.
SunOS 5.10 9 Jan 2003 gnome-std-options.5(5)