Updated User Guide for GNOME 2.2.1.

1 files changed, 342 insertions, 288 deletions

diff --git a/gnome2-user-guide/C/goscustdesk.xml b/gnome2-user-guide/C/goscustdesk.xml
index 540981d..bc6f0f2 100644
--- a/gnome2-user-guide/C/goscustdesk.xml
+++ b/gnome2-user-guide/C/goscustdesk.xml
@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="utf-8"?>
 <chapter id="goscustdesk-6">
   <title>Using the Basic Preference Tools</title>
   <highlights>
@@ -27,8 +26,8 @@ that you require from the submenu. The dialog for the tool is displayed.</para>
         <para>Open a <application>Nautilus</application> window, then choose <menuchoice><guimenu>Go</guimenu><guimenuitem>Start Here</guimenuitem></menuchoice>.
 Alternatively, double-click on the <guilabel>Start Here</guilabel> object
 on the desktop background. The <guilabel>Start Here</guilabel> location is
-displayed. Double-click on the <guilabel>Preferences</guilabel> object in
-the <application>Nautilus</application> window to display your preference
+displayed. Double-click on the <guilabel>Desktop Preferences</guilabel> object
+in the <application>Nautilus</application> window to display your preference
 tools.</para>
         <para>Double-click on the tool that you require. The dialog for the tool is
 displayed.</para>
@@ -147,19 +146,19 @@ the image.</para>
             </entry>
             <entry colname="colspec1" colsep="0" rowsep="0" valign="top">
               <para>To specify a color scheme, use  the options
-in the <guilabel>Background Style</guilabel> drop-down list box, and the color
+in the <guilabel>Background Style</guilabel> drop-down list, and the color
 selector buttons.</para>
               <para>You can specify a color scheme in one of the
 following ways:</para>
               <itemizedlist>
                 <listitem>
-                  <para>Choose <guilabel>Solid color</guilabel> from the <guilabel>Background Style</guilabel> drop-down list box to specify a single color for
-the desktop background. </para>
+                  <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 box. This option creates a gradient
+                  <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>
@@ -167,7 +166,7 @@ the left edge.</para>
 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 box. This creates a gradient effect
+                  <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>
@@ -196,8 +195,8 @@ color that you want to appear at the bottom edge.</para>
       <secondary>applications</secondary>
     </indexterm>
     <para>Use the <application>Font</application> preference
-tool to select the fonts to use on in your applications and on the desktop
-background.</para>
+tool to select the fonts to use in your applications, windows, terminals,
+and desktop background.</para>
     <para><xref linkend="goscustdesk-TBL-26"/> lists the font settings
 that you can configure.</para>
     <table frame="topbot" id="goscustdesk-TBL-26">
@@ -239,26 +238,92 @@ a font to use on your desktop background only.</para>
             </entry>
           </row>
           <row>
-            <entry colname="colspec18" colsep="0" rowsep="0">
+            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
               <para>
-                <guilabel>Window
-title font</guilabel>
+                <guilabel>Window title font</guilabel>
               </para>
             </entry>
-            <entry colname="colspec19" colsep="0" rowsep="0">
-              <para>Click on the font selector button to select a font to use
-in the titlebars of your windows.</para>
+            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
+              <para>Click on the font selector button to select
+a font to use in the titlebars of your windows.</para>
             </entry>
           </row>
           <row>
-            <entry colname="colspec18" colsep="0" rowsep="0">
+            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
               <para>
-                <guilabel>Terminal
-font</guilabel>
+                <guilabel>Terminal font</guilabel>
+              </para>
+            </entry>
+            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
+              <para>Click on the font selector button to select
+a font to use in the <application>Terminal</application> application</para>
+            </entry>
+          </row>
+          <row>
+            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
+              <para>
+                <guilabel>Font Rendering</guilabel>
               </para>
             </entry>
-            <entry colname="colspec19" colsep="0" rowsep="0">
-              <para>Click on the font selector button to select a font to use in the <application>Terminal</application> application</para>
+            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
+              <para>To specify how to render fonts on your screen,
+select one of the following options:</para>
+              <itemizedlist>
+                <listitem>
+                  <para><guilabel>Monochrome</guilabel>: Renders fonts in black and
+white only. The edges of characters might appear jagged in some cases because
+the characters  are not antialiased. <firstterm>Antialiasing</firstterm> is
+an effect that is applied to the edges of characters to make the characters
+look smoother.</para>
+                </listitem>
+                <listitem>
+                  <para><guilabel>Best shapes</guilabel>: Antialiases fonts where
+possible. Use this option for standard Cathode Ray Tube (CRT) monitors.</para>
+                </listitem>
+                <listitem>
+                  <para><guilabel>Best contrast</guilabel>: Adjusts fonts to give
+the sharpest possible contrast, and also antialiases fonts, so that characters
+have smooth edges. This option might enhance the accessibility of the 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 smoothy. Use this option for LCD or flat-screen displays.</para>
+                </listitem>
+              </itemizedlist>
+            </entry>
+          </row>
+          <row>
+            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
+              <para>
+                <guibutton>Details</guibutton>
+              </para>
+            </entry>
+            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
+              <para>Click on this button to specify further details of how
+to render fonts on your screen. </para>
+              <itemizedlist>
+                <listitem>
+                  <para><guilabel>Resolution (dots per inch)</guilabel>: Use the spin
+box to specify the resolution to use when your screen renders fonts.</para>
+                </listitem>
+                <listitem>
+                  <para><guilabel>Smoothing</guilabel>: Select one of the options
+to specify how to antialias fonts.</para>
+                </listitem>
+                <listitem>
+                  <para><guilabel>Hinting</guilabel>:  <firstterm>Hinting</firstterm>
+is a font-rendering technique that improves the quality of fonts at small
+sizes and an at low screen resolutions. Select one of the options to specify
+how to apply hinting your fonts.</para>
+                </listitem>
+                <listitem>
+                  <para><guilabel>Subpixel order</guilabel>: Select one of the options
+to specify the subpixel color order for your fonts. Use this option for LCD
+or flat-screen displays.</para>
+                </listitem>
+              </itemizedlist>
             </entry>
           </row>
         </tbody>
@@ -296,7 +361,7 @@ preference tool in the following functional areas:</para>
     <sect2 id="goscustdesk-40">
       <title>Keyboard Settings</title>
       <para>Use the <guilabel>Keyboard</guilabel> tabbed section to set general
-keyboard preferences. To start the <application>Keyboard</application> <emphasis>accessibility</emphasis> preference tool, that is, <application>AccessX</application>,
+keyboard preferences. To start the <application>Keyboard</application><emphasis>accessibility</emphasis> preference tool, that is, <application>AccessX</application>,
 click on the <guibutton>Accessibility</guibutton> button.</para>
       <para><xref linkend="goscustperiph-TBL-3"/> lists the keyboard
 settings that you can configure.</para>
@@ -456,10 +521,9 @@ keyboard sound settings that you can configure.</para>
 an alternative to standard ways of performing an action. </para>
     <para>Use the <application>Keyboard Shortcuts</application> preference tool
 to display the default keyboard shortcuts. You can customize the default keyboard
-shortcuts to your requirements. You can also create <firstterm>hot keys</firstterm>.
-Hot keys are keyboard shortcuts that start applications. </para>
-    <para><xref linkend="goscustdesk-TBL-5"/> lists the keyboard shortcut
-settings that you can customize.</para>
+shortcuts to your requirements. </para>
+    <para><xref linkend="goscustdesk-TBL-5"/>
+lists the keyboard shortcut settings that you can customize.</para>
     <table frame="topbot" id="goscustdesk-TBL-5">
       <title>Default Settings for Keyboard Shortcuts</title>
       <tgroup cols="2" colsep="0" rowsep="0">
@@ -506,38 +570,11 @@ shortcut keys.</para>
               <para>This
 table lists actions and the shortcut keys that are associated with each action. </para>
               <para>To change the shortcut keys for an action, click on the action
-to select the action. Press the keys that you want to associate with the action.</para>
-              <para>To disable the shortcut keys for an action, double-click on the
-action, then press <keycap>Back Space</keycap>.</para>
-            </entry>
-          </row>
-          <row>
-            <entry colname="colspec0" valign="top">
-              <para>
-                <guilabel>Custom Shortcuts</guilabel>
-              </para>
-            </entry>
-            <entry colname="colspec1">
-              <para>To add a hot key,
-perform the following steps:</para>
-              <orderedlist>
-                <listitem>
-                  <para>Click <guibutton>New</guibutton>. A <guilabel>Custom Binding</guilabel> dialog is displayed. Enter the command to associate with the hot
-key in the <guilabel>New Command</guilabel> field. Alternatively, to browse
-for the command, click on the <guibutton>Browse</guibutton> button. When you
-have selected the command, click <guibutton>OK</guibutton>. The command is
-added to the <guilabel>Custom bindings</guilabel> section of the <guilabel>Desktop shortcuts</guilabel> table.</para>
-                </listitem>
-                <listitem>
-                  <para>Click in the Shortcut column of  the command in the <guilabel>Custom bindings</guilabel> section of the <guilabel>Desktop shortcuts</guilabel>
-table. Press the key or key combination that you want to associate with the
-command. </para>
-                </listitem>
-              </orderedlist>
-              <para>To edit a hot key, select the hot key in the <guilabel>Custom bindings</guilabel> section of the <guilabel>Desktop shortcuts</guilabel>
-table, then click <guibutton>Edit</guibutton>. Edit the command in the <guilabel>Custom Binding</guilabel> dialog.</para>
-              <para>To delete a hot key, select
-the hot key in the <guilabel>Custom bindings</guilabel> section of the <guilabel>Desktop shortcuts</guilabel> table, then click <guibutton>Remove</guibutton>. </para>
+to select the action, then click on the shortcut for the action. Press the
+keys that you want to associate with the action.</para>
+              <para>To disable the
+shortcut keys for an action, double-click on the action, then click on the
+shortcut for the action. Press <keycap>Back Space</keycap>.</para>
             </entry>
           </row>
         </tbody>
@@ -545,7 +582,7 @@ the hot key in the <guilabel>Custom bindings</guilabel> section of the <guilabel
     </table>
   </sect1>
   <sect1 id="goscustuserinter-2">
-    <title>Customizing Menus and Toolbars</title>
+    <title>Customizing Menus and Toolbars in Applications</title>
     <indexterm>
       <primary>toolbars, customizing appearance</primary>
     </indexterm>
@@ -875,14 +912,15 @@ settings that you can configure.</para>
         </thead>
         <tbody>
           <row>
-            <entry colname="colspec2">
+            <entry colname="colspec2" valign="top">
               <para>
-                <guilabel>Direct internet connection</guilabel>
+                <guilabel>Direct internet
+connection</guilabel>
               </para>
             </entry>
-            <entry colname="colspec3">
-              <para>Select this option
-if you want to connect directly to the Internet, without a proxy server.</para>
+            <entry colname="colspec3" valign="top">
+              <para>Select this option if you want to connect directly to the Internet, without
+a proxy server.</para>
             </entry>
           </row>
           <row>
@@ -891,83 +929,84 @@ if you want to connect directly to the Internet, without a proxy server.</para>
                 <guilabel>Manual proxy configuration</guilabel>
               </para>
             </entry>
-            <entry colname="colspec3">
-              <para>Select this option
-if you want to connect to the Internet through a proxy server, and you want
-to configure the proxy server manually.</para>
+            <entry colname="colspec3" valign="top">
+              <para>Select
+this option if you want to connect to the Internet through a proxy server,
+and you want to configure the proxy server manually.</para>
             </entry>
           </row>
           <row>
-            <entry colname="colspec2">
+            <entry colname="colspec2" valign="top">
               <para>
                 <guilabel>HTTP proxy</guilabel>
               </para>
             </entry>
-            <entry colname="colspec3">
-              <para>Enter the DNS name, or the IP address of the
-proxy server to use when you request a HTTP service. Enter the port number
-of the HTTP service on the proxy server in the <guilabel>Port</guilabel> spin
-box.</para>
+            <entry colname="colspec3" valign="top">
+              <para>Enter the DNS name, or the IP
+address of the proxy server to use when you request a HTTP service. Enter
+the port number of the HTTP service on the proxy server in the <guilabel>Port</guilabel> spin box.</para>
             </entry>
           </row>
           <row>
-            <entry colname="colspec2">
+            <entry colname="colspec2" valign="top">
               <para>
                 <guilabel>Secure HTTP proxy</guilabel>
               </para>
             </entry>
-            <entry colname="colspec3">
-              <para>Enter the DNS name, or the IP address of the
-proxy server to use when you request a Secure HTTP service. Enter the port
-number of the Secure HTTP service on the proxy server in the <guilabel>Port</guilabel> spin box.</para>
+            <entry colname="colspec3" valign="top">
+              <para>Enter
+the DNS name, or the IP address of the proxy server to use when you request
+a Secure HTTP service. Enter the port number of the Secure HTTP service on
+the proxy server in the <guilabel>Port</guilabel> spin box.</para>
             </entry>
           </row>
           <row>
-            <entry colname="colspec2">
+            <entry colname="colspec2" valign="top">
               <para>
                 <guilabel>FTP proxy</guilabel>
               </para>
             </entry>
-            <entry colname="colspec3">
-              <para>Enter the DNS name, or the IP address of the
-proxy server to use when you request a FTP service. Enter the port number
-of the FTP service on the proxy server in the <guilabel>Port</guilabel> spin
-box.</para>
+            <entry colname="colspec3" valign="top">
+              <para>Enter the DNS name, or the IP
+address of the proxy server to use when you request a FTP service. Enter the
+port number of the FTP service on the proxy server in the <guilabel>Port</guilabel>
+spin box.</para>
             </entry>
           </row>
           <row>
-            <entry colname="colspec2">
+            <entry colname="colspec2" valign="top">
               <para>
                 <guilabel>Socks host</guilabel>
               </para>
             </entry>
-            <entry colname="colspec3">
-              <para>Enter the DNS name, or the IP address of the
-Socks host to use. Enter the port number for the Socks protocol on the proxy
-server in the <guilabel>Port</guilabel> spin box.</para>
+            <entry colname="colspec3" valign="top">
+              <para>Enter the DNS name, or the IP
+address of the Socks host to use. Enter the port number for the Socks protocol
+on the proxy server in the <guilabel>Port</guilabel> spin box.</para>
             </entry>
           </row>
           <row>
-            <entry colname="colspec2">
+            <entry colname="colspec2" valign="top">
               <para>
-                <guilabel>Automatic proxy configuration</guilabel>
+                <guilabel>Automatic proxy
+configuration</guilabel>
               </para>
             </entry>
-            <entry colname="colspec3">
-              <para>Select this option
-if you want to connect to the Internet through a proxy server, and you want
-to configure the proxy server automatically.</para>
+            <entry colname="colspec3" valign="top">
+              <para>Select this option if you want to connect to the Internet through a proxy
+server, and you want to configure the proxy server automatically.</para>
             </entry>
           </row>
           <row>
-            <entry colname="colspec2">
+            <entry colname="colspec2" valign="top">
               <para>
-                <guilabel>Autoconfiguration URL</guilabel>
+                <guilabel>Autoconfiguration
+URL</guilabel>
               </para>
             </entry>
-            <entry colname="colspec3">
-              <para>Enter the URL that contains the information
-required to configure the proxy server automatically. </para>
+            <entry colname="colspec3" valign="top">
+              <para>Enter the URL that contains the information required to configure the proxy
+server automatically. </para>
             </entry>
           </row>
         </tbody>
@@ -1137,181 +1176,200 @@ selected event.</para>
     </sect2>
   </sect1>
   <sect1 id="goscustdesk-12">
-    <title>Setting Themes in the Desktop</title>
+    <title>Customizing Themes in the Desktop</title>
     <indexterm>
       <primary>Gtk+ themes</primary>
       <see>themes</see>
     </indexterm>
     <indexterm>
       <primary>themes</primary>
-      <secondary>setting desktop themes</secondary>
+      <secondary>setting controls themes</secondary>
     </indexterm>
     <indexterm>
       <primary>themes</primary>
       <secondary>setting window frame themes</secondary>
     </indexterm>
     <indexterm>
-      <primary>windows</primary>
+      <primary>themes</primary>
       <secondary>setting
-frame themes</secondary>
+icons themes</secondary>
+    </indexterm>
+    <indexterm>
+      <primary>windows</primary>
+      <secondary>setting frame themes</secondary>
     </indexterm>
     <indexterm>
       <primary>preference tools</primary>
       <secondary>Theme</secondary>
     </indexterm>
-    <para>Use the <application>Theme</application>
-preference tool to select a theme for your desktop and for your window frames.
-You can customize the settings for the <application>Theme</application> preference
-tool in the following functional areas:</para>
-    <itemizedlist>
-      <listitem>
-        <para>
-          <guilabel>Widget Theme</guilabel>
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          <guilabel>Window Border Theme</guilabel>
-        </para>
-      </listitem>
-    </itemizedlist>
-    <para>The desktop theme and the window frame theme are not the only themes
-that determine the appearance of your desktop. For example, <application>Nautilus</application> includes themes that you can use to change the look-and-feel
-of the <application>Nautilus</application> windows and the desktop background.</para>
-    <sect2 id="goscustdesk-56">
-      <title>Desktop Theme Settings</title>
-      <para>Use the <guilabel>Widget Theme</guilabel> tabbed section of the <application>Theme</application> preference tool to select a theme for your desktop. Your
-desktop theme specifies the visual appearance of your panels, menus, and applets.
-The desktop theme also specifies the appearance of GNOME-compliant application
-interface items. For example, the theme affects the appearance of buttons,
-scrollbars, check boxes, and so on.</para>
-      <para>You can choose from the list of available themes, or you can install
-new themes. The list of available desktop themes includes several themes for
-users with accessibility requirements.</para>
-      <para><xref linkend="goscustlookandfeel-TBL-23"/> lists the desktop
-theme settings that you can configure.</para>
-      <table frame="topbot" id="goscustlookandfeel-TBL-23">
-        <title>Settings for Desktop Themes</title>
-        <tgroup cols="2" colsep="0" rowsep="0">
-          <colspec colwidth="40.81*"/>
-          <colspec colwidth="59.19*"/>
-          <thead>
-            <row rowsep="1">
-              <entry valign="top">
-                <para>Option</para>
-              </entry>
-              <entry valign="top">
-                <para>Function</para>
-              </entry>
-            </row>
-          </thead>
-          <tbody>
-            <row>
-              <entry valign="top">
-                <para>Available themes</para>
-              </entry>
-              <entry valign="top">
-                <para>Select the theme that you require from the list box.</para>
-              </entry>
-            </row>
-            <row>
-              <entry valign="top">
-                <para>
-                  <guibutton>Install new theme</guibutton>
-                </para>
-              </entry>
-              <entry valign="top">
-                <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
-add a theme to the list of available themes, click on the <guibutton>Install
-new theme</guibutton> button. A dialog is displayed. Enter the location of
-the theme archive file in the drop-down combination box. Alternatively, to
-browse for the file, click on the <guibutton>Browse</guibutton> button. When
-you have selected the file, click <guibutton>OK</guibutton>.</para>
-                <para>You can find many GTK themes on the Internet.</para>
-              </entry>
-            </row>
-            <row>
-              <entry valign="top">
-                <para>
-                  <guibutton>Go to theme folder</guibutton>
-                </para>
-              </entry>
-              <entry valign="top">
-                <para>Click on this button to open a file manager window
-on the default theme folder. You can delete themes from the file manager window.</para>
-              </entry>
-            </row>
-          </tbody>
-        </tgroup>
-      </table>
+    <para>A
+theme is a group of coordinated settings that specify how your desktop appears.
+Use the <application>Theme</application> preference tool to select a theme
+for your desktop. You can choose from a list of available themes. The list
+of available themes includes several themes for users with accessibility requirements. </para>
+    <para>When you select a theme in the <application>Theme</application>
+preference tool, you actually select a group of more specific themes that
+collectively determine the appearance of your desktop. Each theme is actually
+a group of other, more specific themes that control the look-and-feel of particular
+parts of the desktop. The following types of theme can control specific parts
+of the desktop:</para>
+    <variablelist>
+      <varlistentry>
+        <term>Controls theme</term>
+        <listitem>
+          <para>Specifies the visual
+appearance of your panels, menus, and applets. Controls themes also specify
+the appearance of GNOME-compliant application interface items. For example,
+controls themes affect the appearance of buttons, scrollbars, check boxes,
+and so on.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Window frame theme</term>
+        <listitem>
+          <para>Specifies the
+visual appearance of your window frames. </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Icons theme</term>
+        <listitem>
+          <para>Specifies the visual
+appearance of the icons on your panels, menus, and desktop background. </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <sect2 id="goscustdesk-61">
+      <title>To Create a Custom Theme</title>
+      <para>The themes that are listed in the <application>Theme</application> preferences
+tool are different combinations of controls themes, window frame themes, and
+icon themes. You can create a custom theme that uses different combinations
+of controls themes, window frame themes, and icon themes.</para>
+      <para>To create a custom theme, perform the following steps:</para>
+      <orderedlist>
+        <listitem>
+          <para>To open the <application>Theme</application> preference tool,
+choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop
+Preferences</guisubmenu><guimenuitem>Theme</guimenuitem></menuchoice>.</para>
+        </listitem>
+        <listitem>
+          <para>Select a theme in the list of themes.</para>
+        </listitem>
+        <listitem>
+          <para>Click on the <guibutton>Details</guibutton> button. A <guilabel>Theme Details</guilabel> dialog is displayed.</para>
+        </listitem>
+        <listitem>
+          <para>Select the controls theme that you want to use in the custom
+theme from the list in the <guilabel>Controls</guilabel> tabbed section. The
+list of available controls themes includes several themes 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
+theme that you want to use in the custom theme from the list of available
+themes. The list of available window frame themes includes several themes
+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 theme that you want to use
+in the custom theme from the list of available themes. The list of available
+icons themes includes several themes for users with accessibility requirements.</para>
+        </listitem>
+        <listitem>
+          <para>Click <guibutton>Close</guibutton> to close the <guilabel>Theme Details</guilabel> dialog.</para>
+        </listitem>
+        <listitem>
+          <para>On the <application>Theme</application> preferences tool,
+click on the <guibutton>Save theme</guibutton> button. A <guilabel>Save theme
+to disk</guilabel> dialog is displayed.</para>
+        </listitem>
+        <listitem>
+          <para>Type a name and a short description for the custom theme in
+the dialog, then click <guibutton>Save</guibutton>. The custom theme now appears
+in your list of available themes.</para>
+        </listitem>
+      </orderedlist>
     </sect2>
-    <sect2 id="goscustdesk-57">
-      <title>Window Frame Theme Settings</title>
-      <para>Use the <guilabel>Window Frame Theme</guilabel> tabbed section of the <application>Theme</application> preference tool to select a theme for your window frames.
-You can choose from the list of available themes, or you can install new themes.
-The list of available window frame themes includes several themes for users
-with accessibility requirements.</para>
-      <para><xref linkend="goscustdesk-TBL-2"/> lists the window frame
-theme settings that you can configure.</para>
-      <table frame="topbot" id="goscustdesk-TBL-2">
-        <title>Settings for Window Frame Themes</title>
-        <tgroup cols="2" colsep="0" rowsep="0">
-          <colspec colwidth="40.81*"/>
-          <colspec colwidth="59.19*"/>
-          <thead>
-            <row rowsep="1">
-              <entry valign="top">
-                <para>Option</para>
-              </entry>
-              <entry valign="top">
-                <para>Function</para>
-              </entry>
-            </row>
-          </thead>
-          <tbody>
-            <row>
-              <entry valign="top">
-                <para>Available themes</para>
-              </entry>
-              <entry valign="top">
-                <para>Select the theme that you require from the list box.</para>
-              </entry>
-            </row>
-            <row>
-              <entry valign="top">
-                <para>
-                  <guibutton>Install new theme</guibutton>
-                </para>
-              </entry>
-              <entry valign="top">
-                <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
-add a theme to the list of available themes, click on the <guibutton>Install
-new theme</guibutton> button. A dialog is displayed. Enter the location of
-the theme archive file in the drop-down combination box. Alternatively, to
-browse for the file, click on the <guibutton>Browse</guibutton> button. When
-you have selected the file, click <guibutton>OK</guibutton>.</para>
-              </entry>
-            </row>
-            <row>
-              <entry valign="top">
-                <para>
-                  <guibutton>Go to theme folder</guibutton>
-                </para>
-              </entry>
-              <entry valign="top">
-                <para>Click on this button to open a file manager window
-on the default theme folder. You can delete themes from the file manager window.</para>
-              </entry>
-            </row>
-          </tbody>
-        </tgroup>
-      </table>
+    <sect2 id="goscustdesk-62">
+      <title>To Install a 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>To open the <application>Theme</application> preference tool,
+choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop
+Preferences</guisubmenu><guimenuitem>Theme</guimenuitem></menuchoice>.</para>
+        </listitem>
+        <listitem>
+          <para>Click on the <guibutton>Install theme</guibutton> button.
+An <guilabel>Install New Theme</guilabel> dialog is displayed.</para>
+        </listitem>
+        <listitem>
+          <para>Enter the location of the theme archive file in the drop-down
+combination box. Alternatively, to browse for the file, click on the <guibutton>Browse</guibutton> button. When you have selected the file, click <guibutton>OK</guibutton>.</para>
+        </listitem>
+        <listitem>
+          <para>Click on the <guibutton>Install</guibutton> button to install
+the new theme. </para>
+        </listitem>
+      </orderedlist>
+      <para>You can also install new controls themes, window frame themes, or icons
+themes. You can find many controls themes on the Internet.</para>
+      <para>To install a new controls theme, window frame theme, or icons theme,
+perform the following steps:</para>
+      <orderedlist>
+        <listitem>
+          <para>To open the <application>Theme</application> preference tool,
+choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop
+Preferences</guisubmenu><guimenuitem>Theme</guimenuitem></menuchoice>.</para>
+        </listitem>
+        <listitem>
+          <para>Click on the <guibutton>Details</guibutton> button. An <guilabel>Theme Details</guilabel> dialog is displayed.</para>
+        </listitem>
+        <listitem>
+          <para>Click on the tab for the type of theme that you want to install.
+For example, to install an icons theme, click on the <guilabel>Icons</guilabel>
+tab.</para>
+        </listitem>
+        <listitem>
+          <para>Click on the <guibutton>Install new theme</guibutton> button.
+An <guilabel>Install New Theme</guilabel> dialog is displayed.</para>
+        </listitem>
+        <listitem>
+          <para>Enter the location of the theme archive file in the drop-down
+combination box. Alternatively, to browse for the file, click on the <guibutton>Browse</guibutton> button. When you have selected the file, click <guibutton>OK</guibutton>.</para>
+        </listitem>
+        <listitem>
+          <para>Click on the <guibutton>Install</guibutton> button to install
+the new theme. </para>
+        </listitem>
+      </orderedlist>
+      <para>You can also delete controls themes, window frame themes, or icons themes.</para>
+      <para>To delete a controls theme, window frame theme, or icons theme, perform
+the following steps:</para>
+      <orderedlist>
+        <listitem>
+          <para>To open the <application>Theme</application> preference tool,
+choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop
+Preferences</guisubmenu><guimenuitem>Theme</guimenuitem></menuchoice>.</para>
+        </listitem>
+        <listitem>
+          <para>Click on the <guibutton>Details</guibutton> button. An <guilabel>Theme Details</guilabel> dialog is displayed.</para>
+        </listitem>
+        <listitem>
+          <para>Click on the tab for the type of theme that you want to delete. </para>
+        </listitem>
+        <listitem>
+          <para>Click on the <guibutton>Go to theme folder</guibutton> button.
+A file manager window opens on the default theme folder.</para>
+        </listitem>
+        <listitem>
+          <para>Use the file manager window to delete the theme.</para>
+        </listitem>
+      </orderedlist>
     </sect2>
   </sect1>
   <sect1 id="goscustdesk-58">
@@ -1355,52 +1413,49 @@ that you can customize.</para>
         </thead>
         <tbody>
           <row>
-            <entry colname="colspec0" colsep="0" rowsep="0">
+            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
               <para>
-                <guilabel>Select
-windows when the mouse moves over them</guilabel>
+                <guilabel>Select windows when the mouse moves over them</guilabel>
               </para>
             </entry>
-            <entry colname="colspec1" colsep="0" rowsep="0">
-              <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 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">
+            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
               <para>
-                <guilabel>Raise
-selected windows after a short time</guilabel>
+                <guilabel>Raise selected windows after an interval</guilabel>
               </para>
             </entry>
-            <entry colname="colspec1" colsep="0" rowsep="0">
-              <para>Select this option to raise windows a short time
-after the window receives focus.</para>
+            <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">
+            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
               <para>
-                <guilabel>Tenths
-of a second before raising the window</guilabel>
+                <guilabel>Interval before raising</guilabel>
               </para>
             </entry>
-            <entry colname="colspec1" colsep="0" rowsep="0">
-              <para>Specify the number of tenths of a second to wait
-before raising a window that has received focus.</para>
+            <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">
+            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
               <para>
-                <guilabel>Double-click
-window titles to</guilabel>
+                <guilabel>Double-click titlebar to perform this action</guilabel>
               </para>
             </entry>
-            <entry colname="colspec1" colsep="0" rowsep="0">
-              <para>Select the behavior that you want to occur when you double-click
-on a window titlebar. Select one of the following options:</para>
+            <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>Roll up</guilabel>: Shades the window.</para>
@@ -1412,15 +1467,14 @@ on a window titlebar. Select one of the following options:</para>
             </entry>
           </row>
           <row>
-            <entry colname="colspec0" colsep="0" rowsep="0">
+            <entry colname="colspec0" colsep="0" rowsep="0" valign="top">
               <para>
-                <guilabel>To move
-windows, click while holding down</guilabel>
+                <guilabel>To move a window, press-and-hold this key then grab the window</guilabel>
               </para>
             </entry>
-            <entry colname="colspec1" colsep="0" rowsep="0">
-              <para>Select the key to press-and-hold when you drag
-a window to move the window.</para>
+            <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>