[kde-doc-english] [kde-workspace] doc/kcontrol/windowbehaviour: windowbehaviour kcm update to 4.12
Burkhard Lück
lueck at hube-lueck.de
Fri Nov 15 20:11:03 UTC 2013
Git commit 244f3162eb37a169a4e9a64e26f29422a5ec9965 by Burkhard Lück.
Committed on 15/11/2013 at 20:10.
Pushed by lueck into branch 'master'.
windowbehaviour kcm update to 4.12
CCBUG:305297
M +126 -204 doc/kcontrol/windowbehaviour/index.docbook
http://commits.kde.org/kde-workspace/244f3162eb37a169a4e9a64e26f29422a5ec9965
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