path: root/doc/manual/xfwm4.xml

<?xml version='1.0'?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY date "Jan 2005">
  <!ENTITY appversion "@PACKAGE_VERSION@">
  <!ENTITY app "@PACKAGE_NAME@">
]>

<article id="index" lang="en">

<!-- Header -->
<articleinfo>

  <title>Xfce 4 Window Manager</title>

  <copyright>
    <year>2004</year> <holder>François Le Clainche</holder>
  </copyright>

  <copyright>
    <year>2004</year> <holder>Jasper Huijsmans</holder>
  </copyright>

<!-- translators: uncomment this:

  <copyright>
   <year>2002</year> <holder>ME-THE-TRANSLATOR (Latin
   translation)</holder>
  </copyright>

 -->

<!-- I don't know about this
  <legalnotice id="legalnotice">
    <para>
      This document is provided under the terms of the GNU GPL, version
      2 or (at your option) any later version.
    </para>
  </legalnotice>
-->
  <authorgroup>

    <author>
      <firstname>François</firstname> <surname>Le Clainche</surname>
      <affiliation>
	<address><email>fleclainche@wanadoo.fr</email></address>
      </affiliation>
    </author>

<!-- This is appropriate place for other contributors: translators,
maintainers, etc. Commented out by default.

    <othercredit role="translator">
      <firstname>Latin</firstname> <surname>Translator 1</surname>
      <affiliation>
	<orgname>Latin Translation Team</orgname>
	<address><email>translator@gnome.org</email> </address>
      </affiliation> <contrib>Latin translation</contrib>
    </othercredit>
-->

  </authorgroup>

  <!--
  <revhistory>
    <revision>
      <revnumber>0.1</revnumber>
      <date>May 2003</date>
      <authorinitials>ma</authorinitials>
    </revision>
  </revhistory>
  -->

  <releaseinfo>This manual describes &app; version &appversion;
  </releaseinfo>

</articleinfo>

<sect1 id="wm-intro">
  <title>Introduction</title>

  <para>The Xfce 4 Window Manager is part of the <ulink
      url="http://www.xfce.org" type="html">Xfce Desktop Environment</ulink>.
    The actual command to run is <application>&app;</application>. To run it in the background use
    <command><application>&app;</application> --daemon</command>. The window manager is responsible for
    the placement of windows on the screen, provides the window
    decorations and allows you for instance to move, resize or close them.
  </para>

  <para><application>&app;</application> adheres strongly to the standards defined on
    <ulink url="http://www.freedesktop.org"
      type="html">freedesktop.org</ulink>.
    Consequently, special features such as making windows borderless, or
    providing an icon for the application must now be implemented in the
    application; you can no longer use the window manager to force different
    behaviour. One of the great features of <application>&app;</application> is its themeability. The window
    decorations (borders, title bar and window buttons) can be configured by
    using window manager themes.
  </para>

  <para><application>&app;</application> offers multihead support, for both xinerama and real multiscreen modes,
	useful when you have more than one monitor connected to your computer.
  </para>

  <para><application>&app;</application> can be run stand-alone, but if you use it this way, you will
    need the <ulink url="xfce-mcs-manager.html" type="http">Xfce 4 Settings
      Manager</ulink> if you want GUI settings management. Tasks other than
    managing windows, like setting a background image or launching programs,
    need to be performed by other programs.
  </para>

  <para><application>&app;</application> includes its own compositing manager, which takes advantage
  of the new <ulink url="http://freedesktop.org/Software/xorg" type="html">X.org</ulink>'s
  server extensions. The compositor is like a WM on its own, it manages a stack
  of all windows, monitor all kinds on X event and reacts accordingly. Having the
  compositing manager embedded in the window manager also helps keeping the
  various visual effects in sync with window events. If you want to use the compositor,
  you have to build <application>&app;</application> using the --enable-compositor configure option. In any case,
  you can disable the compositor on <application>&app;</application> startup using the '--compositor=off' argument.
  </para>

</sect1>

<sect1 id="wm-using">
  <title>Using <application>&app;</application></title>

  <sect2 id="wm-windows">
    <title>Manage windows</title>

    <para>The window manager provides borders, a title bar and window buttons
      to application windows. The look is defined by the window manager
      theme.</para>

    <para>In the default theme <application>&app;</application> shows six buttons and a title on regular
      application windows. The six buttons perform these basic
      functions:</para>


    <figure id="titlebar-fig">
      <title><application>&app;</application> title bar buttons</title>

      <screenshot>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="images/titlebar.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>&app;</application> title bar buttons and functions</phrase>
	  </textobject>
	</mediaobject>
      </screenshot>
    </figure>

	<para>You can open the window menu with a left-click on the menu button on
      the title bar, or with a right-click on the window title area itself.
	</para>
	<para>If you use <application>xftaskbar4</application>, you can open an
		action menu with a right-click on one of the taskbar entries; it includes
		several items among those available in the window menu.
	</para>

    <variablelist>

      <varlistentry>
	<term>Give focus to a window</term>
	<listitem>
	  <para>You need to give the focus to a window if you want it to
	    receive keyboard and mouse input. Window decorations colors will
	    change, following the focus. To obtain more details about focus
	    options, please refer to the <ulink url="#focus">corresponding section</ulink> below.
	  </para>
	  <para>A keyboard shortcut allows to switch the focus from a window
	    to others : Hold Alt and then you can press Tab repeatedly untill
	    you get to the window you want to focus. If you use it, you will
	    see a small popup showing the application name, its icon and the
	    window title. Also <application>&app;</application> will highlight the outline of the window that
	    will receive the focus.
	  </para>

<!--	  <para>
	    If you want the panel, and apps that do not appear in the taskbar,
	    to be included when you switch the focus using the Alt+Tab
	    shortcut, edit your $HOME/.config/xfce4/xfwm4/xfwm4rc (or create an new one)
	    and add this line : cycle_minimum=false</para>

	  <para>
	    To exclude hidden windows from the list presented when using
		Alt+Tab edit your $HOME/.config/xfce4/xfwm4/xfwm4rc (or create a new one) and
		add this line : cycle_hidden=false
	  </para>
-->

	  <para>NOTE: the use of a keyboard shortcut in an application needs
	    the application window to have the focus :)
	  </para>

	</listitem>
      </varlistentry>

      <varlistentry>
	<term>Maximize / unmaximize windows</term>
	<listitem>
	<para>If you maximize a window, it will expand on your display and use
	  all avaible space (as it is defined by <ulink
	    url="xfdesktop.html#xfdesktop-workspace" type="http">workspace
	    settings</ulink>). You can maximize a window either vertically,
	    horizontally, or both at once.
	</para>
	<para>To maximize a window, perform one of those actions:</para>
	<itemizedlist>
	  <listitem>
	    <para>click the maximize button of the title bar</para>
	  </listitem>
	  <listitem>
	    <para>
	      open the window menu from the title bar and choose the
	      "maximize" item
	    </para>
	  </listitem>
	  <listitem>
	    <para>use Alt + F5 keyboard shortcut</para>
	  </listitem>
	</itemizedlist>

	<para>You can make any window appear in fullscreen mode (it will
		then use all the size of your screen without showing the window
		borders) by using the customizable Alt + F11 keyboard shortcut.
	</para>

	<para>To maximize a window vertically :</para>
	<itemizedlist>
	  <listitem><para>middle-click the maximize button of the title bar</para></listitem>
	  <listitem><para>use Alt + F6 keyboard shortcut</para></listitem>
	</itemizedlist>

	<para>To maximize a window horizontally :</para>

	<itemizedlist>
	  <listitem><para>right-click the maximize button of the title bar</para></listitem>
	  <listitem><para>use Alt + F7 keyboard shortcut</para></listitem>
	</itemizedlist>

	<para>When a window has been maximized in a way or another, it can be
	  restored to its previous size doing one of these actions :</para>

	<itemizedlist>
	  <listitem><para>click the unmaximize button of the title bar</para></listitem>
	  <listitem><para>use the same keyboard shortcut once again</para></listitem>
	  <listitem><para>choose the "Unmaximize" item in the window menu</para></listitem>
	</itemizedlist>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Resize windows</term>
      <listitem>
	<para>Although certain special windows can not be resized, you are
	  able to resize most of them to fit your needs.</para>
	<itemizedlist>
	<listitem><para>you can use the edges and corners of the window frame to
	  modify its size, dragging them with the mouse</para></listitem>
	<listitem><para>you can use the Alt + right click shortcut while you hold
	  the mouse pointer anywhere over the window frame; it will act as if
	  you were dragging the bottom-right corner of the window</para></listitem>
	<listitem><para>you can use practical keyboard shortcuts : Shift +
	  Alt + (up, down, right or left) Arrow</para></listitem>
	</itemizedlist>

<!--
		<para>If you want to disable the ability to move and resize windows
		using the Alt button + mouse click shortcut, edit your
		$HOME/.config/xfce4/xfwm4/xfwm4rc (or create an new one) and add this line :
		easy_click=false</para>
-->
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Hide / unhide windows</term>
      <listitem>
	<para>You can hide a window performing one of these actions :</para>
	<itemizedlist>
	<listitem><para>click the hide button of the title bar</para></listitem>
	<listitem><para>open the window menu from the title bar and choose the
	  "Hide" item</para></listitem>
	<listitem><para>use Alt + F8 keyboard shortcut </para></listitem>
	</itemizedlist>
	<para>Alternatively, you can hide all windows of current workspace,
	  excepted the one you are using, in only one action : click the menu
	  button of the title bar and choose "Hide all others".</para>
	<para>To "unhide" a window, you will have to select its name or its
	  icon in one of those Xfce 4 components :</para>
	<itemizedlist>
	<listitem><para><application>xftaskbar4</application></para></listitem>
	<listitem><para>the list of windows, accessible with a middle-click on the
	  desktop background. This list shows all opened windows, classified
	  by workspaces. Windows that are currently hidden are marked between
	  [  ].</para></listitem>
	<listitem><para>the <application>xfce4-iconbox</application></para></listitem>
	</itemizedlist>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Shade / unshade windows</term>
      <listitem>
	<para>If you "shade" a window, it will be reduced to the size of its
	  title bar. The same repeated action makes a window to shade/unshade
	  :</para>
	<itemizedlist>
	<listitem><para>click the shade/unshade button of the title bar</para></listitem>
	<listitem><para>open the window menu from the title bar and choose "Shade"
	  or "Unshade" item</para></listitem>
	<listitem><para>use the mouse scrollwheel while you hold the pointer over
	  the title bar</para></listitem>
	<listitem><para>use the Alt + F9 keyboard shortcut</para></listitem>
	</itemizedlist>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Stick / unstick windows</term>
      <listitem>
	<para>If you "stick" a window, it will be visible at the same place on
	  all your workspaces. The same repeated action make a window to
	  stick/unstick :
	</para>
	<itemizedlist>
	  <listitem><para>click the stick/unstick button of the title bar</para></listitem>
	  <listitem><para>open the window menu button from the title bar and choose
	    "Stick" or "Unstick" item</para></listitem>
	  <listitem><para>use the Alt + F10 keyboard shortcut</para></listitem>
	</itemizedlist>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Raise / lower windows</term>
      <listitem>
         <para>The "raise window" function makes a window frame appear above all the other frames.
         To raise a window, you can :
         </para>
	<itemizedlist>
	<listitem><para>left click on its titlebar</para></listitem>
	<listitem><para>give the focus to the window, if the corresponding option is selected in the <ulink
      url="xfwm4.html#wm-focus" type="http">Keyboard and focus preferences dialog</ulink></para></listitem>
	<listitem><para>left click anywhere on its frame, if the corresponding option is selected in the <ulink
      url="xfwm4.html#wm-focus" type="http">Keyboard and focus preferences dialog</ulink></para></listitem>
	<listitem><para>click on its label in the taskbar or the iconbox</para></listitem>
        <listitem><para>use the Shift + Alt + Page_Up keyboard shortcut (if the window is already focused)</para></listitem>
	</itemizedlist>

	<para>You can make a window frame to always stay above all other windows
		by opening the window menu and selecting the "always on top" item.
	</para>

        <para>The "lower" function sends a window frame below all other frames.
	To "lower" a window, you can :
	</para>
	<itemizedlist>
	<listitem><para>middle-click on its title bar</para></listitem>
        <listitem><para>use the Shift + Alt + Page_Down keyboard shortcut (if the window is focused)</para></listitem>
	</itemizedlist>
    </listitem>
    </varlistentry>

    <varlistentry>
      <term>Move windows</term>
      <listitem>
	<para>There are several ways to move windows :</para>
	<itemizedlist>
	  <listitem><para>left or right click on the title bar of the window and
	    drag it</para></listitem>
	  <listitem><para>use Alt + left click while the pointer is anywhere over
	    the window frame and move the mouse</para></listitem>
	  <listitem><para>use Control + Alt + Shift + (up, down, left or right)
	    Arrow keyboard shortcut</para></listitem>
	</itemizedlist>

<!--

		<para>If you want to disable the ability to move and resize windows
		using the Alt button + mouse click shortcut, edit your
		$HOME/.config/xfce4/xfwm4/xfwm4rc (or create an new one) and add this line :
		easy_click=false</para>
-->
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Move a window to another workspace</term>
      <listitem>
	<para>You can send a window to another workspace by performing one of
	  these actions :</para>
	<itemizedlist>
	  <listitem><para>stick the window, move to another workspace, then unstick
	    the window.</para></listitem>
	<listitem><para>use the window menu and choose one of the "Send to" submenu
	  items.</para></listitem>
	<listitem><para>left or right click on the title bar of the window, drag it
	  to the screen edge : the pointer will then go to the next workspace,
	  still holding the window. Corresponding option needs to be selected
	  in the <ulink url="xfwm4.html#wm_misc" type="http">Window Manager
	    Preferences dialog</ulink>.</para></listitem>
	<listitem><para>use keyboard shortcuts :</para>
	  <itemizedlist>
	    <listitem><para>Alt + Control + End will move a window to the next
	      workspace</para></listitem>
	    <listitem><para>Alt + Control + Home will move a window to the previous
	      workspace</para></listitem>
	    <listitem><para>Alt + Control + Keypad-Number will move the current
	      window to corresponding workspace</para></listitem>
	  </itemizedlist>
	</listitem>
	<listitem><para>use the <ulink url="xfce4-panel.html#switcher-item"
	    type="http">graphical pager </ulink> by clicking on the
	  representation of the window, and move it to the desired
	  workspace.
	</para></listitem>
      </itemizedlist>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term>Close a window</term>
    <listitem>
      <para>To close a window :</para>
	<itemizedlist>
	<listitem><para>click the close button of the title bar</para></listitem>
	<listitem><para>Open the window menu from the title bar and choose the
	  "Close" item</para></listitem>
	<listitem><para>or use Alt + F4 keyboard shortcut</para></listitem>
	</itemizedlist>
      </listitem>
    </varlistentry>

  </variablelist>
</sect2>

</sect1>

<sect1 id="wm-settings">
  <title>Customizing <application>&app;</application></title>

  <para>To open the Window Manager preferences dialog, click the button
    labelled "Window Manager" in the <ulink
      url="xfce-mcs-manager.html#manager-dialog" type="http">Xfce 4 Settings
      manager</ulink>. The dialog shows four tabs : Style,
    Keyboard, Focus, Advanced. All modifications will have an immediate
    effect on the behaviour of the selected module.</para>

  <sect2 id="wm-style">
    <title>Decoration style</title>

    <figure id="wm_decoration_style-fig">
      <title>Decoration style preferences</title>

      <screenshot>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="images/decoration_style.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>The decoration style tab</phrase>
	  </textobject>
	</mediaobject>
      </screenshot>
    </figure>

    <variablelist>

      <varlistentry>
	<term>Window style</term>
	<listitem>
	<para>The list on the left side of the dialog shows all avaible window
	  decorations. The xfwm 4 module offers the choice between 4
	  different themes, but there are more than 60 supplementary themes
	  avaible in xfwm4-themes extra package.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Title font</term>
      <listitem>
	<para>The "Font select" button shows the family font currently in use
	  for the window title appearance. Click this button if you want to
	  change it, and a "Font selection" dialog will appear. It works like
	  the font selection dialog of the <ulink
	    url="xfce-mcs-plugins.html#id2811474" type="http">user interface
	    settings manager plugin</ulink>.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Title alignment</term>
      <listitem>
	<para>Whatever the buttons layout is, you can choose the alignment of
	  the title inside the title bar, selecting one of those simple
	  options : align it to the left, center or right.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Button layout</term>
      <listitem>
        <para>The button layout configuration uses an easy drag and drop
        tool. Click and drag the buttons to change the layout.
        Drop a button in the "Hidden" area to remove a button from the
        titlebar. All modifications will have an immediate effect on
        the title bar buttons position.
	</para>
      </listitem>
    </varlistentry>

  </variablelist>
</sect2>

<sect2 id="keyboard_shortcuts">
  <title>Keyboard shortcuts</title>

  <figure id="keyboard_shortcuts-fig">
    <title>Keyboard shortcuts preferences</title>

    <screenshot>
      <mediaobject>
	<imageobject>
	  <imagedata fileref="images/keyboard_shortcuts.png" format="PNG"/>
	</imageobject>
	<textobject>
	  <phrase>The keyboard shortcuts tab</phrase>
	</textobject>
      </mediaobject>
    </screenshot>
  </figure>

  <variablelist>

    <varlistentry>
      <term>Keyboard Shortcuts</term>
      <listitem>
	<para>The list on the left side of the dialog shows all avaible
	  shortcuts themes, using the name of directories that contain a
	  keythemerc file.
	</para>
	<para>By default, there's only one theme :
	  $(datadir)/themes/Default/xfwm4/keythemerc
	</para>

    <para>In the default configuration the following keybindings are
      defined:</para>

    <itemizedlist>
      <listitem><para>close window : Alt + F4</para></listitem>
      <listitem><para>Maximize window : Alt + F5</para></listitem>
      <listitem><para>Maximize vertically : Alt + F6</para></listitem>
      <listitem><para>Maximize horizontally : Alt + F7</para></listitem>
      <listitem><para>Hide window : Alt + F8</para></listitem>
      <listitem><para>Shade window : Alt + F9</para></listitem>
      <listitem><para>Stick window : Alt + F10</para></listitem>
      <listitem><para>Cycle windows focus : Alt + Tab</para></listitem>
      <listitem><para>Move window : Control + Shift + Alt + Arrow (up, down, left,
	or right)</para></listitem>
      <listitem><para>Resize window : Shift + Alt + Arrow (up, down, left, or
	right)</para></listitem>
      <listitem><para>Raise window : Shift + Alt + Page_Up</para></listitem>
      <listitem><para>Lower window : Shift + Alt + Page_Down</para></listitem>
      <listitem><para>Toggle fullscreen : Alt + F11</para></listitem>
      <listitem><para>Next workspace : Control + Alt + Arrow right
	arrow</para></listitem>
      <listitem><para>Previous workspace : Control + Alt + Arrow left</para></listitem>
      <listitem><para>Add a workspace : Alt + Insert</para></listitem>
      <listitem><para>Delete a workspace : Alt + Delete</para></listitem>
      <listitem><para>Go to workspace number N (1-9) : Control + F(N)</para></listitem>
      <listitem><para>Move the window to previous|next workspace : Alt + Control +
	Home|End</para></listitem>
      <listitem><para>Move a window to workspace number N (1-9) : Alt + Control +
	keypad key number N</para></listitem>
      <listitem><para>Start xfhelp4 : Alt + F1</para></listitem>
      <listitem><para>Start xfrun4 : Alt + F2</para></listitem>
      <listitem><para>Lock the screen : Alt + Control + Delete</para></listitem>
    </itemizedlist>

	<para>There are two lists on the right side of the dialog. The
		"Windows shortcuts" list shows the keyboard shortcuts which are
		used to drive the window manager. The "Command shortcuts" list
		shows the keyboard shortcuts which are aimed at launching
		applications. To modify one of the shortcuts, you have to
		double-click on it in the list, using the left button of your
		mouse, and compose your new shortcut when the "Compose shortcut"
		popup window appears.
	</para>

	  <figure id="compose_shortcut-fig">
    <title>The compose shortcut popup</title>

    <screenshot>
      <mediaobject>
	<imageobject>
	  <imagedata fileref="images/compose_shortcut.png" format="PNG"/>
	</imageobject>
	<textobject>
	  <phrase>The compose shortcut popup</phrase>
	</textobject>
      </mediaobject>
    </screenshot>
  </figure>

	<para>If you want to create a new theme, create a directory like
		this one, for instance : $HOME/.themes/Custom/xfwm4/keythemerc,
		then select it in the list of available themes.
	</para>

	<para>If you do not know the names of your keyboard modifier keys,
		you can launch the "xev" application from a terminal and test them.
	</para>

      </listitem>
    </varlistentry>

  </variablelist>
</sect2>

<sect2 id="focus">
  <title>Focus preferences</title>

  <figure id="focus-fig">
    <title>Focus preferences</title>

    <screenshot>
      <mediaobject>
	<imageobject>
	  <imagedata fileref="images/focus.png" format="PNG"/>
	</imageobject>
	<textobject>
	  <phrase>The Focus tab</phrase>
	</textobject>
      </mediaobject>
    </screenshot>
  </figure>

  <variablelist>

    <varlistentry>
      <term>Focus model</term>
      <listitem>
	<para>A focused window receives the keyboard and mouse input. You have
	  the choice between two focus models :</para>
	<itemizedlist>
	  <listitem><para>Click to focus : select this option if you want a window
	    to receive the focus only when you click anywhere on its
	    frame.
	  </para></listitem>
	  <listitem><para>Focus follow mouse : select this option if you want a
	    window to receive the focus as soon as the mouse pointer is over
	    its frame.
	  </para></listitem>
	</itemizedlist>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>New window focus</term>
      <listitem>
	<para>Selecting this option will automatically give the focus to newly
	  created windows, without the need to click or move the mouse
	  pointer.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Raise on focus</term>
      <listitem>
        <para>If this option is selected, the frame of a newly focused window
	  will automatically appear over all other frames, after an amount of
	  time that you can adjust with the "delay" slider.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Raise on click</term>
      <listitem>
	<para>Choose this option if you want a window to pass over the others
	  when you click anywhere on its frame. If this option is not
	  selected, you will have to click somewhere on its decorations (title
	  bar, borders or corners) to raise it.
	</para>
      </listitem>
    </varlistentry>



  </variablelist>
</sect2>

<sect2 id="wm_advanced">
  <title>Advanced settings</title>

  <figure id="misc_wm_prefs-fig">
    <title>Advanced preferences</title>

    <screenshot>
      <mediaobject>
	<imageobject>
	  <imagedata fileref="images/misc_wm_prefs.png" format="PNG"/>
	</imageobject>
	<textobject>
	  <phrase>Advanced tab</phrase>
	</textobject>
      </mediaobject>
    </screenshot>
  </figure>

  <variablelist>

    <varlistentry>
      <term>Windows snapping</term>
      <listitem>
	<para>You can choose the windows borders to be attracted by the
	  borders of other windows, or by the screen edges, when they are
	  moved. The distance from which this effect will be applied can be
	  specified with the "Distance" slider.</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Wrap workspaces</term>
      <listitem>
	<para>Select the first option if you want to switch to the next
	  workspace when the mouse pointer reaches the screen edges. Select
	  the second one if you want the same behaviour while dragging a
	  window. You can specify the screen edges resistance using the
	  corresponding slider.</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Opaque move and resize</term>
      <listitem>
	<para>Two options allow you to choose if the content of a window will
	  appear or not, when you move or resize it (not displaying the
	  content will save some system resources).</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Double click action</term>
      <listitem>
	<para>Select what must be the behaviour of the window manager when you
	  double-click on the title bar of a window : shade window, hide
	  window, maximize window or none.</para>
      </listitem>
    </varlistentry>

  </variablelist>
</sect2>

</sect1>

<sect1 id="workspaces">

  <title>Managing workspaces</title>

  <para><application>&app;</application> also manages workspaces. There is a special settings dialog to
    change the workspace properties. You can start it by choosing
    <emphasis>Workspaces and Margins</emphasis> from the the <ulink
      url="xfce-mcs-manager.html#manager-dialog" type="http">settings manager
      dialog</ulink>. The dialog contains two tab folders where you can
    change workspace settings and desktop margins.
  </para>

  <sect2>

    <title>Workspaces settings</title>

    <figure id="xfwm-workspace-fig">
      <title>Workspace Settings</title>
      <screenshot>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="images/xfwm_workspaces.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Shows workspace settings tab folder.
	    </phrase>
	  </textobject>
	</mediaobject>
      </screenshot>
    </figure>

    <variablelist>

      <varlistentry>
	<term>Workspaces</term>
	<listitem>
	  <para>This option allows you too choose the number of workspaces you
	    want to use (between 1 and 32).
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>Worspace names</term>
	<listitem>
	  <para>This field shows the list of avaible workspaces. If you want to
	    edit the name of one of them, click its number and a fill the entry
	    of the dialog that will then appear. When it's done, click the
	    "Apply" button, or just press the Enter key, to return to the
	    list.
	  </para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

  <sect2 id="workspace-margins">
    <title>Workspaces margins</title>

    <figure id="workspace_margins-fig">
      <title>The workspace margins dialog</title>

      <screenshot>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="images/workspace_margins.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>The workspace margins tab folder</phrase>
	  </textobject>
	</mediaobject>
      </screenshot>
    </figure>

    <para>To open the Workspace Margins dialog, click the button labelled
      "Workspaces and Margins" in the <ulink
	url="xfce-mcs-manager.html#manager-dialog" type="http">settings manager
	dialog</ulink> and choose the tab labelled "Margins".
    </para>

    <para>Margins are areas on the edges of the screen that maximized windows
      won't cover. You can adjust the size, in pixels, of all margins (left,
      right, top and bottom). Use this feature, for example, if you do not want
      maximized windows to overlap panel or iconbox frames.</para>

  </sect2>


</sect1>

<sect1 id="wm-copyright">
  <title>About <application>&app;</application></title>

  <para><application>&app;</application> was written Olivier Fourdan
    (<email>fourdan@xfce.org</email>). To find more information, please visit
    the <ulink url="http://www.xfce.org" type="http">Xfce web site</ulink>.
  </para>

  <para>To report a bug or make a suggestion regarding this application or
    this manual, use the bug tracking system at <ulink
      url="http://bugzilla.xfce.org/"
      type="http">http://bugzilla.xfce.org/</ulink>.
  </para>

  <para>If you have questions about the use or installation of this package,
    please ask on the <ulink
      url="http://lunar-linux.org/mailman/listinfo/xfce"
      type="http">xfce</ulink> mailing list. Development discussion takes
    place on the <ulink
      url="http://lunar-linux.org/mailman/listinfo/xfce4-dev"
      type="http">xfce4-dev</ulink> mailing list.
  </para>

  <para> This program is distributed under the terms of the
    GNU General Public License as published by the Free Software Foundation;
    either version 2 of the License, or (at your option) any later version.
  </para>

  <para>You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
    USA.
  </para>

</sect1>

</article>