[kde-doc-english] [kde-workspace/KDE/4.11] doc/kcontrol/windowbehaviour: windowbehaviour kcm update to 4.12

Burkhard Lück lueck at hube-lueck.de
Sun Nov 17 19:37:33 UTC 2013


Git commit 8632c280954637a401c5cd0db2d84985ffbeec10 by Burkhard Lück.
Committed on 15/11/2013 at 20:10.
Pushed by lueck into branch 'KDE/4.11'.

windowbehaviour kcm update to 4.12

CCBUG:305297
(cherry picked from commit 244f3162eb37a169a4e9a64e26f29422a5ec9965)
backport for 4.12

M  +126  -204  doc/kcontrol/windowbehaviour/index.docbook

http://commits.kde.org/kde-workspace/8632c280954637a401c5cd0db2d84985ffbeec10

diff --git a/doc/kcontrol/windowbehaviour/index.docbook b/doc/kcontrol/windowbehaviour/index.docbook
index 83e06c5..f98efd3 100644
--- a/doc/kcontrol/windowbehaviour/index.docbook
+++ b/doc/kcontrol/windowbehaviour/index.docbook
@@ -16,8 +16,8 @@
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
-<date>2010-10-28</date>
-<releaseinfo>&kde; 4.5</releaseinfo>
+<date>2013-11-15</date>
+<releaseinfo>&kde; 4.12</releaseinfo>
 
 <keywordset>
 <keyword>KDE</keyword>
@@ -42,7 +42,7 @@ you can configure how titlebars and windows react to
 mouse clicks. <guilabel>Moving</guilabel> allows you to configure how
 windows move and place themselves when started.  The
 <guilabel>Advanced</guilabel> options cover some specialized options
-involving moving windows between desktops and <quote>window
+like <quote>window tabbing</quote> and <quote>window
 shading</quote>.
 </para>
 
@@ -69,60 +69,32 @@ front — this is referred to as <quote>raised</quote>, and
 although this is configured here as well, focus and raising of windows
 are configured independently.</para>
 
-<sect3 id="action-focus-focusstealin">
-<title>Focus stealing prevention level</title>
-
-<para>This option specifies how much KWin will try to prevent unwanted focus 
-stealing caused by unexpected activation of new windows.</para> 
-<note><para>This feature does not work with the <guilabel>Focus Under Mouse</guilabel> 
-or <guilabel>Focus Strictly Under Mouse</guilabel> focus policies.</para></note>
-<variablelist>
-<varlistentry>
-<term><guilabel>None</guilabel></term>
-<listitem><para>Prevention is turned off and new windows always become activated.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term><guilabel>Low</guilabel></term>
-<listitem><para>Prevention is enabled; when some window does not have support 
-for the underlying mechanism and KWin cannot reliably decide whether to activate 
-the window or not, it will be activated. This setting may have both worse and better 
-results than the medium level, depending on the applications.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term><guilabel>Medium</guilabel></term>
-<listitem><para>Prevention is enabled.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guilabel>High</guilabel></term>
-<listitem><para>New windows get activated only 
-if no window is currently active or if they belong to the currently active 
-application. This setting is probably not really usable when not using mouse 
-focus policy.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term><guilabel>Extreme</guilabel></term>
-<listitem><para>All windows must be explicitly activated by the user.</para></listitem>
-</varlistentry>
-</variablelist>
-<para>Windows that are prevented from stealing focus are marked as demanding 
-attention, which by default means their taskbar entry will be highlighted. 
-This can be changed in the Notifications control module.</para>
-</sect3>
-  
 <sect3 id="action-focus-focuspolicy">
 <title>Focus Policy</title>
 
 <para>
-There are four methods &kde; can use to determine the current focus:
+There are six methods &kde; can use to determine the current focus:
 </para>
 
 <variablelist>
 <varlistentry>
-<term><guilabel>Click to Focus</guilabel></term>
+<term><guilabel>Click To Focus</guilabel></term>
 <listitem>
 <para>
 A window becomes active when you click into it.
+This behaviour is common on other operating systems and likely what you want.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Click To Focus - Mouse Precedence</guilabel></term>
+<listitem>
+<para>
+This is mostly the same as <guilabel>Click To Focus</guilabel>.
+If an active window has to be chosen by the system
+(eg. because the currently active one was closed) 
+the window under the mouse is the preferred candidate.
+Unusual, but possible variant of <guilabel>Click To Focus</guilabel>.
 </para>
 </listitem>
 </varlistentry>
@@ -135,6 +107,9 @@ Moving the mouse pointer actively over a normal window activates it. New
 windows such as the mini command line invoked with
 <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will receive the focus,
 without you having to point the mouse at them explicitly.
+⪚ windows randomly appearing under the mouse will not gain the focus.
+Focus stealing prevention takes place as usual.
+Think as <guilabel>Click To Focus</guilabel> just without having to actually click.
 </para>
 
 <para>
@@ -145,6 +120,19 @@ follows mouse</quote>.
 </varlistentry>
 
 <varlistentry>
+<term><guilabel>Focus Follows Mouse - Mouse Precedence</guilabel></term>
+<listitem>
+<para>
+This is mostly the same as <guilabel>Focus Follows Mouse</guilabel>.
+If an active window has to be chosen by the system
+(⪚ because the currently active one was closed) 
+the window under the mouse is the preferred candidate.
+Choose this, if you want a hover controlled focus.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
 <term><guilabel>Focus Under Mouse</guilabel></term>
 <listitem>
 <para>
@@ -152,7 +140,7 @@ The window that happens to be under the mouse pointer becomes active.  If
 the mouse is not over a window (for instance, it's on the desktop) the last
 window that was under the mouse has focus.  New windows such as the mini
 command line invoked with <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will
-not receive the focus, you must move the mouse over them to type.
+ot receive the focus, you must move the mouse over them to type.
 </para>
 </listitem>
 </varlistentry>
@@ -168,29 +156,70 @@ New windows such as the mini command line invoked with
 you must move the mouse over them to type. 
 </para>
 
+</listitem>
+</varlistentry>
+</variablelist>
+
 <note><para>Note that <guilabel>Focus Under Mouse</guilabel> and
 <guilabel>Focus Strictly Under Mouse</guilabel> prevent certain
-features, such as the <keycombo action="simul">&Alt;	</keycombo>
+features, such as <guilabel>Focus stealing prevention</guilabel> and the 
+<keycombo action="simul">&Alt;	</keycombo>
 walk-through-windows dialog, from working properly.</para>
 </note>
 
-</listitem>
+</sect3>
+
+<sect3 id="action-focus-focusstealin">
+<title>Focus stealing prevention level</title>
+
+<para>This option specifies how much KWin will try to prevent unwanted focus 
+stealing caused by unexpected activation of new windows.</para> 
+
+<variablelist>
+<varlistentry>
+<term><guilabel>None</guilabel></term>
+<listitem><para>Prevention is turned off and new windows always become activated.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Low</guilabel></term>
+<listitem><para>Prevention is enabled; when some window does not have support 
+for the underlying mechanism and KWin cannot reliably decide whether to activate 
+the window or not, it will be activated. This setting may have both worse and better 
+results than the medium level, depending on the applications.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Medium</guilabel></term>
+<listitem><para>Prevention is enabled.</para></listitem>
 </varlistentry>
-</variablelist>
 
+<varlistentry>
+<term><guilabel>High</guilabel></term>
+<listitem><para>New windows get activated only 
+if no window is currently active or if they belong to the currently active 
+application. This setting is probably not really usable when not using mouse 
+focus policy.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Extreme</guilabel></term>
+<listitem><para>All windows must be explicitly activated by the user.</para></listitem>
+</varlistentry>
+</variablelist>
+<para>Windows that are prevented from stealing focus are marked as demanding 
+attention, which by default means their taskbar entry will be highlighted. 
+This can be changed in the Notifications control module.</para>
+</sect3>
+  
+<sect3 id="action-focus-raisingwindow">
+<title>Raising window</title>
 <para>
 Once you have determined the focus policy, there are the window
 raising options.
 </para>
 
 <para>
-By placing a mark in front of <guilabel>Raise, with the following delay</guilabel>, &kde; can
+By placing a mark in front of <guilabel>Raise on hover, delayed by</guilabel>, &kde; can
 bring a window to the front if the mouse is over that window for a
-specified period of time. When <guilabel>Delay focus by</guilabel> is enabled, 
-there will be a delay after which the window the mouse pointer is over will become 
-active (receive focus).
-This is very useful with the <guilabel>Focus Follows Mouse</guilabel> option.  
-You can determine the delay for both options by using the spin box controls.
+specified period of time. You can determine the delay for this option by using the spin box control.
 </para>
 
 <tip>
@@ -205,7 +234,7 @@ that window to the front.
 
 <para>
 If you do not use auto raise, make sure the
-<guilabel>Click raise active window</guilabel> option has a mark in front of it.  You
+<guilabel>Click raises active window</guilabel> option has a mark in front of it.  You
 will not be happy with both auto raise and
 <guilabel>Click raise active window</guilabel> disabled, the net effect is that
 windows are not raised at all.
@@ -213,52 +242,6 @@ windows are not raised at all.
 
 </sect3>
 
-<!-- not in 4.5
-<sect3 id="action-focus-keyboard">
-<title><guilabel>Navigation</guilabel></title>
-
-<para>
-In the <guilabel>Navigation</guilabel> frame you can configure the way
-switching between applications or desktops using <keycombo
-action="simul"> &Alt;	</keycombo> or <keycombo
-action="simul"> &Ctrl;	</keycombo>.
-</para>
-
-<para>
-Switching applications using <keycombo action="simul">&Alt;
-	</keycombo>, &ie; holding down &Alt; while
-repeatedly pressing the 	 key, can take place in
-&kde; mode or in &CDE; mode: in &kde; mode you will see
-a box in the middle of the screen showing you the currently selected
-application while you are still holding down the &Alt; key. In
-&CDE; mode focus goes to each new window as it's selected.
-</para>
-
-<para>
-<guilabel>Show window list while switching windows</guilabel> missing
-Next there is an option where you can choose to <guilabel>Traverse
-windows on all desktops</guilabel> or not.  With this enabled, switching
-windows with <keycombo action="simul">
-&Alt;	</keycombo> will show all windows, on all
-desktops, and take you to the appropriate desktop for the window you
-select.  With it disabled, only windows on your current desktop are
-selectable with <keycombo action="simul">
-&Alt;	</keycombo>, and you must use <keycombo
-action="simul">&Ctrl;	</keycombo> to switch to other
-desktops yourself.
-</para>
-
-<para>If you check the <guilabel>Desktop navigation wraps
-around</guilabel> checkbox, then after you reach the
-<quote>last</quote> desktop, pressing 	 again will
-select the first desktop again.</para>
-
-<para>Many people name their virtual desktops according to their
-purpose or some other naming scheme.  You may find it convenient to
-select the <guilabel>Popup desktop name on desktop switch</guilabel>,
-so you can quickly tell that you have switched to the right one.</para>
-</sect3>
--->
 </sect2>
 
 <sect2 id="titlebar-actions">
@@ -270,7 +253,7 @@ clicked on their titlebars.
 </para>
 
 <sect3 id="action-actions-sec1">
-<title><guilabel>Titlebar double-click</guilabel></title>
+<title>Titlebar double-click</title>
 
 <para>
 In this drop down box you can select either
@@ -289,7 +272,7 @@ reduced to simply the titlebar.  Double clicking on the titlebar again,
 restores the window to its normal size.
 </para>
 
-<!-- <guilabel>Titlebar wheel event</guilabel> missing -->
+<!--FIXME <guilabel>Wheel event</guilabel> missing -->
 
 <tip>
 <para>
@@ -313,7 +296,7 @@ different actions associated with the same click depending on whether
 the window is active or not.
 </para>
 
-<para> For each combination of mousebuttons, modifiers, Active and
+<para> For each combination of mousebuttons, Active and
 Inactive, you can select the most appropriate choice.  The actions are
 as follows: </para>
 
@@ -367,7 +350,7 @@ which overlap with this one, will be hidden <quote>below</quote> it.
 </varlistentry>
 
 <varlistentry>
-<term>Toggle Raise & Lower</term>
+<term><guilabel>Toggle Raise & Lower</guilabel></term>
 <listitem>
 <para>
 This will raise windows which are not on top, and lower windows which
@@ -375,6 +358,9 @@ are already on top.
 </para>
 </listitem>
 </varlistentry>
+<!--FIXME missing:
+Shade, Close, Start Window Tab Drag
+-->
 </variablelist>
 </sect3>
 
@@ -397,7 +383,8 @@ only or both directions.
 
 <para>
 This part of the module, allows you to configure what happens when you
-click on an inactive window, with any of the three mouse buttons.
+click on an inactive window, with any of the three mouse buttons or use
+the mouse wheel.
 </para>
 
 <para>
@@ -429,7 +416,7 @@ application within the window.
 <term><guilabel>Activate</guilabel></term>
 <listitem>
 <para>
-This simply makes the clicked window active.  The mouse click is not
+This simply makes the clicked window active. The mouse click is not
 passed on to the application within the window.
 </para>
 </listitem>
@@ -440,13 +427,15 @@ passed on to the application within the window.
 <listitem>
 <para>
 This makes the clicked window active and raises the window to the top of
-the display.  The mouse click is not passed on to the application within
+the display. The mouse click is not passed on to the application within
 the window.
 </para>
 </listitem>
 </varlistentry>
-</variablelist>
 
+<!--FIXME Mouse wheel Scroll, Activate & Scroll, Activate, Raise & Scroll-->
+
+</variablelist>
 </sect3>
 
 <sect3 id="action-actions-sec4">
@@ -524,6 +513,17 @@ are already on top.
 </listitem>
 </varlistentry>
 </variablelist>
+<!-- FIXME missing:
+Activate, Raise & Move
+Minimize
+Increase Opacity + Decrease Opacity
+-->
+<!--FIXME
+Mouse Wheel has different choices:
+Raise/Lower, Shade/Unshade, Maximize/Restore, Keep Above/Below, 
+Move to Previous/Next Desktop, Change Opacity, Switch to Window Tab to the Left/Right
+Nothing
+-->
 
 </sect3>
 
@@ -534,48 +534,17 @@ are already on top.
 
 <sect3>
 <title><guilabel>Windows</guilabel></title>
-
-<para>The options here determine how windows appear on screen when you
-are moving them.  Most of these options exact a price in performance,
-so if you want to streamline your desktop, you should turn them off.
-However, if you have a fast computer, they may make your day a little
-more pleasant, so leave them on.</para>
+<para>
+The options here determine how windows appear on screen when you
+are moving them.</para>
 
 <variablelist>
 <varlistentry>
-<term><guilabel>Display content in moving windows</guilabel></term>
-<listitem>
-<para>Enable this option if you want a window's content to be fully
-shown while moving it, instead of just showing a window
-<quote>skeleton</quote>.  The result may not be satisfying on slow
-computers without graphic acceleration.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guilabel>Display content in resizing windows</guilabel></term>
+<term><guilabel>Display window geometry when moving or resizing</guilabel></term>
 <listitem>
-<para>Enable this option if you want a window's content to be shown
-while resizing it, instead of just showing a window
-<quote>skeleton</quote>.  The result, again, may not be satisfying on
-slower computers.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guilabel>Display window geometry when moving or
-resizing</guilabel></term>
-<listitem>
-<para>Enable this option if you want a popup tooltip to tell you the
-size in pixels of a window as you resize it.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guilabel>Display borders on maximized windows</guilabel></term>
-<listitem>
-<para>When enabled, this feature activates the border of maximized
-windows, and allows you to move or resize them just as you can normal
-windows.</para>
+<para>Enable this option if you want a window's geometry to be displayed 
+while it is being moved or resized. The window position relative to the top-left 
+corner of the screen is displayed together with its size.</para>
 </listitem>
 </varlistentry>
 </variablelist>
@@ -647,21 +616,13 @@ tuning to the window behavior.
 <variablelist>
 <title>Shading</title>
 
-<!--not in 4.5 varlistentry>
-<term><guilabel>Animate</guilabel></term>
-<listitem>
-<para>If this option is enabled,  shading, or rolling up a window until just
-the title bar is shown, will be animated.</para>
-</listitem>
-</varlistentry-->
-
 <varlistentry>
 <term><guilabel>Enable hover</guilabel></term>
 <listitem>
 <para>
 If this option is enabled, a shaded window will un-shade automatically
 when the mouse pointer has been over the titlebar for some time. Use
-the slider to configure the delay un-shading.
+the spinbox to configure the delay un-shading.
 </para>
 </listitem>
 </varlistentry>
@@ -671,10 +632,9 @@ the slider to configure the delay un-shading.
 <title>Window Tabbing</title>
 
 <varlistentry>
-<term>When turned on attempt to automatically detect when a newly opened window is 
-related to an existing one and place them in the same window group.</term>
-<listitem><para> 
-</para></listitem>
+<term><guilabel>Automatically group similar windows</guilabel></term>
+<listitem><para>When turned on attempt to automatically detect when a newly opened window is 
+related to an existing one and place them in the same window group.</para></listitem>
 </varlistentry>
 
 <varlistentry>
@@ -695,6 +655,10 @@ open all windows with their top left corner in the top left corner of
 the screen.</para></listitem>
 </varlistentry>
 
+</variablelist>
+
+<variablelist>
+<title>Special Window</title>
 <varlistentry>
 <term><guilabel>Hide utility windows for inactive applications</guilabel></term>
 <listitem><para>When turned on, utility windows (tool windows, torn-off menus,...) of 
@@ -705,48 +669,6 @@ with the proper window type for this feature to work.</para></listitem>
 
 </variablelist>
 
-<variablelist>
-<title>Tiling</title>
-
-<varlistentry>
-<term><guilabel>Enable Tiling</guilabel></term>
-<listitem><para>A tiling window manager lays out all the windows in a 
-non-overlapping manner. This way all windows are always visible.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guilabel>Default Tiling Layout</guilabel></term>
-<listitem><para>Select <guilabel>Spiral</guilabel>, <guilabel>Columns</guilabel>
-(Two-column horizontal tiling layout) or <guilabel>Floating</guilabel> (Floating 
-layout, windows are not tiled at all) as default here.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guilabel>Floating Windows Raising</guilabel></term>
-<listitem><para>The window raising policy determines how floating windows are stacked.
-<guilabel>Raise/Lower floating windows</guilabel> all will raise all floating 
-windows when a floating window is activated. <guilabel>Raise/Lower current 
-window only</guilabel> will raise only the current window. <guilabel>Floating windows 
-are always on top</guilabel> keep floating windows on top, even when a tiled window 
-is activated.</para></listitem>
-</varlistentry>
-
-</variablelist>
-
-<!--not in 4.5 in this module
-<para>Finally, you can configure <guilabel>Active Desktop
-Borders</guilabel>.  If this is enabled, moving the mouse to a screen
-border will change your desktop.  This is useful if you want to drag
-windows from one desktop to another.</para>
-
-<para>You can set this option to <guilabel>Disabled</guilabel>, which
-is the default, to <guilabel>Only when moving windows</guilabel>, or
-to <guilabel>Always enabled</guilabel> in which case just pushing your
-mouse against the side of the screen will switch you to a new
-desktop.</para>
--->
 </sect2>
 
 </sect1>



More information about the kde-doc-english mailing list