10139N/A<!
DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
10139N/A<!--ArborText, Inc., 1988-1999, v.4002-->
10139N/A<!
ENTITY cmd "gnome-std-options">
11913N/A<!
ENTITY suncopy "Copyright (c) 2003,2006,2007 Sun Microsystems, Inc. All Rights Reserved.">
10139N/A<
refentry id="gnome-std-options-5">
10139N/A<
refmeta><
refentrytitle>gnome-std-options.5</
refentrytitle><
manvolnum>5</
manvolnum>
11913N/A<
refmiscinfo class="date">12 Nov 2007</
refmiscinfo>
10139N/A<
refmiscinfo class="sectdesc">&man5;</
refmiscinfo>
10139N/A<
refmiscinfo class="software">&release;</
refmiscinfo>
10139N/A<
refmiscinfo class="arch">generic</
refmiscinfo>
10139N/A<
refmiscinfo class="copyright">&suncopy;</
refmiscinfo>
10139N/A<
indexterm><
primary>gnome-std-options</
primary></
indexterm><
indexterm><
primary>
10139N/Astandard options available for most GNOME applications</
primary></
indexterm>
10139N/A<
refnamediv id="gnome-std-options-5-name"><
refname>gnome-std-options</
refname><
refpurpose>
10139N/Astandard options available for most GNOME applications</
refpurpose></
refnamediv>
10139N/A<
refsect1 id="gnome-std-options-5-desc"><
title>&desc-tt;</
title>
11913N/AGNOME standard options which are available for most GNOME based
11913N/Aapplications. Some of these options are only available if the program
11913N/Amakes use of various GNOME interfaces such as GTK+, Bonobo Activation,
11913N/A<
filename>libgnome</
filename>, <
filename>libgnomeui</
filename>,
11913N/Aor GNOME session. Use the <
option>-help</
option> option to see which
11913N/Aarguments are supported by any given program.
10139N/A<
refsect1 id="gnome-std-options-5-opts"><
title>&opts-tt;</
title>
10139N/A<
para>The following options are supported:</
para>
11913N/A<
variablelist termlength="wholeline">
11913N/A<
term><
option>?</
option>, <
option>-help</
option></
term>
11913N/A<
term><
option>-help-all</
option></
term>
11913N/A<
term><
option>-usage</
option></
term>
11913N/A<
para>The following GTK+ options are supported.</
para>
11913N/A<
term><
option>-help-gtk</
option></
term>
11913N/A<
term><
option>-class=<
replaceable>class</
replaceable></
option></
term>
11913N/ASet the class of a GTK+ program, for use by the window manager.
11913N/A<
term><
option>-display=<
replaceable>display</
replaceable></
option></
term>
11913N/ASpecify an X Display to use, where <
replaceable>display</
replaceable>
11913N/A<
replaceable>hostname</
replaceable>:<
replaceable>displaynumber</
replaceable>.<
replaceable>
11913N/A<
term><
option>-g-fatal-warnings</
option></
term>
10139N/AMake all GTK+ warnings fatal. This will cause the application to be killed
11913N/Awhen a warning is issued, rather than reporting this warning to
11913N/A<
term><
option>-gdk-debug=<
replaceable>flags</
replaceable></
option></
term>
11913N/ASpecify a list of GDK debug flags to set, in addition to those specified in the
11913N/AGDK_DEBUG environment variable. This option is only available if GTK+ has been
11913N/Aconfigured with the <
option>-enable-debug=yes</
option> option. Valid
11913N/A<
replaceable>flags</
replaceable> values are as follows:<
itemizedlist>
11913N/AFor more information, please refer to the GTK+ source code.
11913N/A<
term><
option>-gdk-no-debug=<
replaceable>flags</
replaceable></
option></
term>
11913N/ASpecify a list of GDK debug flags to unset. This option is only available if
11913N/AGTK+ has been configured with the <
option>-enable-debug=yes</
option> option.
11913N/AValid <
replaceable>flags</
replaceable> values are the same as for the
11913N/A<
option>-gdk-debug</
option> option. For more information, please refer to
11913N/A<
term><
option>-gtk-debug=<
replaceable>flags</
replaceable></
option></
term>
11913N/ASpecify a list of GTK+ options to set, in addition to those specified in the
11913N/AGTK_DEBUG environment variable. This option is only available if GTK+ has
11913N/Abeen configured with the <
option>-enable-debug=yes</
option> option. Valid
11913N/A<
replaceable>flags</
replaceable> values are as follows:<
itemizedlist>
11913N/A<
listitem><
para>icontheme</
para>
10139N/A<
listitem><
para>keybindings</
para>
10139N/A<
listitem><
para>multihead</
para>
10139N/A<
listitem><
para>plugsocket</
para>
11913N/AFor more information, please refer to the GTK+ source code.
11913N/A<
term><
option>-gtk-no-debug=<
replaceable>flags</
replaceable></
option></
term>
11913N/ASpecify a list of GTK+ options to unset. This option is only available if
11913N/AGTK+ has been configured with <
option>-enable-debug=yes</
option> option.
11913N/AValid <
replaceable>flags</
replaceable> values are the same as for the
11913N/A<
option>-gtk-debug</
option> option. For more information, please refer
11913N/A<
term><
option>-gtk-module=<
replaceable>module</
replaceable></
option></
term>
11913N/ASpecify a list of GTK+ modules to load, in addition to those specifed in the
11913N/AGTK_MODULES environment variable.
11913N/A<
term><
option>-gxid-host=<
replaceable>host</
replaceable></
option></
term>
11913N/ASpecify a host on which to connect the <
filename>gxid</
filename> daemon.
11913N/AThis option overrides the GXID_HOST environment variable. This option is
11913N/Aonly available if GTK+ has been configured with the
11913N/A<
option>-gdk-target=x11</
option> option. <
filename>gxid</
filename> is
11913N/Athe GNOME X Input Daemon, which is distributed as part of GTK+.
11913N/A<
term><
option>-gxid-port=<
replaceable>port</
replaceable></
option></
term>
11913N/ASpecify a port for the connection to the <
filename>gxid</
filename> daemon.
11913N/AThis option overrides the GXID_PORT environment variable. This option is
11913N/Aonly available if GTK+ has been configured with the
11913N/A<
option>-gdk-target=x11 </
option> option. <
filename>gxid</
filename> is
11913N/Athe GNOME X Input Daemon, which is distributed as part of GTK+.
11913N/A<
term><
option>-name=<
replaceable>name</
replaceable></
option></
term>
11913N/ASet the name of a GTK+ program, for use by the window manager.
11913N/A<
term><
option>-screen=<
replaceable>screen</
replaceable></
option></
term>
11913N/ASpecify an X Screen to use. This is only useful if more than one
11913N/Aphysical monitor is available. The default screen is 0.
11913N/A<
replaceable>screen</
replaceable> is an integer value in the range
11913N/A<
term><
option>-sync</
option></
term>
11913N/ASpecify that requests to the X Server should be sent synchronously.
11913N/ABy default, such requests are sent asynchronously. This option is
11913N/Agenerally used when debugging an application, and should not be
11913N/A<
para>The following Bonobo Activation options are supported.</
para>
11913N/A<
term><
option>-help-bonobo-activation</
option></
term>
11913N/ADisplay Bonobo Activation help options.
11913N/A<
term><
option>-oaf-activate-iid=<
replaceable>iid</
replaceable></
option></
term>
11913N/A<
term><
option>-oaf-ior-fd=<
replaceable>fd</
replaceable></
option></
term>
11913N/ASpecify a File Descriptor on which to print IOR.
11913N/A<
term><
option>-oaf-private</
option></
term>
11913N/APrevent registering of server with OAF.
11913N/A<
para>The following GNOME options are supported.</
para>
11913N/A<
term><
option>-help-gnome</
option></
term>
11913N/A<
term><
option>-disable-sound</
option></
term>
11913N/A<
term><
option>-enable-sound</
option></
term>
11913N/A<
term><
option>-espeaker=<
replaceable>hostname</
replaceable>:<
replaceable>port</
replaceable></
option></
term>
11913N/ASpecify the location of the sound server to use.
11913N/A<
term><
option>-version</
option></
term>
11913N/APrint the version information for the command. You can also use
11913N/A<
option>v</
option> to specify this option.
11913N/A<
para>The following GNOME GUI options are supported.</
para>
11913N/A<
term><
option>-help-gnome-ui</
option></
term>
11913N/A<
term><
option>-disable-crash-dialog</
option></
term>
11913N/A<
para>The following GNOME session options are supported.</
para>
11913N/A<
term><
option>-help-gnome-session</
option></
term>
11913N/ADisplay session management help options.
11913N/A<
term><
option>-sm-client-id=<
replaceable>id</
replaceable></
option></
term>
11913N/ASpecify a session management ID.
11913N/A<
term><
option>-sm-config-prefix=<
replaceable>prefix</
replaceable></
option></
term>
11913N/ASpecify the prefix of a saved configuration.
11913N/A<
term><
option>-sm-disable</
option></
term>
11913N/ADisable the connection to the session manager.
11913N/A<
para>Common application options that are supported.</
para>
11913N/A<
term><
option>-geometry=<
replaceable>geometry</
replaceable></
option></
term>
11913N/ASpecify the X geometry location for the application being launched, where
11913N/A<
replaceable>geometry</
replaceable> is in the following format:
11913N/A<
replaceable>width</
replaceable>x<
replaceable>height</
replaceable>+<
replaceable>
11913N/Axoff</
replaceable>+<
replaceable>yoff</
replaceable>
10139N/A<
refsect1 id="gnome-std-options-5-exam"><
title>&exam-tt;</
title>
10139N/A<
example role="example"><
title>Getting gnome-calculator usage</
title>
10139N/A<
para><
screen>example% <
userinput>gnome-calculator -usage</
userinput></
screen></
para>
10139N/A<
example role="example"><
title>Launching ghex2 on host "Labrynth" with display
10139N/A<
para><
screen>example% <
userinput>ghex2 --display=Labrynth:0.0</
userinput></
screen></
para>
10139N/A<
refsect1 id="gnome-std-options-5-envr"><
title>&envr-tt;</
title>
10139N/A<
para>See <
citerefentry><
refentrytitle>environ</
refentrytitle><
manvolnum>
10139N/A5</
manvolnum></
citerefentry> for descriptions of the following environment
11913N/AX Display on which the application should display.
11913N/AThis variable can be set to a list of debug options.
11913N/ASet to fatal_warnings to make programs abort at the first call to
11913N/ASet to fatal_criticals to abort at the first call to g_critical().
11913N/ASet to gc-friendly to cause newly allocated memory that isn't directly
11913N/Ainitialized, as well as memory being freed to be reset to 0.
11913N/ASet to resident-modules to cause all modules loaded by GModule to be
11913N/Amade resident. Set to bind-now-modules to cause all modules loaded
11913N/Aby GModule to bind their symbols at load time, even if the code uses
11913N/AIf GTK+ has been configured with the <
option>-enable-debug=yes</
option>
11913N/Aoption, this variable can be set to a list of debug options that should
11913N/Abe set for GDK. Refer to the <
option>-gdk-option</
option> option for more
11913N/AIf GTK+ has been configured with the <
option>-enable-debug=yes</
option>
11913N/Aoption, this variable can be set to a list of debug options that should
11913N/Abe set for GTK. Refer to the <
option>-gtk-debug</
option> option for for
11913N/AA list of directories to search when GTK+ is looking for dynamically
11913N/Aloaded objects such as the modules specified by GTK_MODULES,
11913N/Atheme engines, input method modules, file system backends, and
11913N/AHost to which the <
filename>gxid</
filename> daemon should connect.
11913N/APort for the connection to the <
filename>gxid</
filename> daemon.
10139N/A<
refsect1 id="gnome-std-options-5-attr"><
title>&attr-tt;</
title>
10139N/A<
para>See <
olink targetdocent="REFMAN5" localinfo="attributes-5"><
citerefentry>
10139N/A<
refentrytitle>attributes</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry></
olink>
10139N/Afor descriptions of the following attributes:</
para>
10139N/A<
tgroup cols="2" colsep="1" rowsep="1"><
colspec colname="COLSPEC0" colwidth="1*">
10139N/A<
colspec colname="COLSPEC1" colwidth="1*">
10139N/A<
row><
entry align="center" valign="middle">ATTRIBUTE TYPE</
entry><
entry align="center" 10139N/Avalign="middle">ATTRIBUTE VALUE</
entry></
row>
10139N/A<
row><
entry><
para>Availability</
para></
entry><
entry><
para>SUNWgnome-*</
para></
entry>
10139N/A<
row><
entry colname="COLSPEC0"><
para>Interface stability</
para></
entry><
entry 10139N/Acolname="COLSPEC1"><
para>Volatile</
para></
entry></
row>
10139N/A<
refsect1 id="gnome-std-options-5-also"><
title>&also-tt;</
title>
10139N/A<!--Reference to another man page--> 10139N/A<!--Reference to a Help manual--> 10139N/A<
citerefentry><
refentrytitle>gnome-session</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>libbonobo-activation</
refentrytitle><
manvolnum>3</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>libgdk-x11-2.0</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>,
11913N/A<
citerefentry><
refentrytitle>libglib-2.0</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>libgnome-2</
refentrytitle><
manvolnum>3</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>libgnomeui-2</
refentrytitle><
manvolnum>3</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>libgtk-x11-2.0</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>attributes</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>environ</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>,
11913N/A<
citerefentry><
refentrytitle>gnome-interfaces</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>X</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>
10139N/A<
para>Latest version of the <
citetitle>GNOME Desktop User Guide</
citetitle> for your platform.</
para>
10139N/A<
refsect1 id="gnome-std-options-5-note"><
title>¬e-tt;</
title>
11933N/A<
para>Written by Matt Keenan, Sun Microsystems Inc., 2003, 2006, 2007.</
para>