<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!ENTITY cmd "gnome-default-applications-properties">

<!ENTITY % commonents SYSTEM "smancommon.ent">

%commonents;

<!ENTITY % booktitles SYSTEM "booktitles.ent">

%booktitles;

<!ENTITY suncopy "Copyright (c) 2003,2006,2007,2009 Sun Microsystems, Inc. All Rights Reserved.">

]>

<refentry id="gnome-default-applications-properties-1">

<refmeta>

<refentrytitle>&cmd;</refentrytitle><manvolnum>1</manvolnum>

<refmiscinfo class="date">19 Nov 2009</refmiscinfo>

<refmiscinfo class="sectdesc">&man1;</refmiscinfo>

<refmiscinfo class="software">&release;</refmiscinfo>

<refmiscinfo class="arch">generic</refmiscinfo>

<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

</refmeta>

<indexterm><primary>&cmd;</primary></indexterm>

<indexterm><primary>configure default GNOME applications</primary></indexterm>

<refnamediv id="gnome-default-applications-properties-1-name">

<refname>&cmd;</refname>

<refpurpose>configure default GNOME applications</refpurpose>

</refnamediv>

<refsynopsisdiv id="gnome-default-applications-properties-1-synp">

<title>&synp-tt;</title>

<cmdsynopsis>

<command>&cmd;</command>

<arg choice="opt"><option>-show-page=<replaceable>page</replaceable></option></arg>

<arg><option role="nodash"><replaceable>gnome-std-options</replaceable></option></arg>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1 id="gnome-default-applications-properties-1-desc">

<title>&desc-tt;</title>

<para>

The GNOME preferred applications preference tool enables you to specify the

applications that you would like to use when particular types of programs

are to be started. It supports the ability to set your default web browser,

mail reader, multimedia player, terminal program, and accessibility programs.

For example, you can specify

<citerefentry><refentrytitle>xterm</refentrytitle>

<manvolnum>1</manvolnum></citerefentry>

as your preferred terminal application. Then when you choose "Open Terminal"

in the Desktop Background menu, the

<citerefentry><refentrytitle>xterm</refentrytitle>

<manvolnum>1</manvolnum></citerefentry>

application will be started.

</para>

</refsect1>

<refsect1 id="gnome-default-applications-properties-1-opts">

<title>&opts-tt;</title>

<para>

The following options are supported:

</para>

<variablelist termlength="wide">

<varlistentry>

<term><option>p</option>, <option>-show-page=<replaceable>page</replaceable></option></term>

<listitem><para>

Specify the <replaceable>page</replaceable>, or tab, to display. The

value can be:

<replaceable>internet</replaceable>,

<replaceable>multimedia</replaceable>,

<replaceable>system</replaceable>, or

<replaceable>a11y</replaceable>.

</para></listitem>

</varlistentry>

<varlistentry>

<term><option role="nodash"><replaceable>gnome-std-options</replaceable></option></term>

<listitem><para>

Standard options available for use with most GNOME applications. See

<citerefentry><refentrytitle>gnome-std-options</refentrytitle>

<manvolnum>5</manvolnum></citerefentry>.

</para></listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1 id="gnome-default-applications-properties-1-exam">

<title>&exam-tt;</title>

<example role="example"><title>Launching the <command>&cmd;</command> tool</title>

<para><screen>example% <userinput>&cmd;</userinput></screen></para>

</example>

</refsect1>

<refsect1 id="gnome-default-applications-properties-1-exit">

<title>&exit-tt;</title>

<para>

The following exit values are returned:

</para>

<variablelist termlength="xtranarrow"><varlistentry>

<term><returnvalue>0</returnvalue></term>

<listitem><para>

Application exited successfully

</para></listitem>

</varlistentry>

<varlistentry>

<term><returnvalue>>0</returnvalue></term>

<listitem><para>

Application exited with failure

</para></listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1 id="gnome-default-applications-properties-1-file">

<title>&file-tt;</title>

<para>

The following files are used by this application:

</para>

<variablelist termlength="wholeline">

<varlistentry>

<term><filename>/usr/bin/&cmd;</filename></term>

<listitem><para>

Executable for <command>&cmd;</command>.

</para></listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1 id="gnome-default-applications-properties-1-attr">

<title>&attr-tt;</title>

<para>

See <olink targetdocent="REFMAN5" localinfo="attributes-5">

<citerefentry><refentrytitle>attributes</refentrytitle>

<manvolnum>5</manvolnum></citerefentry></olink>

for descriptions of the following attributes:

</para>

<informaltable frame="all">

<tgroup cols="2" colsep="1" rowsep="1">

<colspec colname="COLSPEC0" colwidth="1*">

<colspec colname="COLSPEC1" colwidth="1*">

<thead>

<row>

<entry align="center" valign="middle">ATTRIBUTE TYPE</entry>

<entry align="center" valign="middle">ATTRIBUTE VALUE</entry>

</row>

</thead>

<tbody>

<row>

<entry><para>Availability</para></entry>

<entry><para>gnome/preferences/control-center</para></entry>

</row>

<row>

<entry colname="COLSPEC0"><para>Interface stability</para></entry>

<entry colname="COLSPEC1"><para>Volatile</para></entry>

</row>

</tbody></tgroup></informaltable>

</refsect1>

<refsect1 id="gnome-default-applications-properties-1-also">

<title>&also-tt;</title>

<para><citetitle>Preference Tools Manual</citetitle></para>

<para>

Latest version of the <citetitle>GNOME Desktop User Guide</citetitle> for your

platform.

</para>

<para>

<citerefentry><refentrytitle>gnome-control-center</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>xterm</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,

<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>

</para>

</refsect1>

<refsect1 id="gnome-default-applications-properties-1-note">

<title>&note-tt;</title>

<para>

Written by Glynn Foster, updated by Brian Cameron, Sun Microsystems Inc., 2003,

2006, 2007, 2009.

</para>

</refsect1>

</refentry>