<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY cmd "gnome-appearance-properties">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2003,2007,2009 Sun Microsystems, Inc. All Rights Reserved.">
]>
<refentry id="gnome-appearance-properties-1">
<!-- %Z%%M% %I% %E% SMI; -->
<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 GNOME desktop appearance</primary></indexterm>
<refnamediv id="gnome-appearance-properties-1-name">
<refname>&cmd;</refname>
<refpurpose>configure GNOME desktop appearance</refpurpose>
</refnamediv>
<refsynopsisdiv id="gnome-appearance-properties-1-synp">
<title>&synp-tt;</title>
<cmdsynopsis>
<command>&cmd;</command>
<arg choice="opt"><option>-install-theme=<replaceable>file</replaceable></option></arg>
<arg choice="opt"><option>-show-page=<replaceable>page</replaceable></option></arg>
<arg choice="opt"><option role="nodash"><replaceable>gnome-std-options</replaceable></option></arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1 id="gnome-appearance-properties-1-desc"><title>&desc-tt;</title>
<para>
The GNOME appearance preference tool enables you to select how your GNOME
desktop is themed.  The theme controls the appearance of GNOME-compliant
application interface items. For example, the theme affects the appearance of
buttons, scrollbar, check boxes, and so on.  This preference tool can also be
used to configure the background image, fonts used by the desktop, how 
menus and toolbars behave, and what visual effects are used.
</para>
</refsect1>

<refsect1 id="gnome-appearance-properties-1-opts"><title>&opts-tt;</title>
<para>
The following options are supported:
</para>

<variablelist termlength="wide">
<varlistentry>
<term><option>i</option>, <option>-install-theme=<replaceable>file</replaceable></option></term>
<listitem><para>
Installs the specified theme <replaceable>file</replaceable>.
</para></listitem>
</varlistentry>

<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>theme</replaceable>,
<replaceable>background</replaceable>,
<replaceable>fonts</replaceable>, or
<replaceable>interface</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>
for more information.
</para></listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 id="gnome-appearance-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-appearance-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-appearance-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-appearance-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-appearance-properties-1-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<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>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>
<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>

<refsect1 id="gnome-appearance-properties-1-note"><title>&note-tt;</title>
<para>
Written by Glynn Foster, updated by Brian Cameron, Sun Microsystems Inc.,
2003, 2007, 2009.
</para>
</refsect1>
</refentry>
