Commit graph

52 commits

Author SHA1 Message Date
Yuri Chornoivan
354c0e350f Fix minor typos 2022-09-08 08:43:44 +03:00
Natalie Clarius
1598cecc8e doc/windowbehavior: improve help page for window behavior kcm
- add missing entries for focus delay and multiscreen behavior
- add missing entries for window placement modes maximized and under mouse
- add missing entries for mouse actions
- remove entry for removed "display window geometry when regeometrizing" option
- reword explanation for window raising
- extend explanations for window placement
- hint at screen edges kcm in movement section
- hint at window rules in advanced section
- add more keywords
- some small wording, typographical and formatting changes
2022-09-07 19:01:28 +00:00
Natalie Clarius
6b38b03724 Add new option for behavior when window on different desktop is activated
When a window that is on a different virtual desktop than the current one gets
activated, the current behavior is that the active virtual desktop will be switched
to the one the activated window is on. This may seem reasonable for a scenario where
the user explicitly intends to activate an existing window on a different desktop.
However, the following scenario is also (perhaps even more?) common: When an
application responds to a launch command by requesting to activate an existing
instance instead of opening a new one (such as Firefox or KDE System Settings), an
existing window on any desktop will get activated even when what the user had in
mind was opening a new window (on the desktop they are currently in). 

This means that opening an application, such as following a URL or accessing a
system setting, unexpectedly results in the user being teleported to a different
virtual desktop. This can be very irritating. The more expected behavior for these
users would be to have windows always open on the desktop where they are called
from. That's is what this commit adds as a new option.

BUG: 438375
FIXED-IN: 5.26
2022-08-31 18:57:21 +00:00
Jan Blackquill
f6005a28cd doc: modernise HACKING -> CONTRIBUTING guidelines and information 2021-08-31 22:10:58 +00:00
David Edmundson
e35ed5088a [rules] Allow setting WindowType to KDE specific window type OSD
An example use case is allowing a user to write rules to put firefox
Picture in picture windows above fullscreen users

CCBUG: 439573
2021-07-07 10:32:29 +00:00
Vlad Zahorodnii
811beb94e0 Remove Xrender backend
The Xrender backend was added at the time when OpenGL drivers were not
particularly stable. Nowadays though, it's a totally different situation.

The OpenGL render backend has been the default one for many years. It's
quite stable, and it allows implementing many advanced features that
other render backends don't.

Many features are not tested with it during the development cycle; the
only time when it is noticed is when changes in other parts of kwin break
the build in the xrender backend. Effectively, the xrender backend is
unmaintained nowadays.

Given that the xrender backend is effectively unmaintained and our focus
being shifted towards wayland, this change drops the xrender backend in
favor of the opengl backend.

Besides being de-facto unmaintained, another issue is that QtQuick does
not support and most likely will never support the Xrender API. This
poses a problem as we want thumbnail items to be natively integrated in
the qtquick scene graph.
2021-06-09 11:21:57 +03:00
Yuri Chornoivan
e209134e96 Fix some leftovers in the docbooks 2021-04-27 17:44:41 +03:00
Yuri Chornoivan
22ee512ba6 Add docs for virtual keyboard KCM 2021-04-27 17:09:41 +03:00
Yuri Chornoivan
60d12b91f2 Add touch screen KCM docs 2021-04-10 18:59:20 +03:00
Yuri Chornoivan
9667fc6493 Fix minor typo 2021-04-10 10:54:13 +03:00
Yuri Chornoivan
d1c3b2a261 Update window behavior KCM docs 2021-04-09 19:00:15 +03:00
Yuri Chornoivan
b0e2498762 Update screen edges KCM docs 2021-04-09 18:20:33 +03:00
Yuri Chornoivan
c8424f33f5 Update kwin effects KCM docs 2021-04-09 17:32:30 +03:00
Yuri Chornoivan
9ada617510 Update window decorations KCM docs 2021-04-09 17:14:27 +03:00
Yuri Chornoivan
340c8b5927 Update virtual desktops KCM docs 2021-04-09 16:08:40 +03:00
Laurent Montel
88b6076b2f GIT_SILENT: dont use deprecated cmake variable 2021-01-29 11:34:52 +01:00
Yuri Chornoivan
afcd2e031b Minor documentation formatting fixes 2021-01-28 17:47:15 +02:00
Peter Wilding
1f006e2184 Updated version to 5.21. Rewrote the whole article to be more descriptive. 2021-01-27 11:46:02 +00:00
Peter Wilding
5f05369c6d Rewrote Task Switcher help to describe all options and how they work in detail. 2021-01-27 11:46:02 +00:00
Noah Davis
f474686a58 Change CommandAllKey to Meta
Summary: Alt + Left Click to move windows has a tendency to conflict with creative workflow apps. While Alt can be changed to Meta in KWin's settings, Alt + Left Click shortcuts often cannot be customized in apps. Rather than making every user who runs into this problem change their settings, we should change our default settings to improve KWin's default usability. The fact that Alt + Left Click to move windows is older does not matter. We are trying to use Meta for global/shell shortcuts anyway.

BUG: 399375

Test Plan: The relevant parts of the relevant tests pass. kwin-testInternalWindow fails, but for unrelated reasons that have something to do with XWayland.
2020-05-22 22:39:08 -04:00
Nate Graham
04aff77f94 Remove the "Candy" category and fold its contents into "Appearance"
Summary:
The "Candy" category suffers from some problems:
- It does not need to exist; everything in it is purely appearance-related and could live in the existing "Appearance" category
- The name is inappropriate; "Eye Candy" would be better, but changing it to this has proven controversial in the past

Let's just remove the category and move everything in it into the "Appearance" category.

Test Plan:
Apply and compile
Open Desktop Effects KCM
See that the "Candy" category is no more and the "Appearance" category has more stuff in it

Reviewers: #kwin, #vdg, zzag, abetts

Reviewed By: #kwin, #vdg, zzag, abetts

Subscribers: abetts, zzag, kwin, kde-doc-english, GB_2

Tags: #kwin, #documentation

Differential Revision: https://phabricator.kde.org/D27658
2020-02-25 11:26:27 -07:00
Vlad Zahorodnii
c9c3c3ad65 Introduce coding-conventions.md
Summary:
Hopefully, the new document makes it clear when one can use QRect::right()
and QRect::bottom().

Reviewers: #kwin, davidedmundson

Reviewed By: #kwin, davidedmundson

Subscribers: davidedmundson, kwin

Tags: #kwin

Differential Revision: https://phabricator.kde.org/D27060
2020-02-03 12:45:47 +02:00
Nate Graham
2dae153558 Improve comprehensibility and consistency of window placement mode names
Summary:
Right now a few of the window placement modes suffer one or more of the following problems:
- Inconsistency between the text shown in the Window Behavior and Window Rules KCMs
- Title does not indicate what it does
- Awkward wording
- Lack of unity in grammatical mood between the different modes

This patch fixes these issues by improving the strings and standardizing on the descriptive mood:
- Smart -> Minimal Overlapping
- Maximizing -> Maximized
- Cascade -> Cascaded
- Zero-Cornered -> In Top-Left Corner

Strings are also unified between the window behavior and window rules KCMs, and docbooks are adjusted accordingly.

Test Plan:
{F7279685, size=full}
{F7279694, size=full}

Reviewers: #kwin, #vdg, ndavis, filipf, zzag, romangg

Reviewed By: #kwin, #vdg, ndavis, filipf, romangg

Subscribers: gladhorn, alexeymin, IlyaBizyaev, broulik, hein, hpereiradacosta, GB_2, alexde, davidedmundson, romangg, cfeck, filipf, zzag, ndavis, kwin, kde-doc-english

Tags: #kwin, #documentation

Differential Revision: https://phabricator.kde.org/D23415
2019-09-19 10:34:39 -06:00
Frederik Gladhorn
b64e67ce7c Remove disabled TabGroup feature
Summary:
This has been commented out since 2014, I doubt it will come back.
This is a big amount of code, maintenance will be easier without it.

Reviewers: #kwin, zzag

Reviewed By: #kwin, zzag

Subscribers: romangg, graesslin, kwin

Tags: #kwin, #documentation

Differential Revision: https://phabricator.kde.org/D23069
2019-09-14 10:58:48 +02:00
Yuri Chornoivan
ac702ff2dc Update icon PNGs 2019-08-13 12:17:26 +03:00
Volker Krause
008143c9db Update URLs to use https
Summary: Largely done automatically using the tools from D19996.

Reviewers: yurchor, zzag

Reviewed By: yurchor, zzag

Subscribers: zzag, yurchor, kwin, kde-doc-english

Tags: #kwin, #documentation

Differential Revision: https://phabricator.kde.org/D20017
2019-03-25 19:26:23 +01:00
Nate Graham
9a59e3fb6c [KCMs] move GHNS buttons to the normal location
Summary:
All other KCMs have their {nav Get New [things]...} buttons in the bottom-right corner. This patch adjusts KWin's KCMs to adopt the same convention there too.

With this patch, all KCMs will have their GHNS buttons in the same location.

Closes T9954

Test Plan:
{F6375278}

{F6375277}

{F6375276}

{F6375275}

Reviewers: #kwin, #vdg, zzag

Reviewed By: #kwin, zzag

Subscribers: Codezela, kwin, kde-doc-english

Tags: #kwin, #documentation

Maniphest Tasks: T9954

Differential Revision: https://phabricator.kde.org/D16537
2018-10-31 07:29:22 -06:00
Burkhard Lück
13a3dbf9de Update kwindecoration docbook
update text + screenshots

Differential Revision: https://phabricator.kde.org/D11453
2018-03-20 04:44:03 +01:00
Burkhard Lück
48f65133a0 Update windowspecific (Window Rules) docbook
proofread + update
most screenshots are already updated
REVIEW:129007
2016-10-04 18:46:51 +02:00
Burkhard Lück
2ba66b3fc2 update missing screenshot for example thunderbird composer 2016-09-24 17:49:03 +02:00
Burkhard Lück
1e6e11ea7a update screenshots for kopete example 2016-09-24 10:35:07 +02:00
Ivan Čukić
bb89945d1b Restored the deleted file in order to fix the build 2016-09-24 09:49:50 +02:00
Burkhard Lück
cca023d3b9 update screenshots for example 'Suppress a Window from showing on Pager' KNotes 2016-09-23 21:41:41 +02:00
Burkhard Lück
817ab63c86 update screenshots for emacs example 'Full-screen Re-size Error' 2016-09-23 20:54:47 +02:00
Burkhard Lück
49dfe5dfbe update screenshots for thunderbird reminder example 2016-09-23 20:04:03 +02:00
Burkhard Lück
47387a140c update screenshots for thunderbird main + composer eample 2016-09-23 19:21:05 +02:00
Burkhard Lück
8699bbd8d9 update screenshot for example 'Force a Window to the Top' 2016-09-23 15:48:40 +02:00
Burkhard Lück
b2d450c299 update screenshots example 'Pin a Window to a Desktop and set other Attributes' and fix outdated link to Qt regexp documentation 2016-09-23 14:49:17 +02:00
Burkhard Lück
3fa83e445e update some screenshots, remove duplicate screenshot 2016-09-23 13:45:59 +02:00
Burkhard Lück
7dbad7bade Add docbook for kwineffects kcm
REVIEW:124341
2016-05-13 08:11:27 +02:00
Burkhard Lück
d32fbf54ca Update kwindecoration docbook to 5.6
options were splitted in two tabs
REVIEW:127653
2016-04-20 16:20:43 +02:00
Burkhard Lück
720d10cee8 Update kwintabbox kcm docbook to plasma 5
Note:
The diff is completely misleading, because the latest docbook in kde 4 has <date>2014-03-10</date> + <releaseinfo>&kde; 4.11</releaseinfo>
but kwin master in kf5 has <date>2010-10-28</date> + <date>2015-07-24</date> <releaseinfo>&kde; 4.5</releaseinfo>
The diff against the latest kde4 docbook version 4.11 has only 4 or 5 lines
REVIEW:124475
2015-07-28 09:49:29 +02:00
Burkhard Lück
25ca9df647 Remove obsolete kwincompositing kcm docbook
Remove the outdated docbook
This KCM is now in Display and Monitor -> Compositor
Compositor is not for Joe User, only for workarounds with broken drivers as confirmed by Martin
X-DocPath now points to userbase
REVIEW:124436
2015-07-25 09:06:43 +02:00
Yuri Chornoivan
999b01ec27 Fix typo 2015-07-21 19:05:44 +03:00
Yuri Chornoivan
bff41058c5 Fix typos 2015-07-21 18:53:58 +03:00
Burkhard Lück
4730812df8 Review Request 124352: Update kwinsceenedges docbook to Plasma 5
REVIEW:124352
2015-07-21 12:02:11 +02:00
Burkhard Lück
7aebca7461 Update kwindecoration kcm docbook to Plama 5
REVIEW:124351
2015-07-21 11:56:23 +02:00
Burkhard Lück
9aa436f4dd Update windowbehaviour kcm docbook to Plasma 5
REVIEW:124348
2015-07-21 11:41:38 +02:00
Burkhard Lück
944a6c0c47 check, update + bump version 2015-04-10 18:06:31 +02:00
Jonathan Riddell
9ca75417e0 use ecm_optional_add_subdirectory instead of add_subdirectory for docs, the translations may be incomplete 2015-02-19 17:06:15 +01:00