Version 2.20.0

svn path=/tags/GNOME_USER_DOCS_2_20_0/; revision=821

1 files changed, 1149 insertions, 0 deletions

diff --git a/trunk/gnome2-user-guide/C/gosmetacity.xml b/trunk/gnome2-user-guide/C/gosmetacity.xml
new file mode 100644
index 0000000..e5059a5
--- /dev/null
+++ b/trunk/gnome2-user-guide/C/gosmetacity.xml
@@ -0,0 +1,1149 @@
+<chapter id="gosmetacity-1">
+  <title>Working With Windows</title>
+  <highlights>
+    <para>The information in this chapter describes how to use windows
+in the GNOME Desktop. You can use several types of window manager with the
+GNOME Desktop, for example, <application>Metacity</application> and <application>Sawfish</application>.  Many of the functions in <application>Metacity</application>
+are also available in <application>Sawfish</application>. This chapter describes
+the functions that are associated with the <application>Metacity</application>
+window manager.</para>
+  </highlights>
+  <sect1 id="gosmetacity-712">
+    <title>Windows and Workspaces</title>
+    <indexterm>
+      <primary>windows</primary>
+      <secondary>introduction</secondary>
+    </indexterm>
+    <indexterm>
+      <primary>workspaces</primary>
+      <secondary>introduction</secondary>
+    </indexterm>
+    <para>You can display many windows at the same time in the GNOME
+Desktop. Your windows are displayed in subdivisions of the GNOME Desktop that
+are called workspaces. A workspace is a discrete area in which you can work.
+Every workspace contains the same desktop, the same panels, and the same menus.
+However, you can run different applications, and open different windows in
+each workspace. You can display only one workspace at a time, but you can
+have windows open in other workspaces.  </para>
+    <para>The <application>Workspace Switcher</application> applet displays a
+visual representation of your windows and workspaces, as show in <xref linkend="gosmetacity-FIG-717"/>.</para>
+    <figure id="gosmetacity-FIG-717">
+      <title>Workspace Switcher Applet</title>
+      <screenshot>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/workspace_switcher_applet.png" format="PNG"/>
+          </imageobject>
+          <textobject>
+            <phrase>Workspace Switcher applet. The context describes the graphic.</phrase>
+          </textobject>
+        </mediaobject>
+      </screenshot>
+    </figure>
+    <para>You can add workspaces at any time. To add workspaces to the GNOME Desktop,
+right-click on the <application>Workspace Switcher</application> applet, then
+choose <guimenuitem>Preferences</guimenuitem>. The <guilabel>Workspace Switcher
+Preferences</guilabel> dialog is displayed. Use the <guilabel>Number of workspaces</guilabel> spin box to specify the number of workspaces you require.</para>
+    <sect2 id="gosmetacity-15">
+      <title>Window Manager Behavior</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>window managers</secondary>
+      </indexterm>
+      <para>A window manager controls how windows appear and behave.
+The window manager manages where your windows are located, and which window
+has focus. The window frame contains buttons that enable you to perform standard
+actions such as moving, closing, and resizing windows.</para>
+      <para>You can set some window manager preferences in the <application>Windows</application> preference tool. This manual describes the functions that are
+associated with the default configuration of the <application>Metacity</application>
+window manager. The default configuration is specified in the <application>Windows</application> preference tool.</para>
+<!--Is this preference tool called Window Beahvior in the community?-->
+    </sect2>
+  </sect1>
+  <sect1 id="gosmetacity-713">
+    <title>Types of Window</title>
+    <indexterm>
+      <primary>windows</primary>
+      <secondary>types of</secondary>
+    </indexterm>
+    <para>The GNOME Desktop features the following types of windows: </para>
+    <itemizedlist>
+      <listitem>
+        <para>Application windows </para>
+        <para>When you start an application, an application window opens. The window
+manager applies a frame to the application window. By default, the top edge
+of the application window contains a titlebar. The titlebar contains buttons
+that you can use to work with the window. The buttons in an application window
+frame enable you to perform actions such as open the <guimenu>Window Menu</guimenu>, or close the window. The <guimenu>Window Menu</guimenu> provides
+a number of actions that you can perform on the window. </para>
+        <para>The following figure shows a typical application window. </para>
+        <screenshot>
+          <mediaobject>
+            <imageobject>
+              <imagedata fileref="figures/gedit_window.png" format="PNG"/>
+            </imageobject>
+            <textobject>
+              <phrase>Application window in Simple theme.</phrase>
+            </textobject>
+          </mediaobject>
+        </screenshot>
+      </listitem>
+      <listitem>
+        <para>Dialog windows</para>
+        <para>A dialog window is a popup window in which you enter information or
+commands. The dialog appears within a window frame. </para>
+        <para>You can use the top edge of the frame to work with the window. For example,
+you can use the titlebar to move the dialog. The frame also contains buttons
+that enable you to do the following:</para>
+        <itemizedlist>
+          <listitem>
+            <para>Open the <guimenu>Window Menu</guimenu></para>
+          </listitem>
+          <listitem>
+            <para>Close the dialog window</para>
+          </listitem>
+        </itemizedlist>
+        <para>Typically, you open a dialog window from an application window. When
+you open a dialog window, the window is usually raised and has focus. Some
+dialog windows do not allow you to use the application until you close the
+dialog. </para>
+      </listitem>
+    </itemizedlist>
+    <sect2 id="gosmetacity-16">
+      <title>Window Frames</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>frames</secondary>
+      </indexterm>
+      <para>A window frame is a border around a window. The window frame contains
+a titlebar. The titlebar contains buttons that you can use to work with the
+window.</para>
+      <sect3 id="gosmetacity-10">
+        <title>Themes</title>
+        <indexterm>
+          <primary>windows</primary>
+          <secondary>themes</secondary>
+        </indexterm>
+        <para>You can apply several themes to your window frames. The theme determines
+how the frame looks. To choose a theme for all your window frames, use the <application>Theme</application> preference tool. </para>
+      </sect3>
+      <sect3 id="gosmetacity-17">
+        <title>Control Elements</title>
+        <indexterm>
+          <primary>windows</primary>
+          <secondary>frame control elements</secondary>
+        </indexterm>
+        <para>You can use the window frame to perform various actions
+with the window. In particular, the titlebar contains various buttons. The
+following figure shows the titlebar of an application window:</para>
+        <screenshot>
+          <mediaobject>
+            <imageobject>
+              <imagedata fileref="figures/titlebar_anno_window.png" format="PNG"/>
+            </imageobject>
+            <textobject>
+              <phrase>Window titlebar. Callouts: Window Menu button, Titlebar, Minimize, Maximize, Close Window buttons.</phrase>
+            </textobject>
+          </mediaobject>
+        </screenshot>
+        <para>Dialog windows also contain some of the window frame control elements. <xref linkend="gosmetacity-TBL-1"/> describes the active control elements on window
+frames, from left to right.</para>
+        <table frame="topbot" id="gosmetacity-TBL-1">
+          <title>Window Frame Control Elements</title>
+          <tgroup cols="2" colsep="0" rowsep="0">
+            <colspec colname="colspec0" colwidth="41.65*"/>
+            <colspec colname="colspec1" colwidth="58.35*"/>
+            <thead>
+              <row rowsep="1">
+                <entry>
+                  <para>Control Element</para>
+                </entry>
+                <entry>
+                  <para>Description </para>
+                </entry>
+              </row>
+            </thead>
+            <tbody>
+              <row>
+                <entry colname="colspec0" valign="top">
+                  <para><guibutton>Window Menu</guibutton>
+button</para>
+                </entry>
+                <entry colname="colspec1" valign="top">
+                  <para>Click on
+the button to open the <guimenu>Window Menu</guimenu>. </para>
+                </entry>
+              </row>
+              <row>
+                <entry valign="top">
+                  <para>Titlebar</para>
+                </entry>
+                <entry valign="top">
+                  <para>You can use the titlebar to perform the following actions: </para>
+                  <itemizedlist>
+                    <listitem>
+                      <para>To give focus to the window click on the titlebar.</para>
+                    </listitem>
+                    <listitem>
+                      <para>To move the window grab the titlebar and drag the window to
+the new location. </para>
+                    </listitem>
+                    <listitem>
+                      <para>To maximize the window, double-click on the titlebar. To restore
+the window to the  previous size, double-click on the titlebar again.</para>
+                    </listitem>
+                  </itemizedlist>
+                </entry>
+              </row>
+              <row>
+                <entry valign="top">
+                  <para><guibutton>Minimize</guibutton> button </para>
+                </entry>
+                <entry valign="top">
+                  <para>Click on the <guibutton>Minimize</guibutton> button
+to minimize the window. </para>
+                </entry>
+              </row>
+              <row>
+                <entry valign="top">
+                  <para><guibutton>Maximize</guibutton> button </para>
+                </entry>
+                <entry valign="top">
+                  <para>Click on the <guibutton>Maximize</guibutton> button
+to maximize the window. </para>
+                </entry>
+              </row>
+              <row>
+                <entry colname="colspec0">
+                  <para><guibutton>Close Window</guibutton> button</para>
+                </entry>
+                <entry colname="colspec1">
+                  <para>Click on the <guibutton>Close
+Window</guibutton> button to close the window. </para>
+                </entry>
+              </row>
+              <row>
+                <entry valign="top">
+                  <para>Border</para>
+                </entry>
+                <entry valign="top">
+                  <para>The border around the window. Use the border to perform the following actions: </para>
+                  <itemizedlist>
+                    <listitem>
+                      <para>To resize the window grab the border and drag the border to
+the new size. </para>
+                    </listitem>
+                    <listitem>
+                      <para>To open the <guimenu>Window Menu</guimenu>, right-click on
+the border.</para>
+                    </listitem>
+                  </itemizedlist>
+                </entry>
+              </row>
+              <row>
+                <entry colname="colspec0" valign="top">
+                  <para>Window contents</para>
+                </entry>
+                <entry colname="colspec1">
+                  <para>The area inside the window frame. Use the
+window contents to perform the following actions:</para>
+                  <itemizedlist>
+                    <listitem>
+                      <para>To move a window, press-and-hold <keycap>Alt</keycap>,  click
+in the window contents, then drag the window to the new location.</para>
+                    </listitem>
+                    <listitem>
+                      <para>To resize a window, press-and-hold <keycap>Alt</keycap>, 
+then middle-click near the corner you want to resize. To resize the window,
+drag from the corner on which you middle-clicked.</para>
+                    </listitem>
+                    <listitem>
+                      <para>To open the <guimenu>Window Menu</guimenu>, press-and-hold <keycap>Alt</keycap>, then right-click in the window contents.</para>
+                    </listitem>
+                  </itemizedlist>
+                </entry>
+              </row>
+            </tbody>
+          </tgroup>
+        </table>
+      </sect3>
+    </sect2>
+  </sect1>
+  <sect1 id="gosmetacity-714">
+    <title>Menus and Applets for Working With Windows and Workspaces</title>
+    <indexterm>
+      <primary>windows</primary>
+      <secondary>applets and menus for working
+with</secondary>
+    </indexterm>
+    <para>This section describes the menus and applets
+that you can use to work with windows and workspaces.</para>
+    <sect2 id="gosmetacity-24">
+      <title>Window Menu</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>Window Menu</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>menus</primary>
+        <secondary>Window Menu</secondary>
+      </indexterm>
+      <para>The <guimenu>Window Menu</guimenu> is a menu of commands
+that you can use to perform actions on your windows. To open the <guimenu>Window Menu</guimenu> perform one of the following actions:</para>
+      <itemizedlist>
+        <listitem>
+          <para>Click on the <guibutton>Window Menu</guibutton> button on
+the window that you want to work with.</para>
+        </listitem>
+        <listitem>
+          <para>Press <keycombo><keycap>Alt</keycap><keycap>spacebar</keycap></keycombo>.</para>
+        </listitem>
+        <listitem>
+          <para>Press-and-hold <keycap>Alt</keycap>, then right-click on any
+part of the window that you want to work with. </para>
+        </listitem>
+      </itemizedlist>
+      <para><xref linkend="gosmetacity-TBL-25"/> describes the commands and submenus
+in the <guimenu>Window Menu</guimenu>.</para>
+      <table frame="topbot" id="gosmetacity-TBL-25">
+        <title>Window Menu Commands and Submenus</title>
+        <tgroup cols="2" colsep="0" rowsep="0">
+          <colspec colname="colspec2" colwidth="32.34*"/>
+          <colspec colname="colspec3" colwidth="67.66*"/>
+          <thead>
+            <row rowsep="1">
+              <entry>
+                <para>Menu Item</para>
+              </entry>
+              <entry>
+                <para>Function</para>
+              </entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry valign="top">
+                <para>
+                  <guimenuitem>Minimize</guimenuitem>
+                </para>
+              </entry>
+              <entry valign="top">
+                <para>Minimizes the window.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top">
+                <para><guimenuitem>Maximize</guimenuitem> or <guimenuitem>Unmaximize</guimenuitem></para>
+              </entry>
+              <entry valign="top">
+                <para>Maximizes
+the window. If the window is already maximized, choose <guimenuitem>Unmaximize</guimenuitem> to restore the window to its previous size. </para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec2">
+                <para>
+                  <guimenuitem>On Top</guimenuitem>
+                </para>
+              </entry>
+              <entry colname="colspec3">
+                <para>Places
+the window above any other open windows on the desktop.</para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec2" valign="top">
+                <para>
+                  <guimenuitem>Move</guimenuitem>
+                </para>
+              </entry>
+              <entry colname="colspec3" valign="top">
+                <para>Enables you to use the arrow
+keys to move the window.</para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec2" valign="top">
+                <para>
+                  <guimenuitem>Resize</guimenuitem>
+                </para>
+              </entry>
+              <entry colname="colspec3" valign="top">
+                <para>Enables you to use the arrow
+keys to resize the window.</para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec2" valign="top">
+                <para>
+                  <guimenuitem>Close</guimenuitem>
+                </para>
+              </entry>
+              <entry colname="colspec3" valign="top">
+                <para>Closes the window.</para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec2" valign="top">
+                <para><guimenuitem>Put on All
+Workspaces</guimenuitem> or <guimenuitem>Only on This Workspace</guimenuitem></para>
+              </entry>
+              <entry colname="colspec3" valign="top">
+                <para>Puts the window on all of your
+workspaces. If the window is already on all of your workspaces, choose <guimenuitem>Only on This Workspace</guimenuitem>  to put the window on the current workspace
+only.</para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec2">
+                <para><guimenuitem>Move
+to Workspace Right</guimenuitem>  or <guimenuitem>Move to Workspace Left</guimenuitem></para>
+              </entry>
+              <entry colname="colspec3">
+                <para>Move the window to the
+workspace to the right of the current workspace. If the window is already
+in the last workspace at the right of the Workspace Switcher, choose <guimenuitem>Move to Workspace Left</guimenuitem> to move the window to the workspace to
+the left of the current workspace.</para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec2">
+                <para>
+                  <guimenuitem>Move
+to Another Workspace</guimenuitem>
+                </para>
+              </entry>
+              <entry colname="colspec3">
+                <para>Moves the window to another workspace. Select the workspace to which you want
+to move the window from the submenu.</para>
+              </entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </table>
+    </sect2>
+    <sect2 id="gosmetacity-18">
+      <title>Window List Applet</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>Window List applet</secondary>
+        <see>Window List applet</see>
+      </indexterm>
+      <indexterm>
+        <primary>Window List applet</primary>
+        <secondary>introduction</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>window lists</primary>
+        <secondary>Window List applet</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>applets</primary>
+        <secondary>Window List</secondary>
+      </indexterm>
+      <para><application>Window List</application> displays a button for each application
+window that is open. You can use the <application>Window List</application>
+to perform the following tasks:</para>
+      <itemizedlist>
+        <listitem>
+          <para>To minimize a window</para>
+          <para>Click on the button that represents the window.</para>
+        </listitem>
+        <listitem>
+          <para>To restore a minimized window</para>
+          <para>Click on the button that represents the window.</para>
+        </listitem>
+        <listitem>
+          <para>To give focus to a window</para>
+          <para>Click on the button that represents the window.</para>
+        </listitem>
+      </itemizedlist>
+      <para>When you open an application window, <application>Window List</application>
+displays a button that represents the window. The window list buttons show
+which application windows are open. You can view which windows are open even
+if some windows are minimized, or other windows overlap a window. <application>Window List</application> can display buttons for the windows in your current
+workspace, or in all workspaces. To select this option, you must change the
+preferences of <application>Window List</application>.</para>
+      <para>You can also right-click on a window list button to open the <guimenu>Window Menu</guimenu> for the window that the button represents.
+For more information on the <guimenu>Window Menu</guimenu> commands, see <xref linkend="gosmetacity-24"/>.</para>
+      <para><xref linkend="gosmetacity-FIG-8"/> shows <application>Window List</application>
+when the following windows are open:</para>
+      <itemizedlist>
+        <listitem>
+          <para>
+            <application>gedit</application>
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            <application>Dictionary</application>
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            <application>GHex</application>
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            <application>GNOME Terminal</application>
+          </para>
+        </listitem>
+      </itemizedlist>
+      <figure id="gosmetacity-FIG-8">
+        <title>Window List Applet</title>
+        <screenshot>
+          <mediaobject>
+            <imageobject>
+              <imagedata fileref="figures/window_list_applet.png" format="PNG"/>
+            </imageobject>
+            <textobject>
+              <phrase>Window List applet. The context describes the graphic.</phrase>
+            </textobject>
+          </mediaobject>
+        </screenshot>
+      </figure>
+      <para>The buttons in the applet show the status of your windows. <xref linkend="gosmetacity-TBL-3"/>
+explains the information that the window list buttons provide about the window.
+The examples in <xref linkend="gosmetacity-TBL-3"/> refer to <xref linkend="gosmetacity-FIG-8"/>. </para>
+      <table frame="topbot" id="gosmetacity-TBL-3">
+        <title>Window Status Information on Window List Buttons<indexterm><primary>Window List applet</primary><secondary>window status information</secondary></indexterm></title>
+        <tgroup cols="3" colsep="0" rowsep="0">
+          <colspec colname="colspec0" colwidth="33*"/>
+          <colspec colname="colspec1" colwidth="33*"/>
+          <colspec colname="colspec2" colwidth="33*"/>
+          <thead>
+            <row rowsep="1">
+              <entry>
+                <para>State</para>
+              </entry>
+              <entry>
+                <para>Indicates</para>
+              </entry>
+              <entry>
+                <para>Example</para>
+              </entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry valign="top">
+                <para>Button is pressed in.</para>
+              </entry>
+              <entry valign="top">
+                <para>The window has focus.</para>
+              </entry>
+              <entry valign="top">
+                <para>
+                  <guilabel>gedit</guilabel>
+                </para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top">
+                <para>Square brackets around window title.</para>
+              </entry>
+              <entry valign="top">
+                <para>The window is minimized.</para>
+              </entry>
+              <entry valign="top">
+                <para>
+                  <guilabel>[Dictionary]</guilabel>
+                </para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top">
+                <para>Button is not pressed in, no square brackets
+around title.</para>
+              </entry>
+              <entry valign="top">
+                <para>The window is displayed,
+and is not minimized.</para>
+              </entry>
+              <entry valign="top">
+                <para>
+                  <guilabel>ghex</guilabel>
+                </para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec0" valign="top">
+                <para>Numeral on button, in parentheses.</para>
+              </entry>
+              <entry colname="colspec1" valign="top">
+                <para>The button represents
+a group of buttons. </para>
+              </entry>
+              <entry colname="colspec2" valign="top">
+                <para>
+                  <guilabel>Gnome-terminal (3)</guilabel>
+                </para>
+              </entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </table>
+      <sect3 id="gosmetacity-708">
+        <title>Grouping Buttons</title>
+        <indexterm>
+          <primary>Window List applet</primary>
+          <secondary>grouping buttons</secondary>
+        </indexterm>
+        <para><application>Window List</application> can group
+the buttons that represent windows in the same class under one window list
+button. The <guibutton>Gnome-terminal</guibutton> button in <xref linkend="gosmetacity-FIG-8"/>
+is an example of a button that represents a group of buttons. The following
+figure shows an example of <application>Window List</application> with a button
+group open:</para>
+        <screenshot>
+          <mediaobject>
+            <imageobject>
+              <imagedata fileref="figures/window_list_group_applet.png" format="PNG"/>
+            </imageobject>
+            <textobject>
+              <phrase>Window List applet with button group open.</phrase>
+            </textobject>
+          </mediaobject>
+        </screenshot>
+        <para>To open a list of the windows in a group, click on the window list button
+that represents the group. You can click on the items in the list to give
+focus to windows, minimize windows, and restore windows.</para>
+        <para>To open the <guimenu>Window Menu</guimenu> for a window in a button
+group, right-click on the window list button that represents the group. A
+list of the windows in the group is displayed. To open the <guimenu>Window
+Menu</guimenu> for a window in the group, point to the item in the list.
+For more information on the <guimenu>Window Menu</guimenu> commands, see <xref linkend="gosmetacity-24"/>.</para>
+      </sect3>
+    </sect2>
+    <sect2 id="gosmetacity-20">
+      <title>Workspace Switcher Applet</title>
+      <indexterm>
+        <primary>workspaces</primary>
+        <secondary>Workspace Switcher applet</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>applets</primary>
+        <secondary>Workspace
+Switcher</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>Workspace Switcher applet</primary>
+      </indexterm>
+      <para><application>Workspace Switcher</application>
+displays a visual representation of your workspaces, as shown in <xref linkend="gosmetacity-FIG-722"/>. <xref linkend="gosmetacity-FIG-722"/> shows the applet when the GNOME session contains
+four workspaces. Your workspaces appear as buttons on the applet. The background
+of the button in the applet that represents the current workspace is highlighted.
+The current workspace in <xref linkend="gosmetacity-FIG-722"/> is the workspace
+at the left of the applet. To switch to another workspace, click on the workspace
+in the applet.</para>
+      <figure id="gosmetacity-FIG-722">
+        <title>Workspace Switcher Applet</title>
+        <screenshot>
+          <mediaobject>
+            <imageobject>
+              <imagedata fileref="figures/workspace_switcher_applet.png" format="PNG"/>
+            </imageobject>
+            <textobject>
+              <phrase>Workspace Switcher applet. The context describes the graphic.</phrase>
+            </textobject>
+          </mediaobject>
+        </screenshot>
+      </figure>
+      <para><application>Workspace Switcher</application> also displays the application
+windows and dialogs that are open in your workspaces.</para>
+      <para>The applet displays the workspaces in order from left to right across
+the rows of the applet. In <xref linkend="gosmetacity-FIG-722"/>, the applet
+is set up to display the workspaces in one row. You can specify the number
+of rows in which your workspaces are displayed in <application>Workspace Switcher</application>. You can also change the default behavior of the applet to
+display the names of your workspaces in the applet.</para>
+    </sect2>
+    <sect2 id="gosmetacity-27">
+      <title>Window Selector Applet</title>
+      <indexterm>
+        <primary>top edge panel</primary>
+        <secondary>window selector icon</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>window selector</primary>
+        <secondary>top edge panel</secondary>
+      </indexterm>
+      <para>You can view a list of all windows
+that are currently open. You can also choose a window to give focus to. To
+view the window list, click on the <application>Window Selector</application>
+applet. The following figure shows an example of the <application>Window Selector</application> applet:</para>
+      <screenshot>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/openwindows_menu.png" format="PNG"/>
+          </imageobject>
+          <textobject>
+            <phrase>Window selector applet displayed from the top edge panel.</phrase>
+          </textobject>
+        </mediaobject>
+      </screenshot>
+      <para>To give focus to a window, select the window from the <application>Window Selector</application> applet.</para>
+      <para>The <application>Window Selector</application> lists the windows in
+all workspaces. The windows in all workspaces other than the current workspace,
+are listed under a separator line.</para>
+    </sect2>
+  </sect1>
+  <sect1 id="gosmetacity-715">
+    <title>Manipulating Windows</title>
+    <indexterm>
+      <primary>windows</primary>
+      <secondary>manipulating</secondary>
+    </indexterm>
+    <para>This section describes how to manipulate windows.</para>
+    <sect2 id="gosmetacity-28">
+      <title>To Give Focus to a Window</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>giving focus to</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>focus, giving to a window</primary>
+      </indexterm>
+      <para>A window that has focus can receive input from the mouse and the keyboard.
+Only one window can have focus at a time. The window that has focus has a
+different appearance than other windows. </para>
+      <para>You can use the following elements to give focus to a window:</para>
+      <informaltable frame="topbot">
+        <tgroup cols="2" colsep="0" rowsep="0">
+          <colspec colname="colspec0" colwidth="33.62*"/>
+          <colspec colname="colspec1" colwidth="66.38*"/>
+          <thead>
+            <row rowsep="1">
+              <entry>
+                <para>Element</para>
+              </entry>
+              <entry>
+                <para>Action</para>
+              </entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry valign="top">
+                <para>Mouse</para>
+              </entry>
+              <entry valign="top">
+                <para>Click on the window, if the window is visible. </para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec0" valign="top">
+                <para>Shortcut keys</para>
+              </entry>
+              <entry colname="colspec1" valign="top">
+                <para>Use shortcut keys to switch between
+the windows that are open. To give focus to a window, release the keys. The
+default shortcut keys to switch between windows are <keycombo><keycap>Alt</keycap><keycap>Tab</keycap></keycombo>. </para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec0" valign="top">
+                <para>
+                  <application>Window List</application>
+                </para>
+              </entry>
+              <entry colname="colspec1" valign="top">
+                <para>Click on the button that represents the window in <application>Window List</application>.</para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec0">
+                <para>
+                  <application>Window Selector</application>
+                </para>
+              </entry>
+              <entry colname="colspec1">
+                <para>Click on the <application>Window Selector</application> icon. A list of your open windows is displayed. Select the
+window from the list.</para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec0" valign="top">
+                <para>
+                  <application>Workspace Switcher</application>
+                </para>
+              </entry>
+              <entry colname="colspec1" valign="top">
+                <para>Click on the window that you want to give focus to in the <application>Workspace
+Switcher</application> display. If you click on a window in another workspace, <application>Workspace Switcher</application> switches to the new workspace, and gives
+focus to the window. </para>
+              </entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </informaltable>
+    </sect2>
+    <sect2 id="gosmetacity-29">
+      <title>To Minimize a Window</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>minimizing</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>minimizing</primary>
+        <secondary>windows</secondary>
+      </indexterm>
+      <para>To minimize a window, perform one of the following actions: </para>
+      <itemizedlist>
+        <listitem>
+          <para>Click on the <guibutton>Minimize</guibutton> button on the
+window frame.</para>
+        </listitem>
+        <listitem>
+          <para>Open the <guimenu>Window Menu</guimenu>, then choose <guimenuitem>Minimize</guimenuitem>. </para>
+        </listitem>
+        <listitem>
+          <para>If the window has focus, click on the button that represents
+the window in <application>Window List</application>. If the window does not
+have focus, click twice on the button that represents the window. </para>
+        </listitem>
+        <listitem>
+          <para>Right-click on the button that represents the window in <application>Window List</application>, then choose <guimenuitem>Minimize</guimenuitem>
+from the popup menu.</para>
+        </listitem>
+      </itemizedlist>
+    </sect2>
+    <sect2 id="gosmetacity-30">
+      <title>To Maximize a Window</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>maximizing</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>maximizing windows</primary>
+      </indexterm>
+      <para>When you
+maximize a window, the window expands as much as possible. To maximize a window,
+perform one of the following actions: </para>
+      <itemizedlist>
+        <listitem>
+          <para>To maximize the window, click on the <guibutton>Maximize</guibutton>
+button on the window frame. Alternatively, open the <guimenu>Window Menu</guimenu>,
+then choose <guimenuitem>Maximize</guimenuitem>.</para>
+        </listitem>
+        <listitem>
+          <para>Right-click on the button that represents the window in <application>Window List</application>, then choose <guimenuitem>Maximize</guimenuitem>
+from the <guimenu>Window Menu</guimenu>.</para>
+        </listitem>
+      </itemizedlist>
+    </sect2>
+    <sect2 id="gosmetacity-31">
+      <title>To Restore a Window</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>restoring</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>restoring</primary>
+        <secondary>windows</secondary>
+      </indexterm>
+      <para>To restore a maximized window, perform one of the following actions: </para>
+      <itemizedlist>
+        <listitem>
+          <para>Click on the <guibutton>Maximize</guibutton> button on the
+window frame.</para>
+        </listitem>
+        <listitem>
+          <para>Open the <guimenu>Window Menu</guimenu>. Choose <guimenuitem>Unmaximize</guimenuitem>. </para>
+        </listitem>
+        <listitem>
+          <para>Right-click on the button that represents the window in <application>Window List</application> to open the <guimenu>Window Menu</guimenu>. Choose <guimenuitem>Unmaximize</guimenuitem>.</para>
+        </listitem>
+      </itemizedlist>
+      <para>To restore a minimized window, click on the button that represents the
+window in <application>Window List</application>.</para>
+    </sect2>
+    <sect2 id="gosmetacity-2">
+      <title>To Place a Window on Top of Other Windows</title>
+      <para>To place a window on top of other windows, open the <guimenu>Window
+Menu</guimenu>, then choose <guimenuitem>On Top</guimenuitem>.</para>
+    </sect2>
+    <sect2 id="gosmetacity-32">
+      <title>To Close a Window</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>closing</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>closing windows</primary>
+      </indexterm>
+      <para>To close a
+window perform one of the following actions: </para>
+      <itemizedlist>
+        <listitem>
+          <para>Click on the <guibutton>Close Window</guibutton> button on
+the window frame.</para>
+        </listitem>
+        <listitem>
+          <para>Open the <guimenu>Window Menu</guimenu>. Choose <guimenuitem>Close</guimenuitem>.</para>
+        </listitem>
+        <listitem>
+          <para>Right-click on the button that represents the window in <application>Window List</application>, then choose <guimenuitem>Close</guimenuitem> from
+the <guimenu>Window Menu</guimenu>.</para>
+        </listitem>
+      </itemizedlist>
+      <para>If you have unsaved data in the window, you are prompted to save your
+data.</para>
+    </sect2>
+    <sect2 id="gosmetacity-34">
+      <title>To Resize a Window</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>resizing</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>resizing windows</primary>
+      </indexterm>
+      <para>To resize
+a window perform one of the following actions:</para>
+      <itemizedlist>
+        <listitem>
+          <para>Point to a corner of the window. The mouse pointer changes
+to indicate that you can resize the window. Grab the corner and drag the window
+to the new size.</para>
+        </listitem>
+        <listitem>
+          <para>Right-click on the button that represents the window in <application>Window List</application>. Choose <guimenuitem>Resize</guimenuitem> from the <guimenu>Window Menu</guimenu>. Use the arrow keys to resize the window.</para>
+        </listitem>
+        <listitem>
+          <para>Press-and-hold <keycap>Alt</keycap>, then middle-click near
+the corner that you want to resize. The mouse pointer changes to indicate
+that you can resize from the corner. To resize the window, drag from the corner
+on which you middle-clicked.</para>
+        </listitem>
+        <listitem>
+          <para>To resize a window horizontally point to one of the vertical
+edges of the window. The mouse pointer changes to indicate that you can resize
+the window. Grab the edge and drag the window to the new size.</para>
+        </listitem>
+        <listitem>
+          <para>To resize a window vertically point to the bottom edge of
+the window. The mouse pointer changes to indicate that you can resize the
+window. Grab the edge and drag the window to the new size.</para>
+        </listitem>
+      </itemizedlist>
+      <note>
+        <para>You cannot resize some dialog windows. Also, some application
+windows have a minimum size below which you cannot reduce the window.</para>
+      </note>
+    </sect2>
+    <sect2 id="gosmetacity-35">
+      <title>To Move a Window</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>moving</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>moving windows</primary>
+      </indexterm>
+      <para>To move a window
+perform one of the following actions: </para>
+      <itemizedlist>
+        <listitem>
+          <para>Grab the titlebar of the window and drag the window to the
+new location. </para>
+        </listitem>
+        <listitem>
+          <para>Press-and-hold <keycap>Alt</keycap>, then drag the window
+to the new location. </para>
+        </listitem>
+        <listitem>
+          <para>Open the <guimenu>Window Menu</guimenu>, then choose <guimenuitem>Move</guimenuitem>. Use the arrow keys to move the window to the new location.</para>
+        </listitem>
+        <listitem>
+          <para>Right-click on the button that represents the window in <application>Window List</application>, then choose <guimenuitem>Move</guimenuitem> from
+the <guimenu>Window Menu</guimenu>. Use the arrow keys to move the window
+to the new location.</para>
+        </listitem>
+      </itemizedlist>
+    </sect2>
+    <sect2 id="gosmetacity-36">
+      <title>To Roll Up a Window</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>rolling up</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>rolling up windows</primary>
+      </indexterm>
+      <indexterm>
+        <primary>shading windows</primary>
+        <see>rolling up windows</see>
+      </indexterm>
+      <para>You
+can roll up and roll down windows, as follows:</para>
+      <variablelist>
+        <varlistentry>
+          <term>Roll up</term>
+          <listitem>
+            <para>Reduce the window so that
+only the titlebar is visible.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Roll down</term>
+          <listitem>
+            <para>Switch a window from a
+rolled-up state so that the full window is displayed.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+      <para>To roll up a window perform one of the following actions: </para>
+      <itemizedlist>
+        <listitem>
+          <para>Double-click on the titlebar of the window. To roll down the
+window, double-click on the titlebar again. You must select <guilabel>Roll
+up</guilabel> in the <application>Windows</application> preferences tool to
+perform this action.</para>
+        </listitem>
+        <listitem>
+          <para>Right-click on the button that represents the window in <application>Window List</application>, then choose <guimenuitem>Roll Up</guimenuitem>
+from the <guimenu>Window Menu</guimenu>. To roll down the window, choose <guimenuitem>Unroll</guimenuitem>.</para>
+        </listitem>
+      </itemizedlist>
+    </sect2>
+    <sect2 id="gosmetacity-38">
+      <title>To Put a Window on All Workspaces</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>putting on all workspaces</secondary>
+      </indexterm>
+      <para>To put a window in all workspaces, open the <guimenu>Window Menu</guimenu>. Choose <guimenuitem>Put on All Workspaces</guimenuitem>.
+To set the window to appear only in the current workspace, choose <guimenuitem>Only on This Workspace</guimenuitem>.</para>
+    </sect2>
+    <sect2 id="gosmetacity-46">
+      <title>To Move a Window to Another Workspace</title>
+      <indexterm>
+        <primary>windows</primary>
+        <secondary>moving to another workspace</secondary>
+      </indexterm>
+      <indexterm>
+        <primary>workspaces</primary>
+        <secondary>moving windows to </secondary>
+      </indexterm>
+      <para>You can move a window to another
+workspace in either of the following ways:</para>
+      <itemizedlist>
+        <listitem>
+          <para>Use <application>Workspace Switcher</application></para>
+          <para>In the <application>Workspace Switcher</application> display, drag the
+window to the workspace you require.</para>
+        </listitem>
+        <listitem>
+          <para>Use the <guimenu>Window Menu</guimenu></para>
+          <para>Open the <guimenu>Window Menu</guimenu>. To move the window to another
+workspace, choose <guimenuitem>Move to Workspace Right</guimenuitem> or <guimenuitem>Move to Workspace Left</guimenuitem>. Alternatively, <guimenuitem>Move to
+Another Workspace <replaceable>workspace-name</replaceable></guimenuitem>.</para>
+        </listitem>
+      </itemizedlist>
+    </sect2>
+  </sect1>
+  <sect1 id="gosmetacity-716">
+    <title>Manipulating Workspaces</title>
+    <indexterm>
+      <primary>workspaces</primary>
+      <secondary>manipulating</secondary>
+    </indexterm>
+    <para>This section describes how to manipulate workspaces.</para>
+    <sect2 id="gosmetacity-49">
+      <title>To Switch Between Workspaces</title>
+      <indexterm>
+        <primary>workspaces</primary>
+        <secondary>switching between</secondary>
+      </indexterm>
+      <para>You can switch between workspaces in any of the following
+ways: </para>
+      <itemizedlist>
+        <listitem>
+          <para>Use <application>Workspace Switcher</application></para>
+          <para>Click on the workspace that you want to switch to in <application>Workspace
+Switcher</application>.</para>
+        </listitem>
+        <listitem>
+          <para>Use shortcut keys</para>
+          <para>The default shortcut keys to switch between the workspaces are as follows: </para>
+          <informaltable frame="topbot">
+            <tgroup cols="2" colsep="0" rowsep="0">
+              <colspec colwidth="50*"/>
+              <colspec colwidth="50*"/>
+              <thead>
+                <row rowsep="1">
+                  <entry>
+                    <para>Default Shortcut Keys</para>
+                  </entry>
+                  <entry>
+                    <para>Function</para>
+                  </entry>
+                </row>
+              </thead>
+              <tbody>
+                <row>
+                  <entry>
+                    <para><keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>right arrow</keycap></keycombo></para>
+                  </entry>
+                  <entry>
+                    <para>Selects the workspace to the
+right. </para>
+                  </entry>
+                </row>
+                <row>
+                  <entry>
+                    <para><keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>left arrow</keycap></keycombo></para>
+                  </entry>
+                  <entry>
+                    <para>Selects the workspace to the
+left. </para>
+                  </entry>
+                </row>
+              </tbody>
+            </tgroup>
+          </informaltable>
+        </listitem>
+      </itemizedlist>
+    </sect2>
+    <sect2 id="gosmetacity-50">
+      <title>To Add Workspaces</title>
+      <indexterm>
+        <primary>workspaces</primary>
+        <secondary>adding</secondary>
+      </indexterm>
+      <para>To add workspaces to the GNOME Desktop, right-click on <application>Workspace Switcher</application>, then choose <guimenuitem>Preferences</guimenuitem>.
+The <guilabel>Workspace Switcher Preferences</guilabel> dialog is displayed.
+Use the <guilabel>Number of workspaces</guilabel> spin box to specify the
+number of workspaces you require. <application>Workspace Switcher</application>
+adds new workspaces at the end of the workspace list.</para>
+    </sect2>
+    <sect2 id="gosmetacity-51">
+      <title>To Name Workspaces</title>
+      <indexterm>
+        <primary>workspaces</primary>
+        <secondary>naming</secondary>
+      </indexterm>
+      <para>The default names of your workspaces are <literal>Workspace 1</literal>, <literal>Workspace 2</literal>, <literal>Workspace 3</literal>, and so on. To assign
+names to your workspaces, right-click on <application>Workspace Switcher</application>,
+then choose <guimenuitem>Preferences</guimenuitem>. The <guilabel>Workspace
+Switcher Preferences</guilabel> dialog is displayed. Use the <guilabel>Workspaces
+names</guilabel> list box to specify the names of your workspaces. Select
+a workspace, then type the new name for the workspace.</para>
+    </sect2>
+    <sect2 id="gosmetacity-52">
+      <title>To Delete Workspaces</title>
+      <indexterm>
+        <primary>workspaces</primary>
+        <secondary>deleting</secondary>
+      </indexterm>
+      <para>When you delete a workspace the windows in the workspace are moved to
+another workspace, and the empty workspace is deleted. </para>
+      <para>To delete workspaces from the GNOME Desktop, right-click on <application>Workspace Switcher</application>, then choose <guimenuitem>Preferences</guimenuitem>.
+The <guilabel>Workspace Switcher Preferences</guilabel> dialog is displayed.
+Use the <guilabel>Number of workspaces</guilabel> spin box to specify the
+number of workspaces you require. <application>Workspace Switcher</application>
+deletes workspaces from the end of the workspace list.</para>
+    </sect2>
+  </sect1>
+</chapter>