<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>
  <!-- move the following to its own section, "Using Pref Tools"? -->
  <para>A preference tool is a small application that allows you to change settings in the GNOME Desktop. Each preference tool covers a particular aspect of your computer. For example, with the <application>Mouse</application> preference tool you can set your mouse to left-handed or right-handed use, or change the speed of the pointer on the screen. With the <application>Windows</application> preference tool you can set behaviour common to all windows such as the way in which you select them with the mouse.</para>
  <para>To open a preference tool, choose <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu></menuchoice> in the top panel. Choose the tool that you require from the submenu.</para>
  <para>With a few exceptions, the changes you make to settings in a preference tool take effect immediately, without needing to close the preference tool. You can keep the preference tool window open while you try the changes, and make further changes if you wish.</para>
  <para>Some applications or system components may add their own preference tools to the menu.</para>
  <note><para>Some preference tools let you modify essential parts of your system, and therefore require administrative access. When you open the preference tool, a dialog box will prompt you for your password. These are in the <menuchoice><guimenu>System</guimenu><guisubmenu>Administration</guisubmenu></menuchoice> submenu. This menu also contains more complex utility applications for managing and updating your system.</para></note>


<sect1 id="prefs-personal">
	<title>Personal</title>

  <sect2 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>
  </sect2>


  <sect2 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>
  </sect2>


  <sect2 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>System</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>

    <sect3 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>
    </sect3>
    <sect3 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>
    </sect3>
    <sect3 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>
    </sect3>
  </sect2>

  <sect2 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>Use the <application>Keyboard Shortcuts</application> preference tool to customize the default keyboard shortcuts to your requirements.</para>    
    
    <para>A <firstterm>keyboard shortcut</firstterm> is a key or combination of
keys that provides an alternative to standard ways of performing an action. For more on keyboard shortcuts, and a list of the default shortcuts in GNOME, see <xref linkend="keyboard-skills"/>.</para>

    <para>To edit a keyboard shortcut, perform the following steps:</para>
    <orderedlist>
	    <listitem><para>
	    Click the action in the list. If you are using the the keyboard, use the arrow keys to select the shortcut and press <keycap>Return</keycap>.</para></listitem>
	    <listitem>
	      <para>Press the new key or key combination you want to assign to the action.</para>
	      <para>To clear a shortcut, press <keycap>Backspace</keycap>. The action is now marked as <guilabel>Disabled</guilabel>.</para>
	    </listitem>
    </orderedlist>
    
    <para>To cancel assigning a shortcut, click elsewhere in the window or press <keycap>Escape</keycap>.</para>
    
    <para>The shortcuts you can customize are grouped as follows:</para>
    
    <variablelist>
    	<varlistentry><term>Desktop</term>
    	  <listitem><para>These are general shortcuts for the whole desktop, such as logging out, <link linkend="lock-screen">locking the screen</link>, opening the <link linkend="menubar">panel menubar</link>, or launching a web browser.</para></listitem>
    	</varlistentry>
    	<varlistentry><term>Sound</term>
    	  <listitem><para>Shortcuts for controlling your music player and the system volume.</para></listitem>
    	</varlistentry>
    	<varlistentry><term>Window Management</term>
    	  <listitem><para>Shortcuts for working with windows and workspaces, such as maximizing or moving the current window, and switching to another workspace. For more information on these kinds of actions, see <xref linkend="windows-manipulating"/> and <xref linkend="overview-workspaces"/>.</para></listitem>
    	</varlistentry>    	
    </variablelist>
  </sect2>  

  <sect2 id="prefs-preferredapps">
    <title>Preferred Applications</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="goscustdoc-2"/>       
    <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>System</guimenu>
menu then choose <guimenuitem>Open Terminal</guimenuitem>, <application>Xterm</application> starts.</para>
	<para> <application>Preferred Applications</application> can be found by going to
<menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Preferred Applications</guimenuitem></menuchoice>.</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>Terminal</guilabel>
        </para>
      </listitem>
    </itemizedlist>
    <sect3 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>
section under the <guilabel>Internet</guilabel> tab to select 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>
    </sect3>
    <sect3 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>
section under the <guilabel>Internet</guilabel> tab to configure your preferred email client.  
The email client selected here will be opened when you click on an email address link in a document 
or web browser.</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>
    </sect3>
    <sect3 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 <guilabel>Terminal Emulator</guilabel> section under the 
<guilabel>System</guilabel> tab 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>
    </sect3>
  </sect2>

</sect1>

<sect1 id="prefs-look-and-feel">
	<title>Look and Feel</title>

  <sect2 id="prefs-desktopbackground">
    <title>Desktop Background Preferences</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="goscustdesk-7"/>       
    <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 <link linkend="overview-desktop">desktop</link> background is the image or color that is applied to your
desktop. You can open <application>Desktop Background Preferences</application> by right-clicking on the desktop and choosing <guimenuitem>Change Desktop Background</guimenuitem>, as well as from the <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu></menuchoice> menu.</para>
    <para>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>
    <tip><para>You can also drag a color or a pattern to the desktop from the <link linkend="nautilus-backgrounds-and-emblems"><guilabel>Backgrounds
and Emblems</guilabel> dialog</link> in the <application>Nautilus</application> file manager.</para></tip>
    <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, respecting the image's original size.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Fill Screen</guilabel>: Enlarges the image to cover
the desktop, altering its proportions if needed.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Scaled</guilabel>: Enlarges the image until the
image meets the screen edges, and maintains the proportions of the image.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Zoom</guilabel>: Enlarges the smaller dimension of the 
image until it meets the screen edges; the image may be cropped in the other dimension.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Tiled</guilabel>: Duplicates the original-sized image as
often as necessary and print the images next to another so as they entirely cover the desktop.</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>
  </sect2>

  <sect2 id="prefs-font">
    <title>Font Preferences</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="goscustdesk-38"/>     
    <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 choose which fonts are used in different parts of the desktop, and the way in which fonts are displayed on the screen.</para>

    <sect3 id="prefs-font-choose">
      <title>Choosing Fonts</title>
      
      <para>The font selector button shows the name of the font and its point size. The name is also shown in bold, italic, or regular type.</para>
      <para>To change the font, click the font selector button. The font picker dialog opens. Select the font family, style, and point size from the lists. The preview area shows your current choice. Click <guibutton>OK</guibutton> to accept the change and update the desktop.</para>
      <para>You can choose fonts for the following parts of the desktop:</para>

      <variablelist>
       	<varlistentry>
      	  <term><guilabel>Application font</guilabel></term>
      	  <listitem>
      	    <para>This font is used in the menus, toolbars, and dialog boxes of applications.</para>
      	  </listitem>
      	</varlistentry>
      	<varlistentry>
      	  <term><guilabel>Document font</guilabel></term>
      	  <listitem>
      	    <para>This font is used to display documents in applications.</para>
      	    <note><para>In some applications, you can override this choice in the application's preferences dialog.</para></note>
      	  </listitem>
      	</varlistentry>
       	<varlistentry>
      	  <term><guilabel>Desktop font</guilabel></term>
      	  <listitem>
      	    <para>This font is used in icon labels on the desktop.</para>
      	  </listitem>
      	</varlistentry>
       	<varlistentry>
      	  <term><guilabel>Window title font</guilabel></term>
      	  <listitem>
      	    <para>This font is used in the titlebars of windows.</para>
      	  </listitem>
      	</varlistentry>
       	<varlistentry>
      	  <term><guilabel>Fixed width font</guilabel></term>
      	  <listitem>
      	    <para>This font is used in the <application>Terminal</application> application and applications to do with programming.</para>
      	  </listitem>
      	</varlistentry>
      	</variablelist>
  	</sect3>
	
  	<sect3 id="prefs-font-rendering">
      <title>Font Rendering</title>
      <para>You can set the following options relating to how fonts are displayed on the screen:</para>
	
    	<variablelist>
     	<varlistentry>
    	  <term><guilabel>Font Rendering</guilabel></term>
    	  <listitem>
    	    <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>
    	  </listitem>
    	</varlistentry>
     	<varlistentry>
    	  <term><guibutton>Details</guibutton></term>
    	  <listitem>
    	    <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>
    	  </listitem>
    	</varlistentry>
     	<varlistentry>
    	  <term><guibutton>Go to font folder</guibutton></term>
    	  <listitem>
    	    <para>Click on this button to open the <guilabel>Fonts</guilabel>
    folder.</para>
    	  </listitem>
    	</varlistentry>
    </variablelist>
   
    </sect3>
    <sect3 id="goscustdesk-83">
      <title>Previewing a Font</title>
      <indexterm>
        <primary>fonts</primary>
        <secondary>previewing</secondary>
      </indexterm>
      <para>A preview of a font shows the characters of a font at different sizes, as well as copyright and technical information. To preview a font, perform the following steps:</para>
      <orderedlist>
        <listitem>
          <para>Open the <application>Font</application> preference tool by choosing <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Font</guimenuitem></menuchoice> in the top panel.</para>
        </listitem>
        <listitem><para>Click on <guibutton>Details</guibutton>.</para></listitem>
        <listitem><para>Click on <guibutton>Go to font folder</guibutton>. The <guilabel>Fonts</guilabel> folder opens.</para></listitem>
        <listitem>
          <para>Open a font to display a preview.</para>
        </listitem>
      </orderedlist>
    </sect3>
    <sect3 id="goscustdesk-94">
      <title>Adding a TrueType Font</title>
      <para>To add a TrueType font to your system, perform the following steps:</para>
      <orderedlist>
        <listitem>
          <para>Open the <application>Font</application> preference tool by choosing <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Font</guimenuitem></menuchoice> in the panel menubar.</para>
        </listitem>
        <listitem><para>Click on <guibutton>Details</guibutton>.</para></listitem>
        <listitem><para>Click on <guibutton>Go to font folder</guibutton>. The <guilabel>Fonts</guilabel> folder opens.</para></listitem>      
        <listitem>
          <para>Open a file manager window and select the TrueType font that
you want to add.</para>
        </listitem>
        <listitem>
          <para>Copy the TrueType font file that you want to add to the <guilabel>Fonts</guilabel> folder.</para>
        </listitem>
      </orderedlist>
      <warning><para>The new font will not appear in the <guilabel>Fonts</guilabel> folder until you next log in. You will need to relaunch applications for them to have access to the new font. These are known bugs in Gnome.</para></warning>
      
      <tip><para>You can also open the <guilabel>Fonts</guilabel> folder by typing the following URI into <application>Nautilus</application> file manager's <link linkend="nautilus-open-location">Open Location dialog</link>: <command>fonts:///</command>.</para></tip>
    </sect3>
  </sect2>

  <sect2 id="prefs-menustoolbars">
    <title>Menus &amp; Toolbars Preferences</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="goscustuserinter-2"/>    
    <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 applications that are part of GNOME.</para>
    <para>As you make changes to the settings, the preview display in the window updates. This allows you to see the changes if no application windows are currently open.</para>
    <variablelist>
     	<varlistentry>
    	  <term><guilabel>Show icons in menus</guilabel></term>
    	  <listitem>
    	    <para>Select this option to display an icon beside
    items in application menus and the panel menu. Not all menu items have an icon.</para>
    	  </listitem>
    	</varlistentry>
    	<varlistentry>
    	  <term><guilabel>Editable menu accelerators</guilabel></term>
	      <listitem><para>Selecting this option allows you to define new keyboard shortcuts for menu items.</para>
	      <para>To change an application shortcut key, open the menu, and with the mouse pointer on the menu item you wish to change, press the new combination of keys. To remove a shortcut key, press <keycap>Backspace</keycap> or <keycap>Delete</keycap>.</para>
	      <warning>
	        <para>When using this feature, you will not be warned if assigning a new shortcut key to a command also removes it from another command.</para>
	        <para>There is no way to restore the original, default keyboard shortcut for a command.</para>
	        <para>This feature does not maintain shortcuts that are normally common to all applications, such as <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> for Copy. This may lead to inconsistencies in your GNOME applications.</para>
	      </warning>
	      </listitem>
      </varlistentry>
     	<varlistentry>
    	  <term><guilabel>Detachable toolbars</guilabel></term>
    	  <listitem>
    	    <para>Selecting this option allows you to move toolbars
    from application windows to any location on the screen. A handle is 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>
    	  </listitem>
    	</varlistentry>
     	<varlistentry>
    	  <term><guilabel>Toolbar button labels</guilabel></term>
    	  <listitem>
    	    <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>
    	  </listitem>
    	</varlistentry>
    </variablelist>
  </sect2>

  <sect2 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>
    <sect3 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>
    </sect3>
    <sect3 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>
    </sect3>
    <sect3 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>
    </sect3>
    <sect3 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>
    </sect3>
    <sect3 id="goscustdesk-82">
      <title>Previewing Themes</title>
      <para>As well as the Theme preference tool, you can also use the file manager to 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>
    </sect3>
  </sect2>

  <sect2 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>
  </sect2>

  <sect2 id="prefs-screensaver">
    <title>Screensaver Preferences</title>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>screensaver</secondary>
    </indexterm>
    <para>A <firstterm>screensaver</firstterm> displays moving images on your screen when your computer is not being used. Screensavers also help prevent older monitors being damaged by the same image being displayed for long periods of time. To stop the screensaver and return to the desktop, move the mouse or press a key on the keyboard.</para>
    <para>Use the <application>Screensaver</application> preference tool to set the type of screensaver, the time before the screensaver starts, and whether to require a password to return to the desktop.</para>
    <para>You can modify the following settings:</para>
    <variablelist>
    	<varlistentry>
    	  <term>Screensaver</term>
    	  <listitem><para>Select the <guilabel>Screensaver theme</guilabel> from the list. A reduced version of the selected screensaver theme is shown. Press <guibutton>Preview</guibutton> to show the selected theme on the whole screen. During preview, use the arrow buttons at the top of the screen to go through the list of screensaver themes.</para>
    	  <itemizedlist>
	        <listitem><para>The <guilabel>Blank screen</guilabel> theme displays no image and only shows a black screen.</para></listitem>
	        <listitem><para>The <guilabel>Random</guilabel> theme selects a screensaver to display from the list at random.</para></listitem>
        </itemizedlist>
    	  <para>Which screensavers are shown in the remainder of the list depends on your distributor or vendor.</para></listitem>
    	</varlistentry>
    	<varlistentry>
    	  <term>Regard the computer as idle after...</term>
    	  <listitem><para>Your computer becomes idle after this amount of time has passed with no input from you, such as moving the mouse or typing. This may affect power management (the monitor may power down for example) or instant messaging (chat applications may set your status as "away"). Use the slider to set the length of time in minutes or hours.</para></listitem>
    	</varlistentry>
    	<varlistentry>
    	  <term>Activate screensaver when computer is idle</term>
    	  <listitem><para>Select this option to have the screensaver start after the set length of time. </para></listitem>
    	</varlistentry>
    	<varlistentry>
    	  <term>Lock screen when screensaver is active</term>
    	  <listitem><para>When this option is selected, the screensaver will prompt you for your password when you try to return to the desktop. For more on locking your screen, see <xref linkend="lock-screen"/>.</para></listitem>  	
    	</varlistentry>
  </variablelist>
  </sect2>

</sect1>

<sect1 id="prefs-internet-and-network">
	<title>Internet and Network</title>

  <sect2 id="prefs-network-admin">
 	<title>Network Settings</title>

    <para>The <application>Network Settings</application> allows you to specify the way your system connects to other computers and to internet.</para>
    <para>You will be prompted for the administrator password when you start <application>Network Settings</application>. This is because the changes done with this tool will affect the whole system.</para>

  <sect3 id="prefs-network-admin-getting-started">
    <title>Getting started</title>



    <para>The <application>Network Settings</application> main window contains four tabbed sections:</para>

    <variablelist>
	 <varlistentry>
	   <term><guilabel>Connections</guilabel></term>
	   <listitem>
		<para>Shows all network interfaces, it also allows you to modify their settings.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term><guilabel>General</guilabel></term>
	   <listitem>
		<para>Allows you to modify your system host name and domain name.</para>
	   </listitem>
	 </varlistentry>

    	 <varlistentry>
	   <term><guilabel>DNS</guilabel></term>
	   <listitem>
		<para>Contains two sections, the <guilabel>DNS servers</guilabel> are what your computer use for resolving the IP addresses from the domain names. The <guilabel>search domains</guilabel> are the default domains in which your system will search any host when no domain is specified.</para>
	   </listitem>
	 </varlistentry>

      <varlistentry>
	   <term><guilabel>Hosts</guilabel></term>
	   <listitem>
		<para>Shows the list of aliases for accessing other computers.</para>
	   </listitem>
	 </varlistentry>
    </variablelist>
  </sect3>

  <sect3 id="prefs-network-admin-usage">
    <title>Usage</title>

    <sect4 id="tool-modify-connection">
	 <title>To modify a connection settings</title>
	 <para>In the <guilabel>Connections</guilabel> section, select the interface you want to modify and press the <guilabel>Properties</guilabel> button, depending on the interface type you will be able to modify different data.</para>

	 <variablelist>
	   <varlistentry>
		<term>Ethernet and IRLAN interfaces</term>
		<listitem>
		  <para>You can modify the way the interface is configured (DHCP or manually), if the interface is configured manually, you can also modify the interface IP address, netmask and gateway.</para>
		</listitem>
	   </varlistentry>

	   <varlistentry>
		<term>Wireless interfaces</term>
		<listitem>
		  <para>You can modify the way the interface is configured (DHCP or manually), if the interface is configured manually, you can also modify the interface IP address, netmask and gateway, you can also modify the network name (ESSID) for this interface.</para>
		</listitem>
	   </varlistentry>

	   <varlistentry>
		<term>Parallel line interfaces</term>
		<listitem>
		  <para>You can modify the interface IP address, as well as the remote IP address.</para>
		</listitem>
	   </varlistentry>

	   <varlistentry>
		<term>PPP/Modem interfaces</term>
		<listitem>
		  <para>You can modify the modem device, whether you want it to dial using tones or pulses, the modem volume, the phone number, the username and password that your ISP provided and other advanced settings for PPP.</para>
		</listitem>
	   </varlistentry>
	 </variablelist>
    </sect4>

    <sect4>
	 <title>To activate or deactivate an interface</title>
	 <para>In the <guilabel>Connections</guilabel> section, enable or disable the checkbox beside the interface.</para>
    </sect4>
    
    <sect4>
	 <title>To change your host name and domain name</title>
	 <para>In the <guilabel>General</guilabel> section, change the hostname or domain name text boxes.</para>
    </sect4>

    <sect4>
	 <title>To add a new domain name server</title>
	 <para>In the <guilabel>DNS Servers</guilabel> section, press the <guilabel>Add</guilabel> button and fill in the new list row with the new domain name server.</para>
    </sect4>

    <sect4>
	 <title>To delete a domain name server</title>
	 <para>In the <guilabel>DNS Servers</guilabel> section, select a DNS IP address from the list and press the <guilabel>Delete</guilabel> button.</para>
    </sect4>

    <sect4>
	 <title>To add a new search domain</title>
	 <para>In the <guilabel>Search Domains</guilabel> section, press the <guilabel>Add</guilabel> button and fill in the new list row with the new search domain.</para>
    </sect4>

    <sect4>
	 <title>To delete a search domain</title>
	 <para>In the <guilabel>Search Domains</guilabel> section, select a search domain from the list and press the <guilabel>Delete</guilabel> button.</para>
    </sect4>

    <sect4>
	 <title>To add a new host alias</title>
	 <para>In the <guilabel>Hosts</guilabel> section, press the <guilabel>Add</guilabel> button and type an IP address and the aliases that will point to in the window that pops up.</para>
    </sect4>

    <sect4>
	 <title>To modify a host alias</title>
	 <para>In the <guilabel>Hosts</guilabel> section, select an alias, press the <guilabel>Properties</guilabel> button from the list and modify the alias settings in the window that pops up.</para>
    </sect4>

    <sect4>
	 <title>To delete a host alias</title>
	 <para>In the <guilabel>Hosts</guilabel> section, select an alias from the list and press the <guilabel>Delete</guilabel> button.</para>
    </sect4>

    <sect4 id="prefs-network-admin-add-new-profile">
	 <title>To save your current network configuration as a "Location"</title>
	 <para>Press the <guilabel>Add</guilabel> button besides the <guilabel>Locations</guilabel> menu, specify the location name in the window that pops up.</para>
    </sect4>

    <sect4>
	 <title>To delete a location</title>
	 <para>Press the <guilabel>Remove</guilabel> button besides the <guilabel>Locations</guilabel> menu, the selected profile will be deleted.</para>
    </sect4>

    <sect4>
	 <title>To switch to a location</title>
	 <para>Select one location from the <guilabel>Locations</guilabel> menu, all the configuration will be switched automatically to the chosen location.</para>
    </sect4>

	</sect3>
  </sect2>

  <sect2 id="prefs-networkproxy">
    <title>Network Proxy Preferences</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="goscustdesk-50"/>       
    <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.</para>
    <para>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>
    
    <variablelist>
      <varlistentry><term><guilabel>Direct internet
    connection</guilabel></term><listitem><para>Select this option if you want to connect to the Internet without
    a proxy server.</para></listitem></varlistentry>
      <varlistentry><term><guilabel>Manual proxy configuration</guilabel></term><listitem><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>
      <variablelist>
        <varlistentry><term><guilabel>HTTP proxy</guilabel></term><listitem><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></listitem></varlistentry>
        <varlistentry><term><guilabel>Secure HTTP proxy</guilabel></term><listitem><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></listitem></varlistentry>
        <varlistentry><term><guilabel>FTP proxy</guilabel></term><listitem><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></listitem></varlistentry>
        <varlistentry><term><guilabel>Socks host</guilabel></term><listitem><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></listitem></varlistentry>
      </variablelist>
      </listitem></varlistentry>
      <varlistentry><term><guilabel>Automatic proxy
      configuration</guilabel></term><listitem><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></listitem></varlistentry>
      <varlistentry><term><guilabel>Autoconfiguration
      URL</guilabel></term><listitem><para>Enter the URL that contains the information required to configure the proxy
    server automatically. </para></listitem></varlistentry>
    </variablelist>
    
    <para>Set which hosts should not use the proxy in the <guilabel>Ignore Host List</guilabel> in the <guilabel>Advanced Configuration</guilabel> tabbed section. When you access these hosts, you will connect to the Internet directly without a proxy.</para>
    
  </sect2>

  <sect2 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 command text to send it to
another user by email.</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>
  </sect2>  

</sect1>


<sect1 id="prefs-hardware">
	<title>Hardware</title>

  <sect2 id="prefs-keyboard">
    <title>Keyboard Preferences</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="goscustperiph-2"/>       
    <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>
    <!--
    adds no information until each tab can be briefly summarized.
    
    <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>
    -->
    <para>To open the <link linkend="prefs-keyboard-a11y"><application>Keyboard <emphasis>Accessibility</emphasis></application> preference tool</link>, click the <guibutton>Accessibility</guibutton> button.</para>    
    <sect3 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>
    </sect3>
    <sect3 id="prefs-keyboard-layouts">
      <title>Keyboard Layouts Preferences</title>
      <!-- preserve id for backwards compatibility: 2.12 -->
      <anchor id="goscustdesk-100"/>         
      <para>Use the <guilabel>Layouts</guilabel> tabbed section to set your keyboard's language, and also the make and model of keyboard you are using.</para>
      <para>This will allow GNOME to make use of special media keys on your keyboard, and to show the correct characters for your keyboard's language.</para>
      
      <variablelist>
	      <varlistentry>
	        <term><guilabel>Keyboard model</guilabel></term>
	        <listitem><para>Use the browse button (labelled with an ellipsis, <guibutton>...</guibutton>) to choose another keyboard make and model.</para></listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guilabel>Selected Layouts</guilabel></term>
	        <listitem><para>You can switch between selected layouts to change the characters your keyboard produces when you type. To add a layout, click <guibutton>Add</guibutton>. You can have up to four layouts. To remove a layout, select it and press <guibutton>Remove</guibutton>.</para>
	        <para>To switch between keyboard layouts, use the <ulink type="help" url="ghelp:gswitchit"><application>Keyboard Indicator</application> panel applet</ulink>. <!-- better link to the specific page, but not yet suitable for a direct link: ghelp:gswitchit?gswitchit-applet-switching --></para>
	        </listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guilabel>Separate group for each window</guilabel></term>
	        <listitem><para>
	        When this option is selected, each window has its own keyboard layout. Changing to a different layout will only affect the current window.</para>
	        <para>This allows you to to type with a Russian keyboard layout in a word processor, then switch to your web browser and type with an English keyboard layout, for example. </para></listitem>
        </varlistentry>
      </variablelist>
      
      <para>Click <guibutton>Reset to Defaults</guibutton> to restore all keyboard layout settings to their initial state for your system and locale.</para>
    </sect3>
    
    
    <sect3 id="prefs-keyboard-layoutoptions"> 
      <title>Keyboard Layout Options</title>
      <!-- preserve id for backwards compatibility: 2.12 -->
      <anchor id="goscustdesk-101"/>
      <para>The <guilabel>Layout Options</guilabel> tabbed section has options for the behaviour of keyboard modifier keys and certain shortcut options.</para>
      <para>Expand each group label to show the available options. A label in boldface indicates that the options in the group have been changed from the default setting.</para>
      <note><para>The options shown in this tabbed section depend on the X windowing system you are using. Not all the following options might be listed on your system, and not all the options shown might work on your system.</para></note>

      <!-- the options of mystery!!!       
           for future reference, these are in
           /etc/X11/xkb/rules/xorg.xml
      -->
      <variablelist>
        <varlistentry>
                <term><guilabel>Adding the EuroSign to certain keys</guilabel></term>
                <listitem>
                  <para>Use these options to add the Euro currency symbol to a key as a third-level character. To access this symbol, you must assign a <guilabel>third level chooser</guilabel>.</para>
                </listitem>
        </varlistentry>
        <varlistentry>
                <term><guilabel>Alt/Win key behavior</guilabel></term>
                <listitem><para>
                  This group of options allows you to assign the behaviour of Unix modifier keys Super, Meta, and Hyper to the <keycap>Alt</keycap> and <keycap>Windows</keycap> keys on your keyboard.
                </para></listitem>
        </varlistentry>
        <varlistentry>
                <term><guilabel>CapsLock key behavior</guilabel></term>
                <listitem><para>
                  This group has several options for the <keycap>Caps Lock</keycap> key.
                </para></listitem>
        </varlistentry>
        <varlistentry>
                <term><guilabel>Compose key position</guilabel></term>
                <listitem>
                  <para>The Compose key allows you to combine two keypresses to make a single character. This is used to create an accented character that might not be on your keyboard layout. For example, press the Compose key, then <keycap>'</keycap>, then <keycap>e</keycap> to obtain e-acute character. <!-- Translators: feel free to use an example suitable to your locale --></para>
                </listitem>
        </varlistentry>
        <varlistentry>
                <term><guilabel>Control key position</guilabel></term>
                <listitem><para>
                  Use this group of options to set the location of the <keycap>Ctrl</keycap> key to match the layout on older keyboards.
                </para></listitem>
        </varlistentry>
        <varlistentry>
                <term><guilabel>Group Shift/Lock behavior</guilabel></term>
                <listitem><para>
                  Select keys or key combinations to switch your keyboard layout when pressed.
 
                </para></listitem>
        </varlistentry>
        <varlistentry>
                <term><guilabel>Miscellaneous compatibility options</guilabel></term>
                <listitem>
                  <variablelist>
	                  <varlistentry>
	                    <term><guilabel>Shift with numpad keys works as in MS Windows.</guilabel></term>
                    	<listitem>
                    	  <para>With this option selected, using <keycap>Shift</keycap> with keys on the numerical pad when <keycap>NumLock</keycap> is off extends the current selection.</para>
                    	  <para>With this option unselected, use <keycap>Shift</keycap> with keys on the numerical pad to obtain the reverse of the current behaviour for that key. For example, when <keycap>NumLock</keycap> is off, the <keycap>8</keycap> key acts as an up-arrow. Press <keycombo><keycap>Shift</keycap><keycap>8</keycap></keycombo> to type an '8'.</para></listitem>
                    	</varlistentry>
                    	<varlistentry><term><guilabel>Special keys (Ctrl+Alt+&lt;key&gt;) handled in a server.</guilabel></term>
	<listitem><para>Select this option to have certain keyboard shortcuts passed to the X windowing system instead of being handled by GNOME.</para></listitem>
</varlistentry>
                    </variablelist>
                </listitem>
        </varlistentry>
        <varlistentry>
                <term><guilabel>Third level choosers</guilabel></term>
                <listitem>
                  <para>A <firstterm>third level</firstterm> key allows you to obtain a third character from a key, in the same way that pressing <keycap>Shift</keycap> with a key produces a different character to pressing the key alone.</para>
                  <para>Use this group to select a key you want to act as a third level modifier key.</para>
                  <para>Pressing the third-level key and <keycap>Shift</keycap> produces a fourth character from a key.</para>
                  <para>The third and fourth level characters for your keyboard layout are shown in the <ulink type="help" url="ghelp:gswitchit"><application>Keyboard Indicator</application></ulink> Layout View Window.</para>
                  <!-- better link, pending CVS commit of gswitchit docs: "ghelp:gswitchit?layout-view" -->
                </listitem>
        </varlistentry>
        <varlistentry>
                <term><guilabel>Use keyboard LED to show alternative group.</guilabel></term>
                <listitem>
                  <para>Use this option to specify that one of the light indicators on your keyboard should indicate when an alternative keyboard layout is in use.</para>
                  <note><para>The selected keyboard light will no longer indicate its standard function. For example, the Caps Lock light will not react to the <keycap>Caps Lock key</keycap>.</para></note>
                </listitem>
        </varlistentry>
      </variablelist>
    </sect3>

    <sect3 id="goscustdesk-86">
      <title>Typing Break Preferences</title>
      <para>Configure the Typing Break Preferences to make GNOME remind you to rest after you have been using the keyboard and mouse for a long time. During a Typing Break, the screen will be locked.</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>
      <note><para>
        If you stop using the keyboard and mouse for a length of time equal to the <guilabel>Break interval</guilabel> setting, the current work interval will be reset.
      </para></note>
    </sect3>    
    
    
  </sect2>

  <sect2 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>
    
    
    <sect3 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>
    </sect3>
    <sect3 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>
    </sect3>
    <sect3 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>
    </sect3>
  </sect2>

  <!-- ============= Printing ========================= -->
  <sect2 id="prefs-printers">
  
    <title>Printing Preferences</title>
    <!-- preserve for backwards compatibility: 2.16 -->    
    <anchor id="printer-setup"/>   
          
    <para>To set up a new printer, choose <menuchoice><guimenu>System</guimenu><guisubmenu>Administration</guisubmenu><guimenuitem>Printing</guimenuitem></menuchoice> in the top panel menubar. The <guilabel>Printers</guilabel> window opens.</para>
    
    <para>Choose <menuchoice><guimenu>Printer</guimenu><guimenuitem>Add Printer</guimenuitem></menuchoice>. The <application>Add a Printer</application> assistant opens. This guides you through the process of setting up the printer.</para>
    
    <note><para>You can also use the <guilabel>Printers</guilabel> window to check the status of print jobs, and remove or alter the properties of printers that are already set up.</para></note>
  </sect2>

  <sect2 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 these settings the defaults only for the system that you are logged in to.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </sect2>

  <sect2 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>
    <sect3 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>
    </sect3>
    <sect3 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>
    </sect3>
    <sect3 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>
    </sect3>
  </sect2>

<!--
<sect2 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>
</sect2>
-->


</sect1>


<sect1 id="prefs-system">
	<title>System</title>


  <sect2 id="prefs-multimedia">
    <title>Multimedia Systems Selector</title>
    <para>See the <ulink type="help" url="ghelp:gstreamer-properties">GStreamer Properties Manual</ulink>.</para>
  </sect2>

  <sect2 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>
    <sect3 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>
    </sect3>
    <sect3 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>
    </sect3>
    <sect3 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>
    </sect3>
  </sect2>

</sect1>


</chapter>
