<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 MATE 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 MATE 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>
  <!-- Was Login Photo prefs, could go to About Me if that was enabled by default -->
  <anchor id="goscustdesk-95"/>

  <sect2 id="goscustaccess-11">
    <title>Assistive Technologies Preferences</title>
    <indexterm>
      <primary>accessibility</primary>
      <secondary>setting assistive technology
preferences</secondary>
    </indexterm>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Assistive Technologies</secondary>
    </indexterm>
    <para>Use the <application>Assistive Technologies</application> preference tool to enable assistive technologies
in the MATE Desktop. You can also use the <application>Assistive Technology</application> preference tool to open other preference tools which contain preferences related to assistive technologies.</para>
    <itemizedlist>
      <listitem>
        <para><guibutton>Preferred Applications</guibutton> lets you specify assistive technology applications to start automatically when you log in. See <xref linkend="prefs-preferredapps"/></para>
      </listitem>
      <listitem>
        <para><guibutton>Keyboard Accessibility</guibutton> lets you configure keyboard accessibility features such as sticky keys, slow keys or bounce keys.
        See <xref linkend="prefs-keyboard-a11y"/></para>
      </listitem>
      <listitem>
        <para><guibutton>Mouse Accessibility</guibutton> lets you configure mouse accessibility features such as dwell clicking. See <xref linkend="goscustdesk-53"/></para>
      </listitem>
    </itemizedlist>
    <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 MATE Desktop.</para>
              <para>Note that for technical reasons, you have to log in
again after enabling this option for it to be fully effective.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </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 MATE, 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>
        <varlistentry><term>Accessibility</term>
          <listitem><para>Shortcuts for starting assistive technologies, such as
            a screen reader, a magnifier or an on-screen keyboard.</para></listitem>
        </varlistentry>
        <varlistentry><term>Custom Shortcuts</term>
          <listitem><para>Custom shortcuts that have been added with the <guilabel>Add</guilabel> button. This section will not be shown if there are no custom shortcuts.</para></listitem>
        </varlistentry>
    </variablelist>
    <para>
      To add a custom shortcut, use the <guilabel>Add</guilabel> button in the action area. You have to provide a name and a command for the new shortcut. The new custom shortcut will appear in the list of shortcuts and can be edited in the same way as the predefined shortcuts.
    </para>
    <para>
      To remove a custom shortcut, use the <guilabel>Remove</guilabel> button.
    </para>
  </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 MATE Desktop to use when the MATE Desktop starts an application
for you. For example, you can specify the web browser application (<application>Epiphany
</application>, <application>Mozilla Firefox</application>, <application>Opera</application>
...) to launch when you click on a link in other applications such as 
email clients or document viewers.</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>Internet</guilabel> (Web, Mail)
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Multimedia</guilabel> (Multimedia Player)
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>System</guilabel> (Terminal)
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Accessibility</guilabel> (Visual, Mobility)
        </para>
      </listitem>
    </itemizedlist>
    
    <para>For each preferred application category, a drop-down menu contains a list of possible applications you can choose from. The list depends on the applications installed on your computer.</para>
    <para>In each category, the last item in the menu (<guimenuitem>Custom</guimenuitem>) permits you to customize the command used by the system when the specific launch action occurs.</para>
    
    <sect3 id="goscustlookandfeel-32">
      <title>Custom Command Options</title>
      <indexterm>
        <primary>preferred applications</primary>
        <secondary>custom command</secondary>
      </indexterm>
      <para>The following table summarizes the various options you can choose from when you select
<guimenuitem>Custom</guimenuitem> in the drop-down application menu.</para>
      <table frame="topbot" id="goscustlookandfeel-TBL-37">
        <title>Custom command 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 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 application. For the <application>Web
Browser</application> and the <application>Mail Reader</application> applications, you can include a <literal>%s</literal>
after the command to tell the application to use the URL or Email address you clicked on. The exact command arguments
may depend on the specific application.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Run 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
 application that does not create a window in which to run.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Execute flag (Terminal only)</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Most terminal applications have an option that cause them to treat the remaining command line options as
commands to run (<option>-x</option> for <application>mate-terminal</application>).  Enter this option here.
 For example, this is used when executing a command of a launcher for which the chosen type is Application in Terminal.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Run at start (Accessibility only)</guilabel>
                </para>
              </entry>
              <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
                <para>Select this option to run the command as soon as your session begins.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect3>
  </sect2>

</sect1>

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

  <sect2 id="prefs-appearance">
    <title>Appearance Preferences</title>
    <para>The <application>Appearance</application> preference tool lets
    you configure various aspects of how your desktop looks:</para>
    <itemizedlist>
      <listitem>
        <para>Theme,</para>
      </listitem>
      <listitem>
        <para>Desktop Background,</para>
      </listitem>
      <listitem>
        <para>Fonts,</para>
      </listitem>
      <listitem>
        <para>User Interface.</para>
      </listitem>
     </itemizedlist> 
  <sect3 id="prefs-theme">
    <title>Theme Preferences</title>
    <anchor id="goscustdesk-12"/>
    <anchor id="goscustdesk-54"/>
    <anchor id="goscustdesk-82"/>
  
    <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 MATE Desktop. You can choose themes
to change the appearance of the MATE Desktop. Use the <application>Theme</application> tabbed section 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 MATE 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 MATE-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 <guilabel>Customize Theme</guilabel> window.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Colors</term>
        <listitem>
           <para><indexterm><primary>themes</primary><secondary>color options</secondary><tertiary>introduction</tertiary></indexterm><indexterm><primary>color themes</primary><see>themes, color options</see></indexterm>The color setting for
a theme determines the color of various user interface elements. You can choose several pairs of colors from the <guilabel>Colors</guilabel> tabbed section in the <guilabel>Customize Theme</guilabel> window.</para>
           <note><para>It is important to choose pairs of colors that have a good contrast with each other,
           otherwise text may become hard to read.</para></note>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Window frame</term>
        <listitem>
          <para><indexterm><primary>themes</primary><secondary>window frame options</secondary><tertiary>introduction</tertiary></indexterm><indexterm><primary>Marco 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 <guilabel>Customize Theme</guilabel> window.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Icons</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 <guilabel>Customize Theme</guilabel> window.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Pointer</term>
        <listitem>
          <para><indexterm><primary>themes</primary><secondary>pointer options</secondary><tertiary>introduction</tertiary></indexterm><indexterm><primary>pointer themes</primary><see>themes, pointer options</see></indexterm>The pointer setting for a theme determines the appearance of
and sice of the mouse pointer. You can choose an options for the pointer setting fromthe <guilabel>Pointer</guilabel> tabbed section in the <guilabel>Customize Theme</guilabel> window.</para>
        </listitem>
      </varlistentry>
    </variablelist>
    <sect4 id="goscustdesk-61">
      <title>To Create a Custom Theme</title>
      <para>The themes that are listed in the <guilabel>Theme</guilabel>
tabbed section 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>Appearance</application> preference tool.
          Open the <guilabel>Theme</guilabel> tabbed section.</para>
        </listitem>
        <listitem>
          <para>Select a theme in the list of themes.</para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Customize</guibutton> button. A <guilabel>Customize Theme</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>Customize Theme</guilabel> dialog.</para>
        </listitem>
        <listitem>
          <para>On the <application>Appearance</application> preferences tool,
click on the <guibutton>Save As</guibutton> button. A <guilabel>Save Theme
As</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>
    </sect4>
    <sect4 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>Appearance</application> preference tool.
           Open the <guilabel>Theme</guilabel> tabbed section.</para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Install</guibutton> button.
A file chooser dialog is displayed.</para>
        </listitem>
        <listitem>
          <para>Enter the location of the theme archive file in the location
entry. Alternatively, select the theme archive file in the file list. When you have selected the file, click <guibutton>Open</guibutton>.</para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Install</guibutton> button to install
the new theme. </para>
        </listitem>
      </orderedlist>
    </sect4>

<!--How does this work nowadays ?
    <sect4 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>Appearance</application> preference tool.
          Open the <guilabel>Theme</guilabel> tabbed section.</para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Customize</guibutton> button.
An <guilabel>Customize Theme</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>
    </sect4>
-->
    <sect4 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>Appearance</application> preference tool.
          Open the <guilabel>Theme</guilabel> tabbed section.</para>
        </listitem>
        <listitem>
          <para>Click on the <guibutton>Customize</guibutton> button.
A <guilabel>Customize Theme</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>Select the theme option you want to delete.</para>
        </listitem>
        <listitem>
          <para>Use the <guibutton>Delete</guibutton> button to delete the
          selected option. Note that you can not delete system-wide theme
          options.</para>
        </listitem>
      </orderedlist>
    </sect4>
  </sect3>

  <sect3 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>MATE 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 <guilabel>Background</guilabel> tabbed section in the <application>Appearance</application> preference tool 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="caja-backgrounds-and-emblems"><guilabel>Backgrounds
and Emblems</guilabel> dialog</link> in the <application>Caja</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 Background</guibutton>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
              <para>Choose an image from the list.  Alternately, you can use the
<guibutton>Add</guibutton> button 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</guilabel>
              </para>
            </entry>
            <entry colname="colspec1" colsep="0" rowsep="0">
              <para/>
              <para>Click on the <guibutton>Add</guibutton> 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 image 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>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>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>
  </sect3>

  <sect3 id="prefs-font">
    <title>Font Preferences</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="goscustdesk-38"/>
    <anchor id="goscustdesk-83"/>
    <anchor id="goscustdesk-94"/>
    <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 <guilabel>Fonts</guilabel> tabbed section in the <application>Appearance</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>

    <sect4 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>
  	</sect4>
	
  	<sect4 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>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 MATE
    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>
    </variablelist>
   
    </sect4>
<!-- go to fonts folder no longer exists
    <sect4 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>Appearance</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>
    </sect4>
-->

<!-- go to fonts folder no longer exists
    <sect4 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 Mate.</para></warning>
      
      <tip><para>You can also open the <guilabel>Fonts</guilabel> folder by typing the following URI into <application>Caja</application> file manager's <link linkend="caja-open-location">Open Location dialog</link>: <command>fonts:///</command>.</para></tip>
    </sect4>
-->
  </sect3>

  <sect3 id="prefs-menustoolbars">
    <title>Interface 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 <guilabel>Interface</guilabel> tabbed section in the <application>Appearance</application> preference tool to customize the appearance
of menus, menubars, and toolbars for applications that are part of MATE.</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 shortcut keys</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 MATE applications.</para>
	      </warning>
	      </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 MATE-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>
  </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 MATE 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>Maximize Vertically</guilabel>: Maximizes the window vertically without changing its width.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Maximize Horizontally</guilabel>: Maximizes the window horizontally without changing its height.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Minimize</guilabel>: Minimizes the window.</para>
                </listitem>
                <listitem>
                  <para><guilabel>Roll up</guilabel>: Roll up the window.</para>
                </listitem>
                <listitem>
                  <para><guilabel>None</guilabel>: Do nothing.</para>
                </listitem>
              </itemizedlist>
              <para>If a window is already maximized or rolled up, double-clicking 
              on the titlebar will return it to its normal state.</para>
            </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>
    <note>
      <para>The position of the Control, Alt and Super keys on the keyboard can be modified in the 
      Keyboard Layout Options dialog, see <xref linkend="prefs-keyboard-layoutoptions"/>. 
      </para>
    </note>
  </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 Preferences</application>
    enables you to configure how your system connects to the Internet.</para>
    <para>You can configure the MATE 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 or
    the Internet Protocol (IP) address of the proxy server. A <firstterm>domain 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>
    <remark>Why would one want to use a proxy?  This description makes it sounds like it's
    a user preference, rather than being dictated by the network you're on.  We should make
    this more clear.</remark>
    <para>Since it is possible that you need to use a different proxy configuration in different places,
    <application>Network Proxy Preferences</application> allows you to define separate proxy configurations
    and switch between them using the <guilabel>Location</guilabel> drop-down box at the top of the window.
    Choose <guilabel>New Location</guilabel> to create a proxy configuration for a new location. Locations
    can be removed using the <guilabel>Delete Location</guilabel> button at the bottom of the window.</para>
  
    <variablelist>
      <varlistentry>
        <term><guilabel>Direct internet connection</guilabel></term>
        <listitem><para>Select this option 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 to connect to the Internet through a proxy server and
        configure the proxy settings manually.</para>

        <variablelist>
          <varlistentry>
            <term><guilabel>HTTP proxy</guilabel></term>
            <listitem>
              <para>Enter the domain name or IP address of the proxy server to use when you request
              an HTTP service. Enter the port number of the HTTP service on the proxy server in the
              <guilabel>Port</guilabel> field.</para>
              <para>If the HTTP proxy server requires authentication, click the <guibutton>Details</guibutton>
              button to enter your username and password.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term><guilabel>Secure HTTP proxy</guilabel></term>
            <listitem><para>Enter the domain name or 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> field.</para></listitem>
          </varlistentry>
          <varlistentry>
            <term><guilabel>FTP proxy</guilabel></term>
            <listitem><para>Enter the domain name or IP address of the proxy server to use when you
            request an FTP service. Enter the port number of the FTP service on the proxy server in
            the <guilabel>Port</guilabel> field.</para></listitem>
          </varlistentry>
          <varlistentry>
            <term><guilabel>Socks host</guilabel></term>
            <listitem><para>Enter the domain name or 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> field.</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>
      <para>Automatic proxy configuration works by means of a so-called PAC file, which your browser downloads from a web server. If you don't specify the URL for a PAC file in the <guilabel>Autoconfiguration URL</guilabel> entry, your browser 
      will try to locate one automatically.</para>
      <variablelist>
      <varlistentry><term><guilabel>Autoconfiguration
      URL</guilabel></term><listitem><para>Enter the URL of a PAC file that contains the information required to configure the proxy
    server automatically.</para></listitem></varlistentry>
      </variablelist></listitem></varlistentry>
    </variablelist>
    
    <para>Set which hosts should not use the proxy in the <guilabel>Ignore Host List</guilabel> in the <guilabel>Ignored Hosts</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 MATE 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>General</guilabel> tabbed section to set general
keyboard preferences.</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 MATE 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 the currently selected keyboard model) to choose another keyboard make and model.</para></listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guilabel>Separate layout 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 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>
	      <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 <application>Keyboard Indicator</application> panel applet. <!-- better link to the specific page, but not yet suitable for a direct link: help:gswitchit?gswitchit-applet-switching --></para>
                 <para>To add a layout to the list of selected layouts, click the <guibutton>Add</guibutton> button. It opens a layout chooser dialog, which lets you select a layout by country or by language.</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>

      <para>Click the <guibutton>Layout Options</guibutton> button to open the <guilabel>Keyboard Layout Options</guilabel> dialog.</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>Keyboard Layout Options</guilabel> dialog 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 dialog 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 MATE.</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 <application>Keyboard Indicator</application> Layout View Window.</para>
                  <!-- better link, pending CVS commit of gswitchit docs: "help: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="prefs-keyboard-a11y">

      <title>Keyboard Accessibility Preferences</title>

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


    <!-- Maintained for 2.8 compatibility -->
      <anchor id="goscustaccess-6"/>
      <anchor id="goscustaccess-8"/>
      <anchor id="goscustaccess-9"/>
      <para>The <guilabel>Accessibility</guilabel> tabbed section allows you to set  options such as filtering out accidental keypresses and using shortcut keys without having to hold down several keys at once. These features are also known as AccessX.</para>

       <para>This section describes each of the preferences you can set. For a more task-oriented description of keyboard accessibility, see the <citetitle>MATE Desktop Accessibility Guide</citetitle>.</para>

      <para><xref linkend="goscustdesk-TBL-85"/> lists the accessibility preferences
 that you can modify.</para>
     <table frame="topbot" id="goscustdesk-TBL-85">
        <title>Accessibility 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>Accessibility features can be toggled with keyboard shortcuts</guilabel>
                  </para>
                </entry>
                <entry valign="top">
                   <para>
                     Select this option to show an icon in the notification 
                     area that offers quick access to accessibility features.
                   </para>
                </entry>
             </row>
             <row>
                <entry valign="top">
                  <para>
                    <guilabel>Simulate simultaneous keypresses</guilabel>
                  </para>
                  <indexterm>
                    <primary>accessibility</primary>
                    <secondary>sticky keys</secondary>
                  </indexterm>
                </entry>
                <entry 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>
                </entry>
             </row>
             <row>
                <entry valign="top">
                    <para>
                      <guilabel>Disable sticky keys if two keys are pressed together</guilabel>
                    </para>
                </entry>
                <entry valign="top">
                    <para>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>
                </entry>
             </row>
             <row>
                <entry valign="top">
                  <para>
                    <guilabel>Only accept long keypresses</guilabel>
                  </para>
                  <indexterm>
                    <primary>accessibility</primary>
                    <secondary>slow keys</secondary>
                  </indexterm>
                </entry>
                <entry 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>
                </entry>
             </row>
             <row>
                <entry valign="top">
                  <para>
                    <guilabel>Delay</guilabel>
                  </para>
                </entry>
                <entry valign="top">
                  <para>Use the slider
to specify the period of time that you must press-and-hold
a key before acceptance.</para>
                </entry>
             </row>
             <row>
                <entry valign="top">
                  <para>
                    <guilabel>Ignore fast duplicate keypresses</guilabel>
                  </para>
                  <indexterm>
                    <primary>accessibility</primary>
                    <secondary>bounce keys</secondary>
                  </indexterm>
                </entry>
                <entry valign="top">
                <para>Select this option to accept a key input and to control the key repeat characteristics
of the keyboard.</para>
                </entry>
             </row>
             <row>
                <entry valign="top">
                  <para>
                    <guilabel>Delay</guilabel>
                  </para>
                </entry>
                <entry valign="top">
                   <para>Use the slider to specify the interval to wait after the first
keypress before the automatic repeat of a pressed key.</para>
                </entry>
             </row>
            <row>
              <entry  valign="top">
                <para>
                  <guilabel>Type to test settings</guilabel>
                </para>
              </entry>
              <entry 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>To configure audio feedback for keyboard accessibility features,
      click the <guibutton>Audio Feedback</guibutton> button. It opens the
      <guilabel>Keyboard Accessibility Audio Feedback</guilabel> window.</para>
    </sect3>

   <sect3>
      <title>Keyboard Accessibility Audio Feedback</title>
      <para>Configure audio feedback for keyboard accessibility features.</para>
      <para><xref linkend="goscustdesk-TBL-86"/> lists the audio feedback preferences
      that you can modify.</para>
      <table frame="topbot" id="goscustdesk-TBL-86">
        <title>Audio Feedback 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>Beep when accessibility features are turned on or off</guilabel>
                </para>
              </entry>
              <entry 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 valign="top">
                 <para>
                   <guilabel>Beep when a toggle key is pressed</guilabel>
                 </para>
                 <indexterm>
                    <primary>accessibility</primary>
                    <secondary>toggle keys</secondary>
                  </indexterm>
              </entry>
	      <entry 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 valign="top">
                 <para>
                   <guilabel>Beep when a modifier key is pressed</guilabel>
                 </para>
              </entry>
              <entry valign="top">
                 <para>Select this option for an audible indication when you 
                 press a modifier key.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                 <para>
                   <guilabel>Beep when a key is pressed</guilabel>
                 </para>
              </entry>
              <entry valign="top">
                 <para>Select this option for an audible indication when  
                 a key is pressed.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                 <para>
                   <guilabel>Beep when a key is accepted</guilabel>
                 </para>
              </entry>
              <entry valign="top">
                 <para>Select this option for an audible indication when  
                 a key is accepted.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                 <para>
                   <guilabel>Beep when a key is rejected</guilabel>
                 </para>
              </entry>
              <entry valign="top">
                 <para>Select this option for an audible indication when  
                 a key is rejected.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
   </sect3>
 
   <sect3>
     <title>Mouse Keys Preferences</title>
     <anchor id="goscustaccess-10"/>
     <para>The options in the <guilabel>Mouse Keys</guilabel> tabbed section
     let you configure the keyboard as a substitute for the mouse.</para>
      <para><xref linkend="goscustdesk-TBL-88"/> lists the mouse keys preferences
 that you can modify.</para>
      <table frame="topbot" id="goscustdesk-TBL-88">
        <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>Pointer can be controlled using the keypad</guilabel>
                </para>
                <indexterm>
                  <primary>accessibility</primary>
                  <secondary>mouse keys</secondary>
                </indexterm>
              </entry>
              <entry 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>MATE Desktop Accessibility Guide</citetitle> under the heading <citetitle>To Enable the Keyboard to Emulate the Mouse</citetitle>.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>
                   <guilabel>Acceleration</guilabel> 
                </para>
              </entry>
              <entry valign="top">
                <para>Use the slider to specify how long it takes the pointer to accelerate to maximum speed.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>
                   <guilabel>Speed</guilabel>
                </para>
              </entry>
              <entry valign="top">
                <para>Use the slider
to specify the maximum speed that the pointer moves across
the screen.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>
                  <guilabel>Delay</guilabel>
                </para>
              </entry>
              <entry valign="top">
                <para>Use the slider to specify the period of time that must pass
after a keypress before the pointer moves.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
  </sect3>

    <sect3 id="goscustdesk-86">
      <title>Typing Break Preferences</title>
      <para>Configure the Typing Break Preferences to make MATE 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>
      <listitem>
        <para>configure mouse accessibility features.</para>
      </listitem>
    </itemizedlist>
    
    
    <sect3 id="goscustdesk-55">
      <title>General Mouse Preferences</title>
      <para>Use the <guilabel>General</guilabel> tabbed section to specify whether
      the mouse buttons are configured for left-hand or right-hand use and configure
      the speed and sensitivity of your mouse.</para>
      <para><xref linkend="goscustperiph-TBL-6"/> lists the general mouse 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>Right-handed</guilabel>
                </para>
              </entry>
              <entry colsep="0" rowsep="0" valign="top">
                <para>Select this option to configure your mouse for right-hand use. When you configure your mouse for right-hand use, the left mouse button is the primary button and the right mouse button is the secondary button.</para>
              </entry>
            </row>
            <row>
              <entry colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Left-handed</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>Show position of pointer when the Control key is pressed</guilabel>
                </para>
              </entry>
              <entry colsep="0" rowsep="0" valign="top">
                <para>Select this option to enable a mouse pointer animation
when you press and release the Control key. This feature can assist
you to locate the mouse pointer.</para>
                <note>
                  <para>The position of the Control key on the keyboard can be 
                  modified in the Keyboard Layout Options dialog, see 
                  <xref linkend="prefs-keyboard-layoutoptions"/>.</para>
                </note>
              </entry>
            </row>
            <row>
              <entry colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Acceleration</guilabel>
                </para>
              </entry>
              <entry colsep="0" rowsep="0"  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 colsep="0" rowsep="0"  valign="top">
                <para>
                  <guilabel>Sensitivity</guilabel>
                </para>
              </entry>
              <entry  colsep="0" rowsep="0" valign="top">
                <para>Use the slider to specify how sensitive your mouse
pointer is to movements of your mouse.</para>
              </entry>
            </row>
            <row>
              <entry colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Threshold</guilabel>
                </para>
              </entry>
              <entry colsep="0" rowsep="0" 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>
            <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-53">
      <title>Mouse Accessibility Preferences</title>
      <para>Use the <guilabel>Accessibility</guilabel> tabbed section to configure
      accessibility features that can help people who have difficulty with exact positioning of the pointer or with pressing the mouse buttons:</para>
      <itemizedlist>
         <listitem>
            <para>
              Open a contextual menu by clicking and holding the primary mouse button; this is useful for users that can manipulate only one button.
            </para>
         </listitem>
         <listitem>
            <para>
              Perform different types of mouse button click by software; this useful for users that are not able to manipulate any buttons. The types of click that can be performed are:
               <variablelist>
                 <varlistentry>
                   <term>Single click</term>
                   <listitem>
                     <para>
                       A single click of the primary mouse button
                     </para>
                   </listitem>
                 </varlistentry>
                 <varlistentry>
                   <term>Double click</term>
                   <listitem>
                     <para>
                        A double click of the primary mouse button
                     </para>
                   </listitem>
                 </varlistentry>
                 <varlistentry>
                   <term>Drag click</term>
                   <listitem>
                     <para>
                       A click that begins a drag operation
                     </para>
                   </listitem>
                 </varlistentry>
                 <varlistentry>
                   <term>Secondary click</term>
                   <listitem>
                     <para>
                       A single click of the secondary mouse button
                     </para>
                   </listitem>
                 </varlistentry>
               </variablelist>
            </para>
         </listitem>
      </itemizedlist>
      <para><xref linkend="goscustdesk-TBL-47"/> lists the mouse accessibility 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 rowsep="0" colsep="0" valign="top">
                <para>
                  <guilabel>Trigger secondary click by holding down the primary button</guilabel>
                </para>
              </entry>
              <entry rowsep="0" colsep="0" valign="top">
                <para>Select this option to enable simulated secondary clicks by pressing the primary mouse button for an extended time.</para>
              </entry>
            </row>
            <row>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  <guilabel>Delay</guilabel> slider in the <guilabel>Simulated Secondary Click</guilabel> section
                </para>
              </entry>
              <entry rowsep="0" colsep="0" valign="top">
                <para>Use the slider to specify how long the primary button must be pressed to simulate a secondary click.</para>
              </entry>
            </row>
            <row>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  <guilabel>Initiate click when stopping pointer movement</guilabel>
                </para>
              </entry>
              <entry rowsep="0" colsep="0" valign="top">
                <para>Select this option to enable automatic clicks when the mouse stops. Use the additional preferences in the <guilabel>Dwell Click</guilabel> section to configure how the type of click is chosen.</para>
              </entry>
            </row>
            <row>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  <guilabel>Delay</guilabel> slider in the <guilabel>Dwell Click</guilabel> section
                </para>
              </entry>
              <entry rowsep="0" colsep="0" valign="top">
                <para>Use the slider to specify how long the pointer must remain at rest before an automatic click will be triggered.</para>
              </entry>
            </row>
            <row>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  <guilabel>Motion threshold</guilabel> slider 
                </para>
              </entry>
              <entry rowsep="0" colsep="0" valign="top">
                <para>Use the slider to specify how much the pointer may move to still be considered at rest.</para>
              </entry>
            </row>
            <row>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  <guilabel>Choose type of click beforehand</guilabel>
                </para>
              </entry>
              <entry rowsep="0" colsep="0" valign="top">
                <para>Select this option to pick the type of click to perform 
                from a window or panel applet.</para> 
              </entry>
            </row>
            <row>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  <guilabel>Show click type window</guilabel>
                </para>
              </entry>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  When this option is enabled, the different types of click (single click, double click, drag click or secondary click) can be selected in a window.</para> 
                <note><para>The <guilabel>Dwell Click</guilabel> panel applet can
                be used instead of the window.</para></note>
              </entry>
            </row>
            <row>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  <guilabel>Choose type of click with mouse gestures</guilabel> 
                </para>
              </entry>
              <entry rowsep="0" colsep="0" valign="top">
                <para>Select this option to pick the type of click by moving the mouse in a certain direction. The four combo boxes below this option allow to assign directions to the different types of click. Note that each direction can be used only for one type of click.</para> 
              
              </entry>
            </row>
            <row>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  <guilabel>Single click</guilabel> 
                </para>
              </entry>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  Choose the direction to trigger a single click.
                </para> 
              </entry>
            </row>
            <row>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  <guilabel>Double click</guilabel> 
                </para>
              </entry>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  Choose the direction to trigger a double click.
                </para> 
              </entry>
            </row>
            <row>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  <guilabel>Drag click</guilabel> 
                </para>
              </entry>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  Choose the direction to trigger a drag click.
                </para> 
              </entry>
            </row>
            <row>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  <guilabel>Secondary click</guilabel> 
                </para>
              </entry>
              <entry rowsep="0" colsep="0" valign="top">
                <para>
                  Choose the direction to trigger a secondary click.
                </para> 
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect3>
  </sect2>

  <sect2 id="goscustdesk-70">
    <title>Monitors</title>
    <indexterm>
      <primary>preference tools</primary>
      <secondary>Display</secondary>
    </indexterm>
    <para>Use <application>Monitor Preferences</application>
to configure the monitors that your computer uses.</para>
<note><para>On most laptop keyboards, you can use the key combination
<keycombo><keycap>Fn</keycap><keycap>F7</keycap></keycombo> to cycle between
several typical monitor configurations without starting <application>Monitor Preferences</application>.
</para></note>
<para>Drag the graphical representations of the monitors in
the upper left part of the window to set how your monitors are arranged.
<application>Monitor Preferences</application> displays small labels in the top
left corner of each monitor to help you identify which rectangle corresponds
to which monitor.</para>
<para>Changes you make in <application>Monitor Preferences</application>
don't take effect until you click the <guibutton>Apply</guibutton> button.
Settings will revert to their previous settings unless you confirm the changes.
This is to prevent bad display settings from rendering your computer unusable.</para>

<variablelist>
	<varlistentry>
    <term><guilabel>Same image in all monitors</guilabel></term>
    <listitem><para>When this option is selected, your entire desktop will fit on
    a single monitor, and every monitor will show the same copy of your desktop.
    When it is not selected, your desktop spans multiple monitors, and each monitor
    shows only a part of your entire desktop.</para></listitem>
  </varlistentry>
	<varlistentry>
    <term><guilabel>Detect monitors</guilabel></term>
    <listitem><para>Click this button to find monitors that have been recently
    added or plugged in.</para></listitem>
  </varlistentry>
  <varlistentry>
    <term><guilabel>Show monitors in panel</guilabel></term>
    <listitem><para>When this option is selected, an icon will be placed on your
    panel allowing you to quickly change certain settings without opening
    <application>Monitor Preferences</application>.</para></listitem>
  </varlistentry>
</variablelist>

<para>The following list explains the options you can set for each monitor.
The currently selected monitor is the one whose graphical representation has
a bold black outline.  It is also indicated by the background color of the
section label.</para>

<variablelist>
	<varlistentry>
    <term><guilabel>On</guilabel> / <guilabel>Off</guilabel></term>
    <listitem><para>Individual monitors can be completely disabled by
    selecting <guilabel>Off</guilabel>.</para></listitem>
  </varlistentry>
	<varlistentry>
    <term><guilabel>Resolution</guilabel></term>
    <listitem><para>Select the resolution to use for the currently selected
    monitor from the drop-down list. <emphasis>Resolution</emphasis>
    refers to the pixel dimensions of the screen. A larger
    resolution means that more things fit on the screen, but
    everything will be smaller.
    </para></listitem>
  </varlistentry>
	<varlistentry>
    <term><guilabel>Refresh rate</guilabel></term>
    <listitem><para>Select the refresh rate to use for the currently
                selected monitor from the drop-down list. The <emphasis>refresh
                rate</emphasis> determines how often the computer redraws the
                screen. A too low refresh rate (below 60) makes the monitor
                flicker and can cause discomfort to your eyes. This is less
                of a problem on LCD displays.
              </para></listitem>
  </varlistentry>
	<varlistentry>
    <term><guilabel>Rotation</guilabel></term>
    <listitem><para>Select the rotation for the currently selected monitor.
    This option may not be supported on all graphics cards.</para></listitem>
  </varlistentry>
</variablelist>
</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>volume</primary>
    </indexterm>
    <para>The <application>Sound</application> preference tool enables
you to control devices and volume for sound input and output. 
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>Sound Events</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Input</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Output</guilabel>
        </para>
      </listitem>
    </itemizedlist>
    <para>You can change the overall output volume using the <guilabel>Output volume</guilabel> slider at the top of the window. The <guilabel>Mute</guilabel> checkbox allows to temporarily suppress all output without disturbing the current volume.</para>
    <sect3 id="goscustdesk-48">
      <title>Sound Effects Preferences</title>
      <para>A sound theme is collection of sound effects that are associated to various events, such as opening a dialog, clicking a button or selecting an item in a menu. One of the most prominent event sounds is the <emphasis>System Bell</emphasis> sound that often played to indicate a keyboard input error. Use the <guilabel>Sound Effects</guilabel> tabbed section of the <application>Sound</application> preference tool to choose a sound theme and modify the bell sound.</para>
      <para><xref linkend="goscustmulti-TBL-6"/> lists the sound effects preferences
that you can modify.</para>
      <table frame="topbot" id="goscustmulti-TBL-6">
        <title>Sound Effects 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>Alert Volume</guilabel> slider</para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
                <para>Use the <guilabel>Alert Volume</guilabel> slider to
control the volume for event sounds.</para>
                <para>The <guilabel>Mute</guilabel> checkbox allows to
                temporarily suppress event sounds without modifying the
                current volume.</para>
              </entry>
            </row>
            <row>
              <entry colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Sound Theme </guilabel>
                </para>
              </entry>
              <entry colsep="0" rowsep="0" valign="top">
                <para>Use this combobox to select a different sound theme.</para>
                <para>Choose <guilabel>No sounds</guilabel> to turn off all event sounds.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
                <para><guilabel>Choose an alert sound </guilabel> list</para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
                <para>Choose an alternative sound for the System Bell from 
                this list.</para>
                <para>Selecting a list element plays the sound.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
                <para><guilabel>Enable window and button sounds </guilabel> checkbox</para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
                <para>Uncheck this option if you don't want to hear sounds
                for window-related events (such as a dialog or a menu appearing)
                and button clicks.
                </para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect3>
    <sect3>
      <title>Sound Input Preferences</title>
      <para>Use the <guilabel>Input</guilabel> tabbed section to set your 
      preferences for sound input.</para>
      <para><xref linkend="goscustdesk-TBL-1"/> lists the
sound input preferences that you can modify.</para>
      <table frame="topbot" id="goscustdesk-TBL-1">
        <title>Sound Input 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>Input volume </guilabel> slider
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0">
                <para>Use the input volume slider to control the input level.</para>
                <para>The <guilabel>Mute </guilabel> checkbox allows to temporarily suppress all input without disturbing the current input level.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Input level</guilabel>
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
                <para>The <guilabel>Input level</guilabel> display provides
                visual feedback that helps to select a suitable input volume.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0">
                <para>
                  <guilabel>Choose a device for sound input </guilabel> list
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0">
                <para>Choose the device that you want to receive sound input
                from.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <note><para>Note that the input volume can also be controlled with
      the microphone icon that is shown in the notification area of the panel
      when an application is listening for sound input.</para></note>
    </sect3>
    <sect3>
      <title>Sound Output Preferences</title>
      <para>Use the <guilabel>Output</guilabel> tabbed section to set your 
      preferences for sound output.</para>
      <para><xref linkend="goscustdesk-TBL-2"/> lists the
sound output preferences that you can modify.</para>
      <table frame="topbot" id="goscustdesk-TBL-2">
        <title>Sound Output 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>Output volume </guilabel> slider
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0">
                <para>Use the output volume slider to control the overall output volume.</para>
                <para>The <guilabel>Mute </guilabel> checkbox allows to temporarily suppress all output without disturbing the current volume.</para>
                <para>Note that the <guilabel>Output volume</guilabel> slider 
                is located above the tabbed section at the top of the window.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0">
                <para>
                  <guilabel>Choose a device for sound output </guilabel> list
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0">
                <para>Choose the device that you want to hear sound output
                from.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec18" colsep="0" rowsep="0">
                <para>
                  <guilabel>Balance </guilabel> slider
                </para>
              </entry>
              <entry colname="colspec19" colsep="0" rowsep="0">
                <para>Use the <guilabel>Balance</guilabel> slider to control
                the left/right balance of an output device that has more than
                one channel (e.g. stereo or 5.1).</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <note><para>Note that the output volume can also be controlled with
      the speaker icon that is shown in the notification area of the panel.</para></note>
    </sect3>
    <sect3 id="goscustdesk-41">
      <title>Application Sound Preferences</title>
      <para>Use the <guilabel>Applications</guilabel> tabbed section to 
      control the volume of sound played by individual applications.</para>
      <para>Each application that is currently playing sound is identified
      by its name and icon.</para>
    </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 GStreamer Properties Manual.</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 MATE Desktop,
and to restore the state when you start another session. You can also use
this preference tool to manage multiple MATE 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>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 colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Automatically remember running applications when logging out</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 state of your session 
when logging out. The session manager saves the session-managed applications 
that are open, and the settings associated with the session-managed applications 
when you log out. The next time that you start a session, the applications start 
automatically, with the saved settings.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
                <para>
                  <guilabel>Remember currently running applications</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>
              </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>New Startup Program</guilabel> dialog is displayed. Enter the name of the appplication in the <guilabel>Name</guilabel> field. Then enter the command to start the application in the <guilabel>Command</guilabel> field. you can also specify a comment in the <guilabel>Comment</guilabel> field</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>Remove</guilabel> button.</para>
                  </listitem>
                </itemizedlist>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect3>
  </sect2>

</sect1>


</chapter>
