diff --git a/doc/windowbehaviour/index.docbook b/doc/windowbehaviour/index.docbook
index 75f0305563..bebe41253e 100644
--- a/doc/windowbehaviour/index.docbook
+++ b/doc/windowbehaviour/index.docbook
@@ -16,8 +16,8 @@
-2015-07-14
-Plasma 5.3
+2021-04-09
+Plasma 5.20
KDE
@@ -33,13 +33,13 @@
In the upper part of this control module you can see several
tabs: Focus, Titlebar Actions,
-Window Actions, Moving and
+Window Actions, Movement and
Advanced. In the
Focus panel you can configure how windows gain or
lose focus, &ie; become active or inactive. Using
Titlebar Actions and Window Actions
you can configure how titlebars and windows react to
-mouse clicks. Moving allows you to configure how
+mouse clicks. Movement allows you to configure how
windows move and place themselves when started. The
Advanced options cover some specialized options
like window shading
.
@@ -48,7 +48,7 @@ like window shading
.
Please note that the configuration in this module will not take effect
-if you do not use &kde;'s native window manager, &kwin;. If you do use a
+if you do not use &plasma;'s native window manager, &kwin;. If you do use a
different window manager, please refer to its documentation for how to
customize window behavior.
@@ -69,15 +69,15 @@ although this is configured here as well, focus and raising of windows
are configured independently.
-Focus Policy
+Windows activation policy
-There are six methods &kde; can use to determine the current focus:
+There are six methods &kwin; can use to determine the current focus:
-Click To Focus
+Click to focus
A window becomes active when you click into it.
@@ -86,20 +86,20 @@ This behaviour is common on other operating systems and likely what you want.
-Click To Focus - Mouse Precedence
+Click to focus (mouse precedence)
-This is mostly the same as Click To Focus.
+This is mostly the same as Click to focus.
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.
-Unusual, but possible variant of Click To Focus.
+Unusual, but possible variant of Click to focus.
-Focus Follows Mouse
+Focus follows mouse
Moving the mouse pointer actively over a normal window activates it. New
@@ -108,7 +108,7 @@ windows such as the mini command line invoked with
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 Click To Focus just without having to actually click.
+Think as Click to focus just without having to actually click.
@@ -119,10 +119,10 @@ follows mouse.
-Focus Follows Mouse - Mouse Precedence
+Focus follows mouse (mouse precedence)
-This is mostly the same as Focus Follows Mouse.
+This is mostly the same as Focus follows mouse.
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.
@@ -132,7 +132,7 @@ Choose this, if you want a hover controlled focus.
-Focus Under Mouse
+Focus under mouse
The window that happens to be under the mouse pointer becomes active. If
@@ -145,9 +145,9 @@ not receive the focus, you must move the mouse over them to type.
-Focus Strictly Under Mouse
+Focus strictly under mouse
-Similar to Focus Under Mouse, but even more
+Similar to Focus under mouse, but even more
strict with its interpretation. Only the window under the mouse pointer is
active. If the mouse pointer is not over a window, no window has focus.
New windows such as the mini command line invoked with
@@ -159,8 +159,8 @@ you must move the mouse over them to type.
-Note that Focus Under Mouse and
-Focus Strictly Under Mouse prevent certain
+Note that Focus under mouse and
+Focus strictly under mouse prevent certain
features, such as Focus stealing prevention and the
&Alt;	
walk-through-windows dialog, from working properly.
@@ -169,7 +169,7 @@ walk-through-windows dialog, from working properly.
-Focus stealing prevention level
+Focus stealing prevention
This option specifies how much KWin will try to prevent unwanted focus
stealing caused by unexpected activation of new windows.
@@ -220,7 +220,7 @@ is enabled and raise on hover is not available.
With a hover to focus policy you can alternatively use auto raise.
-By placing a mark in front of Raise on hover, delayed by, &kde; can
+By placing a mark in front of Raise on hover, delayed by, &kwin; can
bring a window to the front if the mouse is over that window for a
specified period of time. You can determine the delay for this option by using the spin box control.
@@ -256,7 +256,7 @@ clicked on their titlebars.
-Titlebar double-click
+Double-click
In this drop down box you can select either
@@ -266,7 +266,7 @@ In this drop down box you can select either
-Selecting Maximize causes &kde; to maximize the
+Selecting Maximize causes &kwin; to maximize the
window whenever you doubleclick on the titlebar. You can further
choose to maximize windows only horizontally or only
vertically.
@@ -276,15 +276,15 @@ reduced to simply the titlebar. Double clicking on the titlebar again,
restores the window to its normal size.
-Similar options are available for Wheel event.
+Similar options are available for Mouse wheel.
You can have windows automatically unshade when you simply place the
-mouse over their shaded titlebar. Just check the Enable
-hover check box in the Advanced tab of
+mouse over their shaded titlebar. Just check the Window
+unshading check box in the Advanced tab of
this module. This is a great way to reclaim desktop space when you are
cutting and pasting between a lot of windows, for example.
@@ -293,7 +293,7 @@ cutting and pasting between a lot of windows, for example.
-Titlebar & Frame
+Titlebar and Frame Actions
This section allows you to determine what happens when you single click
@@ -329,7 +329,7 @@ window out of the way.
-Toggle Raise & Lower
+Toggle raise and lower
This will raise windows which are not on top, and lower windows which
@@ -343,7 +343,7 @@ Minimize, Shade, Close
-->
-Nothing
+Do nothing
Just like it says. Nothing happens.
@@ -352,7 +352,7 @@ Just like it says. Nothing happens.
-Operations Menu
+Show actions menu
Will bring up a small submenu, where you can choose window related
@@ -365,7 +365,7 @@ commands (&ie; Maximize, Minimize, Close, &etc;).
-Maximize Button
+Maximize Button Actions
This section allows you to determine the behavior of the three mouse buttons
onto the maximize button. You have the choice between vertical only, horizontal
@@ -393,7 +393,7 @@ Your choices are as follows:
-Activate, Raise & Pass Click
+Activate, raise and pass click
This makes the clicked window active, raises it to the top of the
@@ -403,7 +403,7 @@ display, and passes a mouse click to the application within the window.
-Activate & Pass Click
+Activate and pass click
This makes the clicked window active and passes a mouse click to the
@@ -423,7 +423,7 @@ passed on to the application within the window.
-Activate & Raise
+Activate and raise
This makes the clicked window active and raises the window to the top of
@@ -432,14 +432,45 @@ the window.
+
-
+
+Your choices for Mouse wheel are as follows:
+
+
+
+Scroll
+
+
+Just scrolls the content within the window.
+
+
+
+
+
+Activate and scroll
+
+
+This makes the clicked window active and scrolls the content.
+
+
+
+
+
+Activate, raise and scroll
+
+
+This makes the clicked window active, raises the window to the top of
+the display, and scrolls the content.
+
+
+
-Inner Window, Titlebar & Frame
+Inner Window, Titlebar and Frame
This bottom section, allows you to configure additional actions, when
@@ -504,7 +535,7 @@ Allows you to change the size of the selected window.
-Toggle Raise & Lower
+Toggle raise and lower
This will raise windows which are not on top, and lower windows which
@@ -539,17 +570,18 @@ Nothing
-Moving
+Movement
-
-Windows
The options here determine how windows appear on screen when you
are moving them.
+
+Window geometry
+
-Display window geometry when moving or resizing
+Display when moving or resizing
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
@@ -570,7 +602,7 @@ when moved near.
-Border snap zone:
+Screen edge snap zone:
Here you can set the snap zone for screen borders. Moving a
@@ -601,7 +633,7 @@ to the center of the screen when moved near it.
-Snap windows only when overlapping
+Snap windows: Only when overlapping
If checked, windows will not snap together if they are only near
@@ -623,10 +655,10 @@ tuning to the window behavior.
-Shading
+Window unshading
-Enable hover
+On titlebar hover after
If this option is enabled, a shaded window will un-shade automatically
@@ -640,7 +672,7 @@ the spinbox to configure the delay un-shading.
-Placement
+Window placement
The placement policy determines where a new window will appear
on the desktop. Minimal Overlapping will try to achieve a minimum
overlap of windows, Cascaded will cascade the
@@ -648,7 +680,9 @@ windows, and Random will use a random
position. Centered will open all new windows in
the center of the screen, and In Top-Left Corner will
open all windows with their top left corner in the top left corner of
-the screen.
+the screen. Check the Allow KDE apps to remember the positions of
+their own windows item to keep the data on the &plasma; windows
+positions.