path: root/gnome2-user-guide/C/goscustdesk.xml

<chapter id="prefs">
  <title>Configuring Your Desktop</title>
  
  <!-- ids in this section are gradually being converted 
  to something like 'prefs-mouse'.
  remember to add an anchor for the old id in the right place -->

  <!-- Maintained for 2.8 compatibility -->
  <anchor id="goscustdesk-6"/>

  <!-- Desktop Overview / Desktop Preferences -->
  <anchor id="gosoverview-55"/>
  
  <!-- ids of sections removed from this document for 2.14 -->
  <anchor id="goscustdesk-10"/><!-- Customizing Your Panels -->

  <highlights>
    <para>This chapter describes how to use the preference tools to
customize the GNOME Desktop.</para>
  </highlights>
  <sect1 id="goscustaccess-11">
    <title>Assistive Technology Preferences</title>
    <indexterm>
      <primary>accessibility</primary>
      <secondary>setting assistive technology
preferences</secondary>
    </indexterm>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Assistive Technology</secondary>
    </indexterm>
    <para>Use the <application>Assistive Technology</application> preference tool to enable assistive technologies
in the GNOME Desktop. You can also use the <application>Assistive Technology</application> preference tool to specify assistive technology applications
to start automatically when you log in.</para>
    <para><xref linkend="goscustaccess-TBL-14"/> lists the assistive technology
preferences that you can modify.</para>
    <table frame="topbot" id="goscustaccess-TBL-14">
      <title>Assistive Technology Preferences</title>
      <tgroup cols="2" colsep="0" rowsep="0">
        <colspec colwidth="50*"/>
        <colspec colwidth="50*"/>
        <thead>
          <row rowsep="1">
            <entry>
              <para>Dialog Element</para>
            </entry>
            <entry>
              <para>Description</para>
            </entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry valign="top">
              <para>
                <guilabel>Enable assistive technologies</guilabel>
              </para>
            </entry>
            <entry valign="top">
              <para>Select this option to enable assistive technologies
in the GNOME Desktop. </para>
            </entry>
          </row>
          <row>
            <entry valign="top">
              <para>
                <guilabel>Screenreader</guilabel>
              </para>
            </entry>
            <entry valign="top">
              <para>Select this option to start the <application>Screenreader</application> application automatically when you log in.</para>
            </entry>
          </row>
          <row>
            <entry valign="top">
              <para>
                <guilabel>Magnifier</guilabel>
              </para>
            </entry>
            <entry valign="top">
              <para>Select this option to start the <application>Magnifier</application> application automatically when you log in.</para>
            </entry>
          </row>
          <row>
            <entry valign="top">
              <para>
                <guilabel>On-screen keyboard</guilabel>
              </para>
            </entry>
            <entry valign="top">
              <para>Select this option to start the <application>On-screen
keyboard</application> application automatically when you log in.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </sect1>
  <sect1 id="prefs-cddatabase">
    <title>CD Database Preferences</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="goscustlookandfeel-39"/>       
    <indexterm>
      <primary>preference tools</primary>
      <secondary>CD Database</secondary>
    </indexterm>
    <para>The <application>CD Database</application> preference tool
enables you to configure a CD database that your system can query. A CD database
contains information about CDs, such as the name of the artist, the title,
and the track list. When an application plays a CD, the application can query
the CD database about the CD, then display the information.</para>
    <para><xref linkend="goscustlookandfeel-TBL-40"/> describes the preferences in the <application>CD Database</application> preference tool.</para>
    <table frame="topbot" id="goscustlookandfeel-TBL-40">
      <title>CD Database Preferences</title>
      <tgroup cols="2" colsep="1" rowsep="1">
        <colspec colname="colspec0" colwidth="18.86*"/>
        <colspec colname="colspec1" colwidth="47.14*"/>
        <thead>
          <row>
            <entry colsep="0" rowsep="1">
              <para>Dialog Element</para>
            </entry>
            <entry colsep="0" rowsep="1">
              <para>Description</para>
            </entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Send no information</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Select this option if you do not want to send
any information to the CD database server.</para>
            </entry>
          </row>
          <row>
            <entry colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Send real information</guilabel>
              </para>
            </entry>
            <entry colsep="0" rowsep="0" valign="top">
              <para>Select this option to send your name and hostname information to the CD database
server.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Send other information</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Select this option to send another
name and hostname to the CD database server. Enter the name in the <guilabel>Name</guilabel> field. Enter the hostname in the <guilabel>Hostname</guilabel>
field.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>FreeDB round robin server</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>FreeDB is a CD database. The FreeDB
round robin server is a load-sharing configuration of FreeDB servers. Select
this option to access the FreeDB CD database from this server.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Other FreeDB server</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para> Select this option to access the FreeDB CD
database from another server. Select the server that you require from the
server table.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guibutton>Update Server List</guibutton>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Click on this button to update the list of available
FreeDB servers in the server table.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Other server</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Select this option to use another CD database.
Enter the name of the server on which the database resides in the <guilabel>Hostname</guilabel> field. Enter the port number on which you can access the
database in the <guilabel>Port</guilabel> field.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </sect1>   
  <sect1 id="goscustdesk-7">
    <title>Desktop Background Preferences</title>
    <indexterm>
      <primary>desktop</primary>
      <secondary>customizing background</secondary>
    </indexterm>
    <indexterm>
      <primary>GNOME Desktop preference tools</primary>
      <see>preference tools</see>
    </indexterm>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Background</secondary>
    </indexterm>
    <indexterm>
      <primary>backgrounds</primary>
      <secondary>customizing desktop background</secondary>
    </indexterm>
    <para>The desktop background is the image or color that is applied to your
desktop. You can customize the desktop background in the following ways:</para>
    <itemizedlist>
      <listitem>
        <para>Select an image for the desktop background. The image is superimposed
on the desktop background color. The desktop background color is visible if
you select a transparent image, or if the image does not cover the entire
desktop.</para>
      </listitem>
      <listitem>
        <para>Select a color for the desktop background. You can select
a solid color, or create a gradient effect with two colors. A gradient effect
is a visual effect where one color blends gradually into another color. </para>
      </listitem>
    </itemizedlist>
    <para>You can also change the appearance of your desktop background from within
the <application>Nautilus</application> file manager.</para>
    <para><xref linkend="goscustdesk-TBL-14"/> lists the background preferences
that you can modify.</para>
    <table frame="topbot" id="goscustdesk-TBL-14">
      <title>Desktop Background Preferences</title>
      <tgroup cols="2" colsep="1" rowsep="1">
        <colspec colname="colspec0" colwidth="18.86*"/>
        <colspec colname="colspec1" colwidth="47.14*"/>
        <thead>
          <row>
            <entry colsep="0" rowsep="1">
              <para>Dialog Element</para>
            </entry>
            <entry colsep="0" rowsep="1">
              <para>Description</para>
            </entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guibutton>Desktop Wallpaper</guibutton>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Choose an image from the list.  Alternately, you can select
<guibutton>Add Wallpaper</guibutton> to choose any image on your computer.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Style</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>To specify how to display the image, select one of the following
options from the <guilabel>Style</guilabel> drop-down list:</para>
              <itemizedlist>
                <listitem>
                  <para><guilabel>Centered</guilabel>: Displays the image in the middle
of the desktop.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Fill Screen</guilabel>: Enlarges the image to cover
the desktop and maintains the relative dimensions of the image.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Scaled</guilabel>: Enlarges the image until the
image meets the screen edges, and maintains the relative dimensions of the
image.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Tiled</guilabel>: Enlarges the image until the image
meets the screen edges, and maintains the relative dimensions of the image.</para>
                </listitem>
              </itemizedlist>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0">
              <para>
                <guilabel>Add Wallpaper</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0">
              <para/>
              <para>Click on <guilabel>Add Wallpaper</guilabel> to browse for
an image on your computer.  A standard file selector will be presented.  Choose
the image you want and click <guibutton>Open</guibutton>.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0">
              <para>
                <guilabel>Remove</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0">
              <para>Choose the <guibutton>Desktop Wallpaper</guibutton> that you want to remove,
then click <guilabel>Remove</guilabel>.  This removes the image from the list of available wallpapers; however, it does not delete the image from your computer.
</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Desktop Colors</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>To specify a color scheme, use  the options
in the <guilabel>Background Style</guilabel> drop-down list, and the color
selector buttons.</para>
              <para>You can specify a color scheme in one of the
following ways:</para>
              <itemizedlist>
                <listitem>
                  <para>Choose <guilabel>Solid color</guilabel> from the <guilabel>Background Style</guilabel> drop-down list to specify a single color for the
desktop background. </para>
                  <para>To choose the color that you require, click on the <guibutton>Color</guibutton>  button. The <guilabel>Pick a Color</guilabel> dialog is displayed.
Choose a color, then click <guibutton>OK</guibutton>.</para>
                </listitem>
                <listitem>
                  <para>Choose <guilabel>Horizontal gradient</guilabel> from the <guilabel>Background Style</guilabel> drop-down list. This option creates a gradient
effect from the left screen edge to the right screen edge.</para>
                  <para>Click on the <guibutton>Left Color</guibutton> button  to display the <guilabel>Pick a Color</guilabel> dialog. Choose the color that you want to appear at
the left edge.</para>
                  <para>Click on the <guibutton>Right Color</guibutton> button. Choose the color
that you want to appear at the right edge.</para>
                </listitem>
                <listitem>
                  <para>Choose <guilabel>Vertical gradient</guilabel> from the <guilabel>Background Style</guilabel> drop-down list. This creates a gradient effect
from the top   screen edge to the bottom screen edge.</para>
                  <para>Click on the <guibutton>Top Color</guibutton> button to display the <guilabel>Pick a Color</guilabel> dialog. Choose the color that you want to appear at
the top edge.</para>
                  <para>Click on the <guibutton>Bottom Color</guibutton> button. Choose the
color that you want to appear at the bottom edge.</para>
                </listitem>
              </itemizedlist>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </sect1>
  <sect1 id="goscustdesk-84">
    <title>File Management Preferences</title>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>File Management</secondary>
    </indexterm>
    <indexterm>
      <primary>file
manager</primary>
      <secondary>preferences</secondary>
      <tertiary>preference tool</tertiary>
    </indexterm>
    <para>Use the <application>File
Management</application> preference tool to set your <application>Nautilus</application>
file manager preferences. You can also set your file manager preferences in
the <guilabel>File Management</guilabel>  preferences
dialog, which you can open from the file manager application. For information
on the preferences in the <guilabel>File Management</guilabel> preferences dialog and <application>File Management</application>  preference tool, see
<xref linkend="gosnautilus-17"/>.</para>
  </sect1>
<!--
<sect1 id="goscustdesk-79">
<title>Customizing PalmOS Devices</title>
<indexterm><primary>preference tools</primary><secondary>PalmOS devices</secondary>
</indexterm><para>Information to be supplied in a future release.</para>
</sect1>
-->
  <sect1 id="goscustdesk-38">
    <title>Font Preferences</title>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Font</secondary>
    </indexterm>
    <indexterm>
      <primary>fonts</primary>
      <secondary>desktop</secondary>
    </indexterm>
    <indexterm>
      <primary>fonts</primary>
      <secondary>applications</secondary>
    </indexterm>
    <indexterm>
      <primary>fonts</primary>
      <secondary>window title</secondary>
    </indexterm>
    <indexterm>
      <primary>fonts</primary>
      <secondary>terminal</secondary>
    </indexterm>
    <indexterm>
      <primary>fonts</primary>
      <secondary>rendering</secondary>
    </indexterm>
    <para>Use the <application>Font</application> preference tool
to select the fonts to use in your applications, windows, terminals, and desktop.</para>
    <para><xref linkend="goscustdesk-TBL-26"/> lists the font preferences that
you can modify.</para>
    <table frame="topbot" id="goscustdesk-TBL-26">
      <title>Font Preferences</title>
      <tgroup cols="2" colsep="1" rowsep="1">
        <colspec colname="colspec18" colwidth="19.21*"/>
        <colspec colname="colspec19" colwidth="46.79*"/>
        <thead>
          <row>
            <entry colsep="0" rowsep="1">
              <para>Dialog Element</para>
            </entry>
            <entry colsep="0" rowsep="1">
              <para>Description</para>
            </entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Application
font</guilabel>
              </para>
            </entry>
            <entry colsep="0" rowsep="0" valign="top">
              <para>Click on the font selector button to select a font to use in your applications.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Desktop font</guilabel>
              </para>
            </entry>
            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
              <para>Click on the font selector button to select
a font to use on your desktop only.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Window title font</guilabel>
              </para>
            </entry>
            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
              <para>Click on the font selector button to select
a font to use in the titlebars of your windows.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Terminal font</guilabel>
              </para>
            </entry>
            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
              <para>Click on the font selector button to select
a font to use in the <application>Terminal</application> application</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Font Rendering</guilabel>
              </para>
            </entry>
            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
              <para>To specify how to render fonts on your screen,
select one of the following options:</para>
              <itemizedlist>
                <listitem>
                  <para><guilabel>Monochrome</guilabel>: Renders fonts in black and
white only. The edges of characters might appear jagged in some cases because
the characters  are not antialiased. <firstterm>Antialiasing</firstterm> is
an effect that is applied to the edges of characters to make the characters
look smoother.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Best shapes</guilabel>: Antialiases fonts where
possible. Use this option for standard Cathode Ray Tube (CRT) monitors.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Best contrast</guilabel>: Adjusts fonts to give
the sharpest possible contrast, and also antialiases fonts, so that characters
have smooth edges. This option might enhance the accessibility of the GNOME
Desktop to  users with visual impairments.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Subpixel smoothing (LCDs)</guilabel>: Uses techniques
that exploit the shape of individual Liquid Crystal Display (LCD) pixels to
render fonts smoothly. Use this option for LCD or flat-screen displays.</para>
                </listitem>
              </itemizedlist>
            </entry>
          </row>
          <row>
            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
              <para>
                <guibutton>Details</guibutton>
              </para>
            </entry>
            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
              <para>Click on this button to specify further details of how
to render fonts on your screen.</para>
              <itemizedlist>
                <listitem>
                  <para><guilabel>Resolution (dots per inch)</guilabel>: Use the spin
box to specify the resolution to use when your screen renders fonts.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Smoothing</guilabel>: Select one of the options
to specify how to antialias fonts.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Hinting</guilabel>:  <firstterm>Hinting</firstterm>
is a font-rendering technique that improves the quality of fonts at small
sizes and an at low screen resolutions. Select one of the options to specify
how to apply hinting your fonts.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Subpixel order</guilabel>: Select one of the options
to specify the subpixel color order for your fonts. Use this option for LCD
or flat-screen displays.</para>
                </listitem>
              </itemizedlist>
            </entry>
          </row>
          <row>
            <entry colname="colspec18" colsep="0" rowsep="0">
              <para>
                <guibutton>Go
to font folder</guibutton>
              </para>
            </entry>
            <entry colname="colspec19" colsep="0" rowsep="0">
              <para>Click on this button to open the <guilabel>Fonts</guilabel>
folder.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
    <sect2 id="goscustdesk-83">
      <title>To Preview a Font</title>
      <indexterm>
        <primary>fonts</primary>
        <secondary>previewing</secondary>
      </indexterm>
      <para>You can use the file manager to preview a font. To preview a font, perform
the following steps:</para>
      <orderedlist>
        <listitem>
          <para>Open a file manager window.</para>
        </listitem>
        <listitem>
          <para>Enter the URI <command>fonts:///</command> in the location
bar. The fonts are displayed as icons in the view pane.</para>
        </listitem>
        <listitem>
          <para>Double-click on an icon to display a preview of the font.</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2 id="goscustdesk-94">
      <title>To Add a TrueType Font</title>
      <para>You can use the file manager to add a TrueType font. To add a TrueType
font, perform the following steps:</para>
      <orderedlist>
        <listitem>
          <para>Open a file manager window and select the TrueType font that
you want to add.</para>
        </listitem>
        <listitem>
          <para>From a file browser window, access the <guilabel>fonts:///</guilabel> location. The fonts are displayed as icons.</para>
        </listitem>
        <listitem>
          <para>Copy the TrueType font file that you want to add to the <guilabel>fonts:///</guilabel> location.</para>
        </listitem>
      </orderedlist>
    </sect2>
  </sect1>
  <sect1 id="goscustdesk-95">
    <title>Login Photo Preferences</title>
    <indexterm>
      <primary>desktop</primary>
      <secondary>login photo</secondary>
    </indexterm>
    <indexterm>
      <primary>GNOME Desktop preference tools</primary>
      <see>preference
tools</see>
    </indexterm>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Login Photo</secondary>
    </indexterm>
    <para>The <application>Login Photo </application>
preference tool enables you to change the picture that is displayed in your
login screen. </para>
    <para>From the <guilabel>Login Photo</guilabel> preference tool, select an
image to display in your login screen. Type the path for the folder from where
you want to select your image. Alternatively, click <guibutton>Browse</guibutton>
to display a dialog from which you can select an image to display as your
photograph and click <guibutton>OK</guibutton>.</para>
  </sect1>
  <sect1 id="prefs-keyboard-a11y">
    <title>Keyboard Accessibility Preferences</title>

    <!-- Maintained for 2.8 compatibility -->
    <anchor id="goscustaccess-6"/>
    <indexterm>
      <primary>AccessX</primary>
      <see>preference tools, Keyboard Accessibility</see>
    </indexterm>
    <indexterm>
      <primary>keyboard</primary>
      <secondary>configuring
accessibility options</secondary>
    </indexterm>
    <indexterm>
      <primary>accessibility</primary>
      <secondary>configuring keyboard</secondary>
    </indexterm>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Keyboard Accessibility</secondary>
    </indexterm>
    <para>The <application>Keyboard Accessibility</application> preference tool allows you to set  options such as filtering out accidental keypresses, using the keyboard as a substitute for the mouse, and using shortcut keys without having to hold down several keys at once. The <application>Keyboard</application> accessibility preference tool is also known as <application>AccessX</application>.</para>
    <para>This section describes each of the preferences you can set. For a more task-oriented description of keyboard accessibility, see the <ulink type="help" url="ghelp:gnome-access-guide?index"><citetitle>GNOME Desktop Accessibility Guide</citetitle></ulink>.</para> 
    <para>To open the <application>Keyboard Accessibility</application> preference tool, do one of the following:</para>
    <itemizedlist>
      <listitem>
        <para>From the <guimenu>Main Menu</guimenu>, choose <menuchoice><guimenu>Desktop</guimenu><guimenuitem>Preferences</guimenuitem><guimenuitem>Accessibility</guimenuitem><guimenuitem>Keyboard</guimenuitem></menuchoice>.
        </para>
      </listitem>
      <listitem>
        <para>In the <application>Keyboard</application> preference tool, click the <guibutton>Accessibility</guibutton> button.
        </para>
      </listitem>
    </itemizedlist> 
    <para>You can customize the preferences for the keyboard accessibility in
the following functional areas:</para>
    <itemizedlist>
      <listitem>
        <para>
          <guilabel>Basic</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Filters</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Mouse</guilabel>
        </para>
      </listitem>
    </itemizedlist>

    <sect2 id="goscustaccess-8">
      <title>Basic Preferences</title>
      <para><xref linkend="goscustaccess-TBL-1"/> lists the basic keyboard accessibility
preferences that you can modify.</para>
      <table frame="topbot" id="goscustaccess-TBL-1">
        <title>Keyboard Accessibility Preferences</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="25.64*"/>
          <colspec colname="colspec1" colwidth="74.36*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Dialog Element</para>
              </entry>
              <entry>
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Enable keyboard
accessibility features</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Select this option to enable keyboard accessibility features.
When you select this option, the other options in the preference tool become
available.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Disable if unused
for</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Select this option to deactivate keyboard accessibility preferences if the
keyboard is not used for a specified period of time. Use the slider to specify
the number of seconds of keyboard idle time required before the system disables
the keyboard accessibility preferences.  When the specified number of seconds
elapses, the following keyboard accessibility preferences are disabled:</para>
                <itemizedlist>
                  <listitem>
                    <para>Bounce keys</para>
                  </listitem>
                  <listitem>
                    <para>Mouse keys</para>
                  </listitem>
                  <listitem>
                    <para>Slow keys</para>
                  </listitem>
                  <listitem>
                    <para>Sticky keys</para>
                  </listitem>
                  <listitem>
                    <para>Toggle keys</para>
                  </listitem>
                </itemizedlist>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Beep when features
turned on or off from keyboard</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Select this option for an audible indication when a feature
such as sticky keys or slow keys is activated, or deactivated.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guibutton>Import Feature
Settings</guibutton>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Click on this button to import an <application>AccessX</application> configuration
file. </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Enable Sticky
Keys</guilabel>
                </para>
                <indexterm>
                  <primary>accessibility</primary>
                  <secondary>sticky keys</secondary>
                </indexterm>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Select this option to perform multiple simultaneous keypress operations by
pressing the keys in sequence. Alternatively, to enable the sticky keys feature,
press <keycap>Shift</keycap> five times.</para>
                <para>You can set the following
sticky keys preferences:</para>
                <itemizedlist>
                  <listitem>
                    <para><guilabel>Beep when modifier is pressed</guilabel>: Select
this option for an audible indication when you press a modifier key. </para>
                  </listitem>
                  <listitem>
                    <para><guilabel>Disable if two keys pressed together</guilabel>:
Select this option to specify that when you press two keys simultaneously,
you can no longer press keys in sequence to perform multiple simultaneous
keypresses.</para>
                  </listitem>
                </itemizedlist>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Enable Repeat
Keys</guilabel>
                </para>
                <indexterm>
                  <primary>accessibility</primary>
                  <secondary>repeat keys</secondary>
                </indexterm>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Select this option to enable the autorepeat settings for your keyboard. You
can set the following autorepeat preferences:</para>
                <itemizedlist>
                  <listitem>
                    <para><guilabel>Delay</guilabel>: Use the slider or the spin box
to specify the interval to wait after the first keypress before the automatic
repeat of a pressed key. </para>
                  </listitem>
                  <listitem>
                    <para><guilabel>Speed</guilabel>: Use the slider or the spin box
to specify the number of characters per second to enter. </para>
                  </listitem>
                </itemizedlist>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Type to test settings</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>The
test area is an interactive interface so you can see how the keyboard settings
affect the display as you type. Type text in the test area to test the effect
of your settings.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <para>For more information on configuring keyboard accessibility preferences,
see the <ulink type="help" url="ghelp:gnome-access-guide?index"><citetitle>GNOME Desktop Accessibility Guide</citetitle></ulink>.</para>
    </sect2>
    <sect2 id="goscustaccess-9">
      <title>Filter Preferences</title>
      <para><xref linkend="goscustaccess-TBL-11"/> lists the filter preferences that
you can modify.</para>
      <table frame="topbot" id="goscustaccess-TBL-11">
        <title>Filter Preferences</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="25.64*"/>
          <colspec colname="colspec1" colwidth="74.36*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Dialog Element</para>
              </entry>
              <entry>
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Enable keyboard
accessibility features</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Select this option to enable keyboard accessibility features.
When you select this option, the other options in the preference tool become
available.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Enable Slow Keys</guilabel>
                </para>
                <indexterm>
                  <primary>accessibility</primary>
                  <secondary>slow keys</secondary>
                </indexterm>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Select this option to control the period of time that you must press-and-hold
a key before acceptance. Alternatively, to enable the slow keys feature, press-and-hold <keycap>Shift</keycap> for eight seconds.</para>
                <para>You can set the following slow
keys preferences: </para>
                <itemizedlist>
                  <listitem>
                    <para><guilabel>Only accept keys held for</guilabel>: Use the slider
or the spin box to specify the period of time that you must press-and-hold
a key before acceptance. </para>
                  </listitem>
                  <listitem>
                    <para><guilabel>Beep when key is</guilabel>: Select the appropriate
option or options for an audible indication  when a key is pressed, accepted,
or rejected. </para>
                  </listitem>
                </itemizedlist>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Enable Bounce
Keys</guilabel>
                </para>
                <indexterm>
                  <primary>accessibility</primary>
                  <secondary>bounce keys</secondary>
                </indexterm>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Select this option to accept a key input and to control the key repeat characteristics
of the keyboard. You can set the following bounce keys preferences:  </para>
                <itemizedlist>
                  <listitem>
                    <para><guilabel>Ignore duplicate keypresses within</guilabel>: Use
the slider or the spin box to specify the interval to wait after the first
keypress before the automatic repeat of a pressed key. </para>
                  </listitem>
                  <listitem>
                    <para><guilabel>Beep if key is rejected</guilabel>: Select this
option for an audible indication of key rejection. </para>
                  </listitem>
                </itemizedlist>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Enable Toggle
Keys</guilabel>
                </para>
                <indexterm>
                  <primary>accessibility</primary>
                  <secondary>toggle keys</secondary>
                </indexterm>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Select this option for an audible indication of a toggle keypress. You hear
one beep when a toggle key is turned on. You hear two beeps when a toggle
key is turned off.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Type to test settings</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>The
test area is an interactive interface so you can see how the keyboard settings
affect the display as you type. Type text in the test area to test the effect
of your settings.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <para>For more information on configuring keyboard accessibility preferences,
see the <ulink type="help" url="ghelp:gnome-access-guide?index"><citetitle>GNOME Desktop Accessibility Guide</citetitle></ulink>.</para>
    </sect2>
    <sect2 id="goscustaccess-10">
      <title>Mouse Preferences</title>
      <para><xref linkend="goscustaccess-TBL-12"/> lists the mouse preferences that
you can modify.</para>
      <table frame="topbot" id="goscustaccess-TBL-12">
        <title>Mouse Preferences</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="25.64*"/>
          <colspec colname="colspec1" colwidth="74.36*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Dialog Element</para>
              </entry>
              <entry>
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Enable keyboard
accessibility features</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Select this option to enable keyboard accessibility features.
When you select this option, the other options in the preference tool become
available.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Enable Mouse Keys</guilabel>
                </para>
                <indexterm>
                  <primary>accessibility</primary>
                  <secondary>mouse keys</secondary>
                </indexterm>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Select this option to make the numeric keypad emulate mouse actions. The list of keys and their equivalences is in the <citetitle>GNOME Desktop Accessibility Guide</citetitle> under the heading <ulink type="help" url="ghelp:gnome-access-guide?dtconfig-14"><citetitle>To Enable the Keyboard to Emulate the Mouse</citetitle></ulink>.</para>
                <para>You can
set the following mouse key preferences: </para>
                <itemizedlist>
                  <listitem>
                    <para><guilabel>Maximum pointer speed</guilabel>: Use the slider
or the spin box to specify the maximum speed that the pointer moves across
the screen.</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>Time to accelerate to maximum speed</guilabel>:
Use the slider or the spin box to specify the duration of the acceleration
time of the pointer. </para>
                  </listitem>
                  <listitem>
                    <para><guilabel>Delay between keypress and pointer movement</guilabel>:
Use the slider or the spin box to specify the period of time that must pass
after a keypress before the pointer moves. </para>
                  </listitem>
                </itemizedlist>
              </entry>
            </row>
            <row>
              <entry colname="colspec0">
                <para>
                  <guibutton>Mouse Preferences</guibutton>
                </para>
              </entry>
              <entry colname="colspec1">
                <para>Click on this button to open the <application>Mouse</application> preference tool.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <para>For more information on configuring keyboard accessibility preferences,
see the <ulink type="help" url="ghelp:gnome-access-guide?index"><citetitle>GNOME Desktop Accessibility Guide</citetitle></ulink>.</para>
    </sect2>
  </sect1>
  <sect1 id="goscustperiph-2">
    <title>Keyboard Preferences</title>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Keyboard</secondary>
    </indexterm>
    <indexterm>
      <primary>keyboard</primary>
      <secondary>configuring
general preferences</secondary>
    </indexterm>
    <para>Use the <application>Keyboard</application> preference tool to modify the autorepeat preferences for
your keyboard, and to configure typing break settings. </para>
    <para>You can set the preferences for the <application>Keyboard</application>
preference tool in the following functional areas:</para>
    <itemizedlist>
      <listitem>
        <para>
          <guilabel>Keyboard</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Typing Break</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Layouts</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Layout Options</guilabel>
        </para>
      </listitem>
    </itemizedlist>
    <sect2 id="goscustdesk-40">
      <title>Keyboard Preferences</title>
      <para>Use the <guilabel>Keyboard</guilabel> tabbed section to set general
keyboard preferences. To start the <application>Keyboard</application> <emphasis>accessibility</emphasis> preference tool, that is, <application>AccessX</application>,
click on the <guibutton>Accessibility</guibutton> button.</para>
      <para><xref linkend="goscustperiph-TBL-3"/> lists the keyboard preferences
that you can modify.</para>
      <table frame="topbot" id="goscustperiph-TBL-3">
        <title>Keyboard Preferences</title>
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="colspec18" colwidth="19.21*"/>
          <colspec colname="colspec19" colwidth="46.79*"/>
          <thead>
            <row>
              <entry colsep="0" rowsep="1">
                <para>Dialog Element</para>
              </entry>
              <entry colsep="0" rowsep="1">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Key presses
repeat when key is held down</guilabel>
                </para>
              </entry>
              <entry colsep="0" rowsep="0" valign="top">
                <para>Select this option to enable keyboard repeat. If keyboard
repeat is enabled, when you press-and-hold a key, the action associated with
the key is performed repeatedly. For example, if you press-and-hold a character
key, the character is typed repeatedly.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Delay</guilabel>
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
                <para>Select the delay from the time you press a key to the time
that the action repeats.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Speed</guilabel>
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
                <para>Select the speed at which the action is repeated. </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Cursor blinks in text boxes and fields</guilabel>
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
                <para>Select this option to enable the
cursor to blink in fields and text boxes.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Speed</guilabel>
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
                <para>Use the slider to specify the speed at which the cursor
blinks in fields and text boxes.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0">
                <para>
                  <guilabel>Type
to test settings</guilabel>
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0">
                <para>The test area is an interactive interface so you can see
how the keyboard settings affect the display as you type. Type text in the
test area to test the effect of your settings.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="goscustdesk-86">
      <title>Typing Break Preferences</title>
      <para>Use the <guilabel>Typing Break</guilabel> tabbed section to set typing
break preferences. To start the <application>Keyboard</application> <emphasis>accessibility</emphasis> preference tool, that is, <application>AccessX</application>,
click on the <guibutton>Accessibility</guibutton> button.</para>
      <para><xref linkend="goscustdesk-TBL-87"/> lists the typing break preferences
 that you can modify.</para>
      <table frame="topbot" id="goscustdesk-TBL-87">
        <title>Typing Break Preferences</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colwidth="50*"/>
          <colspec colwidth="50*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Dialog Element</para>
              </entry>
              <entry>
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry valign="top">
                <para>
                  <guilabel>Lock screen to enforce typing break</guilabel>
                </para>
              </entry>
              <entry valign="top">
                <para>Select this option to
lock the screen when you are due a typing break.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>
                  <guilabel>Work interval lasts</guilabel>
                </para>
              </entry>
              <entry valign="top">
                <para>Use the spin box to specify how long you can work
before a typing break occurs.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>
                  <guilabel>Break interval lasts</guilabel>
                </para>
              </entry>
              <entry valign="top">
                <para>Use the spin box to specify the length of your typing
breaks.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>
                  <guilabel>Allow postponing of breaks</guilabel>
                </para>
              </entry>
              <entry valign="top">
                <para>Select this option if you want to be able to postpone
typing breaks.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="goscustdesk-100">
      <title>Keyboard Layout Preferences</title>
      <para>Use the <guilabel>Layouts</guilabel> tabbed section to set your keyboard
layout. Select your keyboard model from the drop-down list. Use the navigational
buttons to add or remove a selected layout from the list of available layouts. </para>
      <para>You can choose different layouts to suit different locales. For more
information on keyboard layouts, see the <citetitle>Keyboard Layout Switcher</citetitle> manual.</para>
      <para>To start the <application>Keyboard</application> <emphasis>accessibility</emphasis> preference tool, that is, <application>AccessX</application>,
click on the <guibutton>Accessibility</guibutton> button.</para>
    </sect2>
    <sect2 id="goscustdesk-101">
      <title>Keyboard Layout Options</title>
      <para>Use the <guilabel>Layout Options</guilabel> tabbed section to set your
keyboard layout options. Select an option from the list of available layout
options and click <guibutton>Add</guibutton> to select an option. Use <guibutton>Remove</guibutton> to remove a selected option. </para>
      <para>For more information on the layout options, see the <citetitle>Keyboard
Layout Switcher</citetitle> manual.</para>
      <para>To start the <application>Keyboard</application> <emphasis>accessibility</emphasis> preference tool, that is, <application>AccessX</application>,
click on the <guibutton>Accessibility</guibutton> button.</para>
    </sect2>
  </sect1>
  <sect1 id="prefs-keyboard-shortcuts">
    <title>Keyboard Shortcuts Preferences</title>

    <!-- Maintained for 2.8 compatibility -->
    <anchor id="goscustdesk-39"/>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Keyboard Shortcuts</secondary>
    </indexterm>
    <indexterm>
      <primary>shortcut
keys</primary>
      <secondary>configuring</secondary>
    </indexterm>
    <indexterm>
      <primary>keyboard shortcuts</primary>
      <secondary>configuring</secondary>
    </indexterm>
    <para>A <firstterm>keyboard shortcut</firstterm> is a key or combination of
keys that provides an alternative to standard ways of performing an action. </para>
    <para>Use the <application>Keyboard Shortcuts</application> preference tool to display the default keyboard
shortcuts. You can customize the default keyboard shortcuts to your requirements. </para>
    <para><xref linkend="goscustdesk-TBL-5"/>
lists the keyboard shortcut settings that you can customize.</para>
    <table frame="topbot" id="goscustdesk-TBL-5">
      <title>Keyboard Shortcuts Preferences</title>
      <tgroup cols="2" colsep="0" rowsep="0">
        <colspec colname="colspec0" colwidth="36.11*"/>
        <colspec colname="colspec1" colwidth="63.89*"/>
        <thead>
          <row rowsep="1">
            <entry>
              <para>Dialog Element</para>
            </entry>
            <entry>
              <para>Description</para>
            </entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry colname="colspec0" valign="top">
              <para>
                <guilabel>Text editing shortcuts</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" valign="top">
              <para>Select
one of the following settings:</para>
              <itemizedlist>
                <listitem>
                  <para><guilabel>GNOME Default</guilabel>: Use this setting for standard
shortcut keys.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Emacs</guilabel>: Use this setting for <application>Emacs</application> shortcut keys.</para>
                </listitem>
              </itemizedlist>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" valign="top">
              <para>
                <guilabel>Desktop shortcuts</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" valign="top">
              <para>This
table lists actions and the shortcut keys that are associated with each action. </para>
              <para>To change the shortcut keys for an action, click on the action
to select the action, then click on the shortcut for the action. Press the
keys that you want to associate with the action.</para>
              <para>To disable the
shortcut keys for an action, click on the action to select the action, then
click on the shortcut for the action. Press the <keycap>Backspace</keycap> key.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </sect1>  
  <sect1 id="goscustuserinter-2">
    <title>Menus &amp; Toolbars Preferences</title>
    <indexterm>
      <primary>toolbars, customizing appearance</primary>
    </indexterm>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Menus &amp; Toolbars</secondary>
    </indexterm>
    <indexterm>
      <primary>menus</primary>
      <secondary>in applications,
customizing appearance</secondary>
    </indexterm>
    <para>You can use the <application>Menus &amp; Toolbars</application> preference tool to customize the appearance
of menus, menubars, and toolbars for GNOME-compliant applications.</para>
    <para><xref linkend="goscustuserinter-TBL-8"/> lists the menu and toolbar preferences that
you can modify for GNOME-compliant applications.</para>
    <table frame="topbot" id="goscustuserinter-TBL-8">
      <title>Menu and Toolbar Preferences</title>
      <tgroup cols="2" colsep="1" rowsep="1">
        <colspec colname="colspec0" colwidth="18.86*"/>
        <colspec colname="colspec1" colwidth="47.14*"/>
        <thead>
          <row>
            <entry colsep="0" rowsep="1">
              <para>Dialog Element</para>
            </entry>
            <entry colsep="0" rowsep="1">
              <para>Description</para>
            </entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Show icons in menus</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Select this option to display an icon beside
each item in a menu. Some menu items do not have an icon.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Detachable toolbars</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Select this option if you want to move toolbars
from application windows to any location on the screen. If you select this
option, handles are displayed on the left side of the toolbars in your applications.
To move a toolbar, click-and-hold on the handle, then drag the toolbar to
the new location.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Toolbar button labels</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Choose one of the following options to specify
what to display on the toolbars in your GNOME-compliant applications:</para>
              <itemizedlist>
                <listitem>
                  <para><guilabel>Text Below Icons</guilabel>: Select this option
to display toolbars with text as well as an icon on each button. </para>
                </listitem>
                <listitem>
                  <para><guilabel>Text Beside Icons</guilabel>: Select this option
to display toolbars with an icon only on each button, and with text on the
most important buttons.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Icons Only</guilabel>: Select this option to display
toolbars with an icon only on each button.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Text Only</guilabel>: Select this option to display
toolbars with text only on each button.</para>
                </listitem>
              </itemizedlist>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </sect1>
  <sect1 id="prefs-mouse">
    <title>Mouse Preferences</title>

    <!-- Maintained for 2.8 compatibility -->
    <anchor id="goscustperiph-5"/>

    <indexterm>
      <primary>preference tools</primary>
      <secondary>Mouse</secondary>
    </indexterm>
    <indexterm>
      <primary>mouse</primary>
      <secondary>configuring</secondary>
    </indexterm>
    <para>With the <application>Mouse</application> preference tool
    you can:</para>
    <itemizedlist>
      <listitem>
        <para>configure your mouse for right-hand use or for left-hand use,</para>
      </listitem>
      <listitem>      
        <para>specify the speed and sensitivity of mouse movement.</para>
      </listitem>
    </itemizedlist>
    
    
    <sect2 id="goscustdesk-55">
      <title>Buttons Preferences</title>
      <para>Use the <guilabel>Buttons</guilabel> tabbed section to specify whether
the mouse buttons are configured for left-hand use. You can also specify the
delay between clicks for a double-click.</para>
      <para><xref linkend="goscustperiph-TBL-6"/> lists the mouse button preferences
that you can modify.</para>

    <!-- convert to variablelist -->
    <table frame="topbot" id="goscustperiph-TBL-6">
        <title>Mouse Button Preferences</title>
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="colspec18" colwidth="19.21*"/>
          <colspec colname="colspec19" colwidth="46.79*"/>
          <thead>
            <row>
              <entry colsep="0" rowsep="1">
                <para>Dialog Element</para>
              </entry>
              <entry colsep="0" rowsep="1">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Left-handed
mouse</guilabel>
                </para>
              </entry>
              <entry colsep="0" rowsep="0" valign="top">
                <para>Select this option to configure your mouse for left-hand use. When you configure
your mouse for left-hand use, the functions of the left mouse button and the
right mouse button are swapped.</para>
              </entry>
            </row>
            <row>
              <entry colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Timeout</guilabel>
                </para>
              </entry>
              <entry colsep="0" rowsep="0" valign="top">
                <para>Use the slider to specify
the amount of time that can pass between clicks when you double-click. If
the interval between the first and second clicks exceeds the time that is
specified here, the action is not interpreted as a double-click. </para>

                <para>Use the light bulb icon to check double-click sensitivity: the light will light up briefly for a click, but stay lit for a double-click.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="goscustdesk-54">
      <title>Pointer Preferences</title>
      <para>Use the <guilabel>Pointers</guilabel> tabbed section to set
      your mouse pointer preferences.
      </para>
      <para><xref linkend="goscustdesk-TBL-45"/> lists the mouse pointer preferences
that you can modify:</para>
      <table frame="topbot" id="goscustdesk-TBL-45">
        <title>Mouse Pointer Preferences</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="50*"/>
          <colspec colname="colspec1" colwidth="50*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Dialog Element</para>
              </entry>
              <entry>
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry valign="top">
                <para>
                  <guilabel>Pointer Theme</guilabel>
                </para>
              </entry>
              <entry valign="top">
                <para>Select the mouse pointer theme that you require
from the list box. </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Highlight the
pointer when you press Ctrl</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Select this option to enable a mouse pointer animation
when you press and release <keycap>Ctrl</keycap>. This feature can assist
you to locate the mouse pointer.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="goscustdesk-53">
      <title>Motion Preferences</title>
      <para>Use the <guilabel>Motion</guilabel> tabbed section to set your preferences
for mouse movement.</para>
      <para><xref linkend="goscustdesk-TBL-47"/> lists the mouse motion preferences
that you can modify:</para>
      <table frame="topbot" id="goscustdesk-TBL-47">
        <title>Mouse Motion Preferences</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colwidth="30.10*"/>
          <colspec colwidth="69.90*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Dialog Element</para>
              </entry>
              <entry>
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry valign="top">
                <para>
                  <guilabel>Acceleration</guilabel>
                </para>
              </entry>
              <entry valign="top">
                <para>Use the slider to specify the speed at which your
mouse pointer moves on your screen when you move your mouse.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>
                  <guilabel>Sensitivity</guilabel>
                </para>
              </entry>
              <entry valign="top">
                <para>Use the slider to specify how sensitive your mouse
pointer is to movements of your mouse.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>
                  <guilabel>Threshold</guilabel>
                </para>
              </entry>
              <entry valign="top">
                <para>Use the slider to specify the distance that you
must move an item before the move action is interpreted as a drag-and-drop
action.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
  </sect1>
  <sect1 id="goscustdesk-50">
    <title>Network Proxy Preferences</title>
    <indexterm>
      <primary>preference
tools</primary>
      <secondary>Network Proxy</secondary>
    </indexterm>
    <indexterm>
      <primary>network proxy</primary>
      <secondary>setting preferences</secondary>
    </indexterm>
    <indexterm>
      <primary>Internet</primary>
      <secondary>configuring connection</secondary>
    </indexterm>
    <indexterm>
      <primary>proxy</primary>
      <secondary>setting preferences</secondary>
    </indexterm>
    <para>The <application>Network Proxy</application>
preference tool enables you to configure how your system connects to the Internet.
You can configure the GNOME Desktop to connect to a <firstterm>proxy server</firstterm>, and specify the details of the proxy server. A proxy server
is a server that intercepts requests to another server, and fulfills the request
itself, if it can. You can enter the Domain Name Service (DNS) name or the
Internet Protocol (IP) address of the proxy server. A <firstterm>DNS name</firstterm> is a unique alphabetic identifier for a computer on a network.
An <firstterm>IP address</firstterm> is a unique numeric identifier for a
computer on a network. </para>
    <para><xref linkend="goscustdesk-TBL-52"/> lists the Internet connection preferences
that you can modify.</para>
    <table frame="topbot" id="goscustdesk-TBL-52">
      <title>Internet Connection Preferences</title>
      <tgroup cols="2" colsep="0" rowsep="0">
        <colspec colname="colspec2" colwidth="35.09*"/>
        <colspec colname="colspec3" colwidth="64.91*"/>
        <thead>
          <row rowsep="1">
            <entry>
              <para>Dialog Element</para>
            </entry>
            <entry>
              <para>Description</para>
            </entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry colname="colspec2" valign="top">
              <para>
                <guilabel>Direct internet
connection</guilabel>
              </para>
            </entry>
            <entry colname="colspec3" valign="top">
              <para>Select this option if you want to connect directly to the Internet, without
a proxy server.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec2">
              <para>
                <guilabel>Manual proxy configuration</guilabel>
              </para>
            </entry>
            <entry colname="colspec3" valign="top">
              <para>Select
this option if you want to connect to the Internet through a proxy server,
and you want to configure the proxy server manually.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec2" valign="top">
              <para>
                <guilabel>HTTP proxy</guilabel>
              </para>
            </entry>
            <entry colname="colspec3" valign="top">
              <para>Enter the DNS name, or the IP
address of the proxy server to use when you request a HTTP service. Enter
the port number of the HTTP service on the proxy server in the <guilabel>Port</guilabel> spin box.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec2" valign="top">
              <para>
                <guilabel>Secure HTTP proxy</guilabel>
              </para>
            </entry>
            <entry colname="colspec3" valign="top">
              <para>Enter
the DNS name, or the IP address of the proxy server to use when you request
a Secure HTTP service. Enter the port number of the Secure HTTP service on
the proxy server in the <guilabel>Port</guilabel> spin box.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec2" valign="top">
              <para>
                <guilabel>FTP proxy</guilabel>
              </para>
            </entry>
            <entry colname="colspec3" valign="top">
              <para>Enter the DNS name, or the IP
address of the proxy server to use when you request a FTP service. Enter the
port number of the FTP service on the proxy server in the <guilabel>Port</guilabel>
spin box.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec2" valign="top">
              <para>
                <guilabel>Socks host</guilabel>
              </para>
            </entry>
            <entry colname="colspec3" valign="top">
              <para>Enter the DNS name, or the IP
address of the Socks host to use. Enter the port number for the Socks protocol
on the proxy server in the <guilabel>Port</guilabel> spin box.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec2" valign="top">
              <para>
                <guilabel>Automatic proxy
configuration</guilabel>
              </para>
            </entry>
            <entry colname="colspec3" valign="top">
              <para>Select this option if you want to connect to the Internet through a proxy
server, and you want to configure the proxy server automatically.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec2" valign="top">
              <para>
                <guilabel>Autoconfiguration
URL</guilabel>
              </para>
            </entry>
            <entry colname="colspec3" valign="top">
              <para>Enter the URL that contains the information required to configure the proxy
server automatically. </para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </sect1>
  <sect1 id="goscustdoc-2">
    <title>Preferred Applications</title>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Preferred Applications</secondary>
    </indexterm>
    <indexterm>
      <primary>default applications</primary>
      <see>preferred applications</see>
    </indexterm>
    <para>Use the <application>Preferred
Applications</application> preference tool to specify the applications that
you want the GNOME Desktop to use when the GNOME Desktop starts an application
for you. For example, you can specify <application>Xterm</application> as
your preferred terminal application. When you open the <guimenu>Desktop</guimenu>
menu then choose <guimenuitem>Open Terminal</guimenuitem>, <application>Xterm</application> starts.</para>
    <para>You can customize the preferences for the <application>Preferred Applications</application> preference tool in the following functional areas.</para>
    <itemizedlist>
      <listitem>
        <para>
          <guilabel>Web Browser</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Mail Reader</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Text Editor</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Terminal</guilabel>
        </para>
      </listitem>
    </itemizedlist>
    <sect2 id="goscustlookandfeel-32">
      <title>Web Browser Preferences</title>
      <indexterm>
        <primary>preferred applications</primary>
        <secondary>web browser</secondary>
      </indexterm>
      <indexterm>
        <primary>web browser, preferred application</primary>
      </indexterm>
      <para>Use the <application>Web Browser</application>
tabbed section to configure your preferred web browser. The preferred web
browser opens when you click on a URL. For example, the preferred web browser
opens when you select a URL in an application, or when you select a URL launcher
on the desktop.</para>
      <para><xref linkend="goscustlookandfeel-TBL-37"/> lists the preferred web browser
preferences that you can modify.</para>
      <table frame="topbot" id="goscustlookandfeel-TBL-37">
        <title>Preferred Web Browser Preferences</title>
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="colspec0" colwidth="18.86*"/>
          <colspec colname="colspec1" colwidth="47.14*"/>
          <thead>
            <row>
              <entry colsep="0" rowsep="1">
                <para>Dialog Element</para>
              </entry>
              <entry colsep="0" rowsep="1">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Select a Web Browser</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select this option if you want to use a standard
web browser. Use the drop-down combination box to select your preferred web
browser.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Custom Web Browser</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select this option if you want to use a custom
web browser. </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Command</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Enter the command to execute to start the custom web browser.
To enable the browser to display a URL that you click on, include <command>"%s"</command> after the command.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Start in Terminal</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select this option to run the command in a terminal
window. Select this option for a browser that does not create a window in
which to run.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="goscustlookandfeel-42">
      <title>Email Client Preferences</title>
      <indexterm>
        <primary>preferred applications</primary>
        <secondary>email client</secondary>
      </indexterm>
      <indexterm>
        <primary>email client, preferred application</primary>
      </indexterm>
      <para>Use the <application>Mail Reader</application>
tabbed section to configure your preferred email client. </para>
      <para><xref linkend="goscustlookandfeel-TBL-43"/> lists the preferred email
client preferences that you can modify.</para>
      <table frame="topbot" id="goscustlookandfeel-TBL-43">
        <title>Preferred Email Client Preferences</title>
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="colspec0" colwidth="18.86*"/>
          <colspec colname="colspec1" colwidth="47.14*"/>
          <thead>
            <row>
              <entry colsep="0" rowsep="1">
                <para>Dialog Element</para>
              </entry>
              <entry colsep="0" rowsep="1">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Select a Mail Reader</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select this option if you want to use a standard
email client. Use the drop-down combination box to select your preferred email
client.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Custom Mail Reader</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select this option if you want to use a custom
email client. </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Command</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Enter the command to execute to start the custom email
client.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Start in Terminal</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select this option to run the command in a terminal
window. Select this option for an email client that does not create a window
in which to run.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="goscustlookandfeel-31">
      <title>Text Editor Preferences</title>
      <indexterm>
        <primary>preferred applications</primary>
        <secondary>text editor</secondary>
      </indexterm>
      <indexterm>
        <primary>text editor, preferred application</primary>
      </indexterm>
      <para>Use the <application>Text Editor</application>
tabbed section to configure your preferred text editor.</para>
      <para><xref linkend="goscustdoc-TBL-1"/> lists the preferred text editor preferences
that you can modify.</para>
      <table frame="topbot" id="goscustdoc-TBL-1">
        <title>Preferred Text Editor Preferences</title>
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="colspec0" colwidth="18.86*"/>
          <colspec colname="colspec1" colwidth="47.14*"/>
          <thead>
            <row>
              <entry colsep="0" rowsep="1">
                <para>Dialog Element</para>
              </entry>
              <entry colsep="0" rowsep="1">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Select an Editor</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select this option if you want to use a standard
text editor. Use the drop-down combination box to specify your preferred text
editor.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Custom Editor</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select this option if you want to use a custom
text editor. A <guilabel>Custom Editor Properties</guilabel> dialog is displayed.</para>
                <itemizedlist>
                  <listitem>
                    <para><guilabel>Name</guilabel>: Type the name of the custom text
editor.</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>Command</guilabel>: Enter the command to start the
custom text editor.</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>This application can open multiple files</guilabel>:
Select this option if the default text editor can open multiple files.</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>This application needs to be run in a shell</guilabel>:
Select this option to run the command in a terminal window. Select this option
for an editor that does not create a window in which to run.</para>
                  </listitem>
                </itemizedlist>
                <para>After you specify a custom text editor, you can click
on the <guibutton>Properties</guibutton> button to display the <guilabel>Custom Editor Properties</guilabel> dialog. You can use the dialog to modify
the properties of the custom text editor.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Use this editor to open text files in the file manager</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select
this option if you want the file manager to start the custom text editor to
display text files.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="goscustlookandfeel-34">
      <title>Terminal Preferences</title>
      <indexterm>
        <primary>preferred applications</primary>
        <secondary>terminal</secondary>
      </indexterm>
      <indexterm>
        <primary>terminal, preferred application</primary>
      </indexterm>
      <para>Use the <application>Terminal</application> tabbed section
to configure your preferred terminal.</para>
      <para><xref linkend="goscustlookandfeel-TBL-35"/> lists the preferred terminal
preferences that you can modify.</para>
      <table frame="topbot" id="goscustlookandfeel-TBL-35">
        <title>Preferred Terminal Preferences</title>
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="colspec0" colwidth="18.86*"/>
          <colspec colname="colspec1" colwidth="47.14*"/>
          <thead>
            <row>
              <entry colsep="0" rowsep="1">
                <para>Dialog Element</para>
              </entry>
              <entry colsep="0" rowsep="1">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Select a Terminal</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select this option if you want to use a standard
terminal. Use the drop-down combination box to specify your preferred terminal.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Custom Terminal</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select this option if you want to use a custom
terminal. </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Command</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Enter the command to execute to start the custom terminal.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Exec Flag</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Enter the <command>exec</command> option to use with the
command.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
  </sect1>
  <sect1 id="prefs-remotedesktop">
    <title>Remote Desktop Preferences</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="goscustdesk-90"/>
    <indexterm>
      <primary>setting session sharing preferences</primary>
    </indexterm>           
    <para>The <application>Remote Desktop</application> preference tool enables you to share a GNOME Desktop session
between multiple users, and to set session-sharing preferences.</para>
    <para><xref linkend="goscustdesk-TBL-91"/> lists the session-sharing preferences
that you can set. These preferences have a direct impact on the security of
your system.</para>
    <table frame="topbot" id="goscustdesk-TBL-91">
      <title>Session Sharing Preferences</title>
      <tgroup cols="2" colsep="1" rowsep="1">
        <colspec colname="colspec18" colwidth="19.21*"/>
        <colspec colname="colspec19" colwidth="46.79*"/>
        <thead>
          <row>
            <entry colsep="0" rowsep="1">
              <para>Dialog Element</para>
            </entry>
            <entry colsep="0" rowsep="1">
              <para>Description</para>
            </entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Allow other
users to view your desktop</guilabel>
              </para>
            </entry>
            <entry colsep="0" rowsep="0" valign="top">
              <para>Select this option to enable remote users to view your
session. All keyboard, pointer, and clipboard events from the remote user
are ignored.</para>
            </entry>
          </row>
          <row>
            <entry colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Allow other
users to control your desktop</guilabel>
              </para>
            </entry>
            <entry colsep="0" rowsep="0" valign="top">
              <para>Select this option to enable other to access and control
your session from a remote location.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec18" colsep="0" rowsep="0">
              <para>
                <guilabel>Users
can view your desktop using this command:</guilabel>
                
              </para>
            </entry>
            <entry colname="colspec19" colsep="0" rowsep="0">
              <para>Click on the highlighted text to system address by email to
a remote user.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec18" colsep="0" rowsep="0">
              <para>
                <guilabel>When
a user tries to view or control your desktop</guilabel>
              </para>
            </entry>
            <entry colname="colspec19" colsep="0" rowsep="0">
              <para>Select the following security
considerations when a user tries to view or control your session:<itemizedlist><listitem><para><guilabel>Ask you for confirmation:</guilabel> Select this
option if you want remote users to ask you for confirmation when they want
to share your session. This option enables you to be aware of other users
who connect to your session. You can also decide what time is suitable for
the remote user to connect to your session.</para></listitem><listitem><para><guilabel>Require the user to enter this password:</guilabel>
Select this option to authenticate the remote user if authentication is used.
This option provides an extra level of security.</para></listitem></itemizedlist></para>
            </entry>
          </row>
          <row>
            <entry colname="colspec18" colsep="0" rowsep="0">
              <para>
                <guilabel>Password</guilabel>
              </para>
            </entry>
            <entry colname="colspec19" colsep="0" rowsep="0">
              <para>Enter the password that the client who attempts to view or control your session
must enter.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </sect1>  
  <sect1 id="goscustdesk-70">
    <title>Screen Resolution Preferences</title>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Screen Resolution</secondary>
    </indexterm>
    <para>Use the <application>Screen Resolution</application>
preference tool to specify the resolution settings for your screen. <xref linkend="goscustdesk-TBL-72"/> lists the screen resolution preferences that
you can modify.</para>
    <table frame="topbot" id="goscustdesk-TBL-72">
      <title>Screen Resolution Preferences</title>
      <tgroup cols="2" colsep="0" rowsep="0">
        <colspec colname="colspec0" colwidth="50*"/>
        <colspec colname="colspec1" colwidth="50*"/>
        <thead>
          <row rowsep="1">
            <entry>
              <para>Dialog Element</para>
            </entry>
            <entry>
              <para>Description</para>
            </entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry valign="top">
              <para>
                <guilabel>Resolution</guilabel>
              </para>
            </entry>
            <entry valign="top">
              <para>Select the resolution to use for the screen from
the drop-down list.</para>
            </entry>
          </row>
          <row>
            <entry valign="top">
              <para>
                <guilabel>Refresh rate</guilabel>
              </para>
            </entry>
            <entry valign="top">
              <para>Select the screen refresh rate to use for the screen
from the drop-down list.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" valign="top">
              <para>
                <guilabel>Make default for
this computer only</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" valign="top">
              <para>Select this option to make the screen resolution settings the default settings
for the system that you are logged in to only.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </sect1>
  <sect1 id="prefs-screensaver">
    <title>Screensaver Preferences</title>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>screensaver</secondary>
    </indexterm>
    <para>
    </para>
  </sect1>
  
  <sect1 id="prefs-sessions">
    <title>Sessions Preferences</title>
    
    <!-- preserve for backwards compatibility: 2.12 -->
    <anchor id="goscustsession-5"/>   
        
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Sessions</secondary>
    </indexterm>
    <indexterm>
      <primary>sessions</primary>
      <secondary>preferences</secondary>
    </indexterm>
    <indexterm>
      <primary>startup applications</primary>
      <secondary>customizing</secondary>
    </indexterm>
    <para>The <application>Sessions</application>
preference tool enables you to manage your sessions. You can set session preferences,
and specify which applications to start when you start a session. You can
configure sessions to save the state of applications in the GNOME Desktop,
and to restore the state when you start another session. You can also use
this preference tool to manage multiple GNOME sessions.</para>
    <para>You can customize the settings for sessions and startup applications
in the following functional areas:</para>
    <itemizedlist>
      <listitem>
        <para>
          <guilabel>Session Options</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Current Session</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Startup Programs</guilabel>
        </para>
      </listitem>
    </itemizedlist>
    <sect2 id="goscustsession-16">
      <title>Setting Session Preferences</title>
      <indexterm>
        <primary>sessions</primary>
        <secondary>setting options</secondary>
      </indexterm>
      <para>Use the <guilabel>Session Options</guilabel> tabbed section
to manage multiple sessions, and to set preferences for the current session.</para>
      <para><xref linkend="goscustsession-TBL-11"/> lists the session options that
you can modify.</para>
      <table frame="topbot" id="goscustsession-TBL-11">
        <title>Session Options</title>
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="colspec0" colwidth="18.86*"/>
          <colspec colname="colspec1" colwidth="47.14*"/>
          <thead>
            <row>
              <entry colsep="0" rowsep="1">
                <para>Dialog Element</para>
              </entry>
              <entry colsep="0" rowsep="1">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Show splash
screen on login</guilabel>
                </para>
              </entry>
              <entry colsep="0" rowsep="0" valign="top">
                <para>Select this option to display a splash screen when you start a session. </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Prompt on logout</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select this option to display a confirmation
dialog when you end a session. </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Automatically save changes to session</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <indexterm>
                  <primary>startup applications</primary>
                  <secondary>session-managed</secondary>
                </indexterm>
                <para>Select this
option if you want the session manager to save the current state of your session.
The session manager saves the session-managed applications that are open,
and the settings associated with the session-managed applications. The next
time that you start a session, the applications start automatically, with
the saved settings.</para>
                <para> If you do not select this option, when you
end your session the <guilabel>Logout Confirmation</guilabel> dialog displays
a <guilabel>Save current setup</guilabel> option.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Sessions</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Use this area of the dialog to manage multiple sessions
in the GNOME Desktop, as follows:</para>
                <itemizedlist>
                  <listitem>
                    <para>To create a new session, click on the <guibutton>Add</guibutton>
button.  The <guilabel>Add a new session</guilabel> dialog is displayed. Use
this dialog to specify a name for your session.</para>
                  </listitem>
                  <listitem>
                    <para>To change the name of a session, select the session in the <guilabel>Sessions</guilabel> table. Click on the <guibutton>Edit</guibutton>
button. The <guilabel>Edit session name</guilabel> dialog is displayed. Type
a new name for your session.</para>
                  </listitem>
                  <listitem>
                    <para>To delete a session, select the session in the <guilabel>Sessions</guilabel> table. Click on the <guibutton>Delete</guibutton>
button.</para>
                  </listitem>
                </itemizedlist>
                <para>When you log in on GDM, you choose
a session. When you choose a session, you can select which of the multiple
sessions to use.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="goscustlookandfeel-27">
      <title>Setting Session Properties</title>
      <indexterm>
        <primary>startup applications</primary>
        <secondary>session-managed</secondary>
      </indexterm>
      <indexterm>
        <primary>sessions</primary>
        <secondary>setting properties</secondary>
      </indexterm>
      <para>Use the <guilabel>Current
Session</guilabel> tabbed section to specify startup order values, and to
choose restart styles for the session-managed applications in your current
session. </para>
      <para><xref linkend="sessprop01"/> lists the session properties that you can
configure. </para>
      <table frame="topbot" id="sessprop01">
        <title>Session Properties</title>
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="colspec0" colwidth="18.86*"/>
          <colspec colname="colspec1" colwidth="47.14*"/>
          <thead>
            <row>
              <entry colsep="0" rowsep="1">
                <para>Dialog Element</para>
              </entry>
              <entry colsep="0" rowsep="1">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Order</guilabel>
                </para>
              </entry>
              <entry colsep="0" rowsep="0" valign="top">
                <para>The <guilabel>Order</guilabel>
property specifies the order in which the session manager starts session-managed
startup applications. The session manager starts applications with lower order
values first. The default value is 50.</para>
                <para>To specify the startup
order of an application, select the application in the table. Use the <guilabel>Order</guilabel> spin box to specify the startup order value.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Style</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>The <guilabel>Style</guilabel> property determines the
restart style of an application. To select a restart style for an application,
select the application in the table, then choose one of the following styles:</para>
                <itemizedlist>
                  <listitem>
                    <para>
                      <guilabel>Normal</guilabel>
                    </para>
                    <para>Starts automatically when you start a GNOME session.</para>
                  </listitem>
                  <listitem>
                    <para>
                      <guilabel>Restart</guilabel>
                    </para>
                    <para>Restarts automatically whenever you close or terminate the application.
Choose this style for an application if the application must run continuously
during your  session.</para>
                  </listitem>
                  <listitem>
                    <para>
                      <guilabel>Trash</guilabel>
                    </para>
                    <para>Does not start when you start a GNOME session.</para>
                  </listitem>
                  <listitem>
                    <para>
                      <guilabel>Settings</guilabel>
                    </para>
                    <para>Starts automatically when you start a  session. Applications with this
style usually have a low startup order, and store your configuration settings
for GNOME and session-managed applications.</para>
                  </listitem>
                </itemizedlist>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guibutton>Remove</guibutton>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Click on the <guibutton>Remove</guibutton> button to delete
the selected application from the list. The application is removed from the
session manager,  and closed. If you save the session after doing this any
deleted applications will not start the next time you start a session.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0">
                <para>
                  <guibutton>Apply</guibutton>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0">
                <para>Click on the <guibutton>Apply</guibutton> button to apply changes to the startup
order and the restart style.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="goscustsession-12">
      <title>Configuring Startup Applications</title>
      <indexterm>
        <primary>startup applications</primary>
        <secondary>non-session-managed</secondary>
      </indexterm>
      <para>Use the <guilabel>Startup Programs</guilabel>
tabbed section of the <application>Sessions</application> preference tool
to specify non-session-managed <firstterm>startup applications</firstterm>.
Startup applications are applications that start automatically when you start
a session. You specify the commands that run the non-session-managed applications
in the <guilabel>Startup Programs</guilabel> tabbed section. The commands
execute automatically when you log in.</para>
      <para>You can also start session-managed applications automatically. For more
information, see <xref linkend="goscustsession-16"/>.</para>
      <para><xref linkend="goscustsession-TBL-19"/> lists the startup applications
preferences that you can modify.</para>
      <table frame="topbot" id="goscustsession-TBL-19">
        <title>Startup Programs Preferences</title>
        <tgroup cols="2">
          <colspec colname="col1" colwidth="18.86*"/>
          <colspec colname="col2" colwidth="47.14*"/>
          <thead>
            <row>
              <entry colname="col1" colsep="0">
                <para>Dialog Element</para>
              </entry>
              <entry colname="col2" colsep="0">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="col1" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel> Additional startup programs</guilabel>
                </para>
              </entry>
              <entry colname="col2" colsep="0" rowsep="0" valign="top">
                <para>Use this table to manage non-session-managed
startup applications as follows:</para>
                <itemizedlist>
                  <listitem>
                    <para>To add a startup application, click on the <guibutton>Add</guibutton> button. The <guilabel>Add Startup Program</guilabel> dialog is
displayed. Enter the command to start the application in the <guilabel>Startup
Command</guilabel> field. </para>
                    <para>If you specify more than one startup application, use the <guilabel>Priority</guilabel> spin box to specify the startup order of the each application.
The startup order is the order in which you want the startup applications
to start.</para>
                  </listitem>
                  <listitem>
                    <para>To edit a startup application, select the startup application,
then click on the <guibutton>Edit</guibutton> button. The <guilabel>Edit Startup
Program</guilabel> dialog is displayed. Use the dialog to modify the command
and the startup order for the startup application.</para>
                  </listitem>
                  <listitem>
                    <para>To delete a startup application, select the startup application,
then click on the <guilabel>Delete</guilabel> button.</para>
                  </listitem>
                </itemizedlist>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
  </sect1>
  <sect1 id="goscustmulti-2">
    <title>Sound Preferences</title>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Sound</secondary>
    </indexterm>
    <indexterm>
      <primary>sound</primary>
      <secondary>setting preferences</secondary>
    </indexterm>
    <indexterm>
      <primary>sound</primary>
      <secondary>associating
events with sounds</secondary>
    </indexterm>
    <indexterm>
      <primary>events, associating
sounds with</primary>
    </indexterm>
    <indexterm>
      <primary>sound server</primary>
    </indexterm>
    <para>The <application>Sound</application> preference tool enables
you to control when the GNOME sound server starts. You can also specify which
sounds to play when particular events occur.</para>
    <para>You can customize the settings for the <application>Sound</application>
preference tool in the following functional areas:</para>
    <itemizedlist>
      <listitem>
        <para>
          <guilabel>General</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Sound Events</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>System Bell</guilabel>
        </para>
      </listitem>
    </itemizedlist>
    <sect2 id="goscustmulti-3">
      <title>General Sound Preferences</title>
      <para>Use the <guilabel>General</guilabel> tabbed section of the <application>Sound</application> preference tool to specify when to launch the GNOME sound
server. You can also enable sound event functions.</para>
      <para><xref linkend="goscustmulti-TBL-4"/> lists the general sound preferences
that you can modify.</para>
      <table frame="topbot" id="goscustmulti-TBL-4">
        <title>General Sound Preferences</title>
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="colspec18" colwidth="19.21*"/>
          <colspec colname="colspec19" colwidth="46.79*"/>
          <thead>
            <row>
              <entry colsep="0" rowsep="1">
                <para>Dialog Element</para>
              </entry>
              <entry colsep="0" rowsep="1">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Enable sound
server startup</guilabel>
                </para>
              </entry>
              <entry colsep="0" rowsep="0" valign="top">
                <para>Select this option to start the GNOME sound server when you start a GNOME
session. When the sound server is active, the GNOME Desktop can play sounds.</para>
              </entry>
            </row>
            <row>
              <entry colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Sounds for
events</guilabel>
                </para>
              </entry>
              <entry colsep="0" rowsep="0" valign="top">
                <para>Select this option to play sounds when particular events occur in the GNOME
Desktop. You can select this option only if the <guilabel>Enable sound server
startup</guilabel> option is selected.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="goscustdesk-48">
      <title>Sound Event Preferences</title>
      <para>Use the <guilabel>Sound Events</guilabel> tabbed section of the <application>Sound</application> preference tool to associate particular sounds with particular
events. </para>
      <note>
        <para>You must select the <guilabel>Enable sound server startup</guilabel>
option, and the <guilabel>Sounds for events</guilabel> option before you can
access the <guilabel>Sound Events</guilabel> tabbed section.</para>
      </note>
      <para><xref linkend="goscustmulti-TBL-6"/> lists the sound events preferences
that you can modify.</para>
      <table frame="topbot" id="goscustmulti-TBL-6">
        <title>Sound Event Preferences</title>
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="colspec18" colwidth="19.21*"/>
          <colspec colname="colspec19" colwidth="46.79*"/>
          <thead>
            <row>
              <entry colsep="0" rowsep="1">
                <para>Dialog Element</para>
              </entry>
              <entry colsep="0" rowsep="1">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
                <para><guilabel>Sounds</guilabel> table</para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
                <para>Use the <guilabel>Sounds</guilabel> table to
associate particular sounds with particular events. </para>
                <para>The <guilabel>Event</guilabel> column displays a hierarchical list of events that can occur.
To expand a category of events, click on the right arrow beside a category
of events.</para>
                <para>The <guilabel>File to play</guilabel> column lists
the sound file that plays when the event occurs.</para>
              </entry>
            </row>
            <row>
              <entry colsep="0" rowsep="0" valign="top">
                <para>
                  <guibutton>Play </guibutton>
                </para>
              </entry>
              <entry colsep="0" rowsep="0" valign="top">
                <para>Click on this button to play
the sound file that is associated with the selected event. </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
                <para>Sound file drop-down combination box, <guibutton>Browse </guibutton></para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
                <para>To associate
a sound with an event, select the event in the <guilabel>Sounds</guilabel>
table. Enter the name of the sound file that you want to associate with the
selected event in the drop-down combination box. Alternatively, click <guibutton>Browse </guibutton> to display a <guilabel>Select sound file</guilabel> dialog.
Use the dialog to specify the sound file that you want to associate with the
selected event.</para>
                <note>
                  <para>You can only associate sound files in <filename>.wav</filename> format with events.</para>
                </note>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="goscustdesk-41">
      <title>System Bell Settings</title>
      <indexterm>
        <primary>keyboard</primary>
        <secondary>configuring sound preferences</secondary>
      </indexterm>
      <indexterm>
        <primary>sound</primary>
        <secondary>configuring
system bell preferences</secondary>
      </indexterm>
      <indexterm>
        <primary>system
bell</primary>
        <secondary>configuring preferences</secondary>
      </indexterm>
      <para>Use the <guilabel>System Bell</guilabel> tabbed section to set your preferences
for the system bell.</para>
      <para>Some applications play a bell sound to indicate a keyboard input error.
Use the preferences in the <guilabel>System Bell</guilabel> tabbed section
to configure the bell sound. <xref linkend="goscustdesk-TBL-1"/> lists the
system bell preferences that you can modify.</para>
      <table frame="topbot" id="goscustdesk-TBL-1">
        <title>System Bell Preferences</title>
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="colspec18" colwidth="19.21*"/>
          <colspec colname="colspec19" colwidth="46.79*"/>
          <thead>
            <row>
              <entry colsep="0" rowsep="1">
                <para>Dialog Element</para>
              </entry>
              <entry colsep="0" rowsep="1">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0">
                <para>
                  <guilabel>Sound
an audible bell</guilabel>
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0">
                <para>Select this option to enable the system bell.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Visual feedback</guilabel>
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
                <para>Select this option to enable visual feedback
to indicate input errors. </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0">
                <para>
                  <guilabel>Flash
window titlebar</guilabel>
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0">
                <para>Select this option if you want window titlebars to flash
to indicate an input error. </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0">
                <para>
                  <guilabel>Flash
entire screen</guilabel>
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0">
                <para>Select this option if you want the entire screen to flash
to indicate an input error. </para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
  </sect1>
  <sect1 id="prefs-theme">
    <title>Theme Preferences</title>

    <!-- preserve for backwards compatibility: 2.12 -->
    <anchor id="goscustdesk-12"/>    
    
    <indexterm>
      <primary>themes</primary>
      <secondary>setting controls options</secondary>
    </indexterm>
    <indexterm>
      <primary>themes</primary>
      <secondary>setting window
frame options</secondary>
    </indexterm>
    <indexterm>
      <primary>themes</primary>
      <secondary>setting icons options</secondary>
    </indexterm>
    <indexterm>
      <primary>windows</primary>
      <secondary>setting frame theme options</secondary>
    </indexterm>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Theme</secondary>
    </indexterm>
    <para>A theme is a group of coordinated settings that specifies
the visual appearance of a part of the GNOME Desktop. You can choose themes
to change the appearance of the GNOME Desktop. Use the <application>Theme</application> preference tool to select a theme. You can choose from a list
of available themes. The list of available themes includes several themes
for users with accessibility requirements. </para>
    <para>A theme contains settings that affect different parts of the GNOME Desktop,
as follows:</para>
    <variablelist>
      <varlistentry>
        <term>Controls</term>
        <listitem>
          <para><indexterm><primary>GTK+
themes</primary><see>themes, controls options</see></indexterm><indexterm><primary>themes</primary><secondary>controls options</secondary><tertiary>introduction</tertiary></indexterm>The controls setting for a theme determines
the visual appearance of windows, panels, and applets. The controls setting
also determines the visual appearance of the GNOME-compliant interface items
that appear on windows, panels, and applets, such as menus, icons, and buttons.
Some of the controls setting options that are available are designed for special
accessibility needs. You can choose an option for the controls setting from
the <guilabel>Controls</guilabel> tabbed section in the <application>Theme Details</application>.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Window frame</term>
        <listitem>
          <para><indexterm><primary>themes</primary><secondary>window frame options</secondary><tertiary>introduction</tertiary></indexterm><indexterm><primary>Metacity themes</primary><see>themes, window frame options</see></indexterm>The window frame setting for
a theme determines the appearance of the frames around windows only. You can
choose an option for the window frame setting from the <guilabel>Window Border</guilabel> tabbed section in the <application>Theme Details</application>.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Icon</term>
        <listitem>
          <para><indexterm><primary>themes</primary><secondary>icons options</secondary><tertiary>introduction</tertiary></indexterm><indexterm><primary>icon themes</primary><see>themes, icons options</see></indexterm>The icon setting for a theme determines the appearance of
the icons on panels and the desktop background. You can choose an option for
the icon setting from the <guilabel>Icons</guilabel> tabbed section in the <application>Theme Details</application>.</para>
        </listitem>
      </varlistentry>
    </variablelist>
    <sect2 id="goscustdesk-61">
      <title>To Create a Custom Theme</title>
      <para>The themes that are listed in the <application>Theme</application> preferences
tool are different combinations of controls options, window frame options,
and icon options. You can create a custom theme that uses different combinations
of controls options, window frame options, and icon options.</para>
      <para>To create a custom theme, perform the following steps:</para>
      <orderedlist>
        <listitem>
          <para>Start the <application>Theme</application> preference tool.</para>
        </listitem>
        <listitem>
          <para>Select a theme in the list of themes.</para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Theme Details</guibutton> button. A <guilabel>Theme Details</guilabel> dialog is displayed.</para>
        </listitem>
        <listitem>
          <para>Select the controls option that you want to use in the custom
theme from the list in the <guilabel>Controls</guilabel> tabbed section. The
list of available controls options includes several options for users with
accessibility requirements.</para>
        </listitem>
        <listitem>
          <para>Click on the <guilabel>Window Border</guilabel> tab to display
the <guilabel>Window Border</guilabel> tabbed section. Select the window frame
option that you want to use in the custom theme from the list of available
options. The list of available window frame options includes several options
for users with accessibility requirements.</para>
        </listitem>
        <listitem>
          <para>Click on the <guilabel>Icons</guilabel> tab to display the <guilabel>Icons</guilabel> tabbed section. Select the icons option that you want to
use in the custom theme from the list of available options. The list of available
icons options includes several options for users with accessibility requirements.</para>
        </listitem>
        <listitem>
          <para>Click <guibutton>Close</guibutton> to close the <guilabel>Theme Details</guilabel> dialog.</para>
        </listitem>
        <listitem>
          <para>On the <application>Theme</application> preferences tool,
click on the <guibutton>Save theme</guibutton> button. A <guilabel>Save theme
to disk</guilabel> dialog is displayed.</para>
        </listitem>
        <listitem>
          <para>Type a name and a short description for the custom theme in
the dialog, then click <guibutton>Save</guibutton>. The custom theme now appears
in your list of available themes.</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2 id="goscustdesk-62">
      <title>To Install a New Theme</title>
      <para>You can add a theme to the list of available themes. The new theme must
be an archive file that is tarred and zipped. That is, the new theme must
be a <filename>.tar.gz</filename> file.</para>
      <para>To install a new theme, perform the following steps:</para>
      <orderedlist>
        <listitem>
          <para>Start the <application>Theme</application> preference tool.</para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Install Theme</guibutton> button.
A <guilabel>Theme Installation</guilabel> dialog is displayed.</para>
        </listitem>
        <listitem>
          <para>Enter the location of the theme archive file in the drop-down
combination box. Alternatively, to browse for the file, click on the <guibutton>Browse</guibutton> button. When you have selected the file, click <guibutton>OK</guibutton>.</para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Install</guibutton> button to install
the new theme. </para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2 id="goscustdesk-80">
      <title>To Install a New Theme Option</title>
      <para>You can install new controls options, window frame options, or icons
options. You can find many controls options on the Internet.</para>
      <para>To install a new controls option, window frame option, or icons option,
perform the following steps:</para>
      <orderedlist>
        <listitem>
          <para>Start the <application>Theme</application> preference tool.</para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Theme Details</guibutton> button.
An <guilabel>Theme Details</guilabel> dialog is displayed.</para>
        </listitem>
        <listitem>
          <para>Click on the tab for the type of theme that you want to install.
For example, to install an icons option, click on the <guilabel>Icons</guilabel>
tab.</para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Install Theme</guibutton> button.
A <guilabel>Theme Installation</guilabel> dialog is displayed.</para>
        </listitem>
        <listitem>
          <para>Enter the location of the option archive file in the drop-down
combination box. Alternatively, to browse for the file, click on the <guibutton>Browse</guibutton> button. When you have selected the file, click <guibutton>OK</guibutton>.</para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Install</guibutton> button to install
the new option. </para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2 id="goscustdesk-81">
      <title>To Delete a Theme Option</title>
      <para>You can delete controls options, window frame options, or icons options.</para>
      <para>To delete a controls option, window frame option, or icons option, perform
the following steps:</para>
      <orderedlist>
        <listitem>
          <para>Start the <application>Theme</application> preference tool.</para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Theme Details</guibutton> button.
A <guilabel>Theme Details</guilabel> dialog is displayed.</para>
        </listitem>
        <listitem>
          <para>Click on the tab for the type of option that you want to delete. </para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Go To Theme Folder</guibutton> button.
A file manager window opens on the default option folder.</para>
        </listitem>
        <listitem>
          <para>Use the file manager window to delete the option.</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2 id="goscustdesk-82">
      <title>Previewing Themes</title>
      <para>You can use the file manager to preview and change themes. To change
themes, perform the following steps:</para>
      <orderedlist>
        <listitem>
          <para>Use the file manager to access the <command>themes:///</command>
URI. The themes are displayed as icons.</para>
        </listitem>
        <listitem>
          <para>Double-click on a theme to change the theme.</para>
        </listitem>
      </orderedlist>
    </sect2>
  </sect1>
  <sect1 id="prefs-windows">
    <title>Windows Preferences</title>

    <!-- preserve for backwards compatibility: 2.12 -->
    <anchor id="goscustdesk-58"/>    

    <indexterm>
      <primary>window manager</primary>
      <secondary>customizing</secondary>
    </indexterm>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Windows</secondary>
    </indexterm>
    <para>Use the <application>Windows</application>
preference tool to customize window behavior for the GNOME Desktop.</para>
    <para><xref linkend="goscustwindows-TBL-14"/> lists the windows preferences
that you can modify.</para>
    <table frame="topbot" id="goscustwindows-TBL-14">
      <title>Windows Preferences</title>
      <tgroup cols="2" colsep="1" rowsep="1">
        <colspec colname="colspec0" colwidth="18.86*"/>
        <colspec colname="colspec1" colwidth="47.14*"/>
        <thead>
          <row>
            <entry colsep="0" rowsep="1">
              <para>Dialog Element</para>
            </entry>
            <entry colsep="0" rowsep="1">
              <para>Description</para>
            </entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Select windows when the mouse moves over them</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Select this option
to give focus to a window when you point to the window. The window retains
focus until you point to another window.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Raise selected windows after an interval</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Select this option to raise windows
a short time after the window receives focus.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Interval before raising</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Specify the interval to wait before
raising a window that has received focus.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>Double-click titlebar to perform this action</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Select the behavior
that you want to occur when you double-click on a window titlebar. Select
one of the following options:</para>
              <itemizedlist>
                <listitem>
                  <para><guilabel>Maximize</guilabel>: Maximizes the window.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Roll up</guilabel>: Roll up the window.</para>
                </listitem>
              </itemizedlist>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
              <para>
                <guilabel>To move a window, press-and-hold this key then grab the window</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Select
the key to press-and-hold when you drag a window to move the window.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </sect1>
</chapter>