This repository has no description
Switch branches/tags
Clone or download
l10n daemon script
l10n daemon script SVN_SILENT made messages (.desktop file) - always resolve ours
In case of conflict in i18n, keep the version of the branch "ours"
To resolve a particular conflict, "git checkout --ours path/to/file.desktop"
Latest commit 8d005ca Nov 20, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
autotests [autotests] Hopefully stabilise TestShellClient Nov 17, 2018
cmake/modules Remove unused FindQt5PlatformSupport.cmake Nov 4, 2018
colorcorrection [colorcorrection] Make GammaRamp non-copyable Oct 7, 2018
data Remove Qt module declarations in includes Jun 5, 2018
decorations [decorations] Emit DecorationSettings::fontChanged signal Nov 15, 2018
doc [KCMs] move GHNS buttons to the normal location Oct 31, 2018
effects SVN_SILENT made messages (.desktop file) - always resolve ours Nov 20, 2018
helpers Merge branch 'Plasma/5.14' Nov 16, 2018
kcmkwin [effects] Move Fade, Glide, and Scale effect into exclusive group Nov 15, 2018
kconf_update [effects/scale] Port to JavaScript Oct 29, 2018
libinput libinput/connection: Don't hardcode seat0 anymore Apr 22, 2018
libkwineffects [scripting] Introduce complete function Nov 17, 2018
packageplugins SVN_SILENT made messages (.desktop file) - always resolve ours Nov 1, 2018
platformsupport Request a high-priority EGL contexts Mar 29, 2018
plugins Add output orientation size helper Nov 14, 2018
qml Use consistent size icon in OSD Oct 26, 2018
scripting [scripting] Introduce complete function Nov 17, 2018
scripts SVN_SILENT made messages (.desktop file) - always resolve ours Oct 31, 2018
shaders [libkwinglutils] Cleanup Shader API: removal of ShaderType Jan 26, 2016
tabbox [TabBox] Fix Arrow Key / Keyboard Events in QML Alt+Tab Skins Nov 7, 2018
tests Use locked cursor position hint Jul 27, 2018
.arcconfig Adding .arcconfig Mar 15, 2016
.arclint Add .arclint Oct 2, 2018
16-apps-kwin.png Fix installing of icons Jun 2, 2014
32-apps-kwin.png Fix installing of icons Jun 2, 2014
48-apps-kwin.png Fix installing of icons Jun 2, 2014
CMakeLists.txt Explicitly link and disable kcrash on kwin_wayland Nov 12, 2018
COMPLIANCE Fix typo in COMPLIANCE file. Jun 21, 2014
CONFIGURING Merging from old trunk: Apr 29, 2007
COPYING Put licence files on each repo, removing from root. Mar 26, 2014
COPYING.DOC Put licence files on each repo, removing from root. Mar 26, 2014
ExtraDesktop.sh Add ExtraDestkop.sh files Jul 12, 2011
HACKING HACKING moves to community.kde.org Feb 19, 2011
KWinDBusInterfaceConfig.cmake.in Add path to kwin_wayland binary to KWin's installed CMakeConfig Nov 19, 2015
Mainpage.dox Apidocs mainpage work. Just got Plasma and Solid to do here. Jul 24, 2007
Messages.sh Fix untranslatable strings in debug_console.ui shortcutdialog.ui Sep 17, 2018
README Add a link to the techbase KWin page, which should be where all other… Nov 5, 2008
TESTING.md Add a TESTING.md document describing how to run the unit test suite Nov 9, 2018
abstract_client.cpp [wayland] add enter/leave virtual desktop API Nov 14, 2018
abstract_client.h [wayland] add enter/leave virtual desktop API Nov 14, 2018
abstract_opengl_context_attribute_builder.cpp Request a high-priority EGL contexts Mar 29, 2018
abstract_opengl_context_attribute_builder.h Request a high-priority EGL contexts Mar 29, 2018
abstract_output.cpp Add output orientation size helper Nov 14, 2018
abstract_output.h Add output orientation size helper Nov 14, 2018
activation.cpp Drop no longer needed cast to Client in TabGroup related code May 20, 2018
activities.cpp Revert "Remove saving and loading (and client matching by) WM_COMMAND." Jun 23, 2016
activities.h [autotests/integration] Add a first test case for activities Aug 12, 2016
appmenu.cpp Don't try to open application menu when client doesn't have one Apr 23, 2018
appmenu.h Fix minor EBN issues Aug 29, 2018
atoms.cpp Restore global menu support Jan 11, 2017
atoms.h Restore global menu support Jan 11, 2017
client.cpp Support starting the killer_helper from build dir Nov 9, 2018
client.h Define ShellClient debug output Sep 17, 2018
client_machine.cpp Fix heap-use-after-free use in resolving ClientMachine Oct 1, 2015
client_machine.h Improved resolving whether a window is on local machine Jan 21, 2013
composite.cpp Don't detach list of damaged windows when sending 'done' events Jul 2, 2018
composite.h Drop the explicit fallback to XRender Oct 19, 2017
config-kwin.h.cmake Require libinput and udev Feb 4, 2018
cursor.cpp Set specific edge cursor shape when resizing Jun 11, 2018
cursor.h Set specific edge cursor shape when resizing Jun 11, 2018
dbusinterface.cpp [wayland] Use the new plasma virtual desktop protocol Nov 1, 2018
dbusinterface.h [wayland] Use the new plasma virtual desktop protocol Nov 1, 2018
debug_console.cpp i18n: Fix untranslatable table row "Delta" Sep 17, 2018
debug_console.h Require libinput and udev Feb 4, 2018
debug_console.ui fixuifiles Sep 18, 2018
deleted.cpp Don't cache value of popupWindow property in EffectWindow Nov 12, 2018
deleted.h Don't cache value of popupWindow property in EffectWindow Nov 12, 2018
effectloader.cpp Introduce an EffectsHandler::animationsSupported -> bool Aug 15, 2016
effectloader.h Ensure that EffectsHandlerImpl::slotClientShown is only invoked once … Aug 3, 2016
effects.cpp [wayland] add enter/leave virtual desktop API Nov 14, 2018
effects.h [wayland] add enter/leave virtual desktop API Nov 14, 2018
egl_context_attribute_builder.cpp Request a high-priority EGL contexts Mar 29, 2018
egl_context_attribute_builder.h [qpa] Use the new OpenGLContextAttributeBuilder to create Qt's OpenGL… Jul 17, 2017
events.cpp Create a dedicated X11Filter for Client sync events and move it to X1… Oct 19, 2017
fixqopengl.h Fix the build on armhf/aarch64 Mar 6, 2018
focuschain.cpp Use explicit Chain type in the focus chain Jul 30, 2018
focuschain.h Use explicit Chain type in the focus chain Jul 30, 2018
geometry.cpp Fix minor EBN issues Aug 29, 2018
geometrytip.cpp Port to CMake AUTOMOC Feb 1, 2016
geometrytip.h Use Xcb::GeometryHints instead of XGetWMNormalHints Jan 27, 2015
gestures.cpp Fix build with clang and GCC6 Mar 29, 2017
gestures.h Add support for screenedge touchscreen events through XInput 2.2 Mar 27, 2017
globalshortcuts.cpp Don't try to filter null key combinations Apr 24, 2018
globalshortcuts.h Drop unused private field GlobalShortcut::m_axis Aug 19, 2017
group.cpp From 22% of cpu in hasTransientInternal to 0.2x% Jan 22, 2018
group.h Improve updating user timestamp Jun 3, 2014
idle_inhibition.cpp Fix possible heap-use-after-free in idle inhibition handling Dec 3, 2017
idle_inhibition.h Fix possible heap-use-after-free in idle inhibition handling Dec 3, 2017
input.cpp Disable modifier window actions if global shortcuts are disabled Oct 14, 2018
input.h Remove breaking pointer constraints functionality Sep 12, 2018
input_event.cpp Pass SwitchEvent from LibInput through KWin and add to DebugConsole Jan 9, 2018
input_event.h Pass SwitchEvent from LibInput through KWin and add to DebugConsole Jan 9, 2018
input_event_spy.cpp Pass SwitchEvent from LibInput through KWin and add to DebugConsole Jan 9, 2018
input_event_spy.h Pass SwitchEvent from LibInput through KWin and add to DebugConsole Jan 9, 2018
keyboard_input.cpp Support enabling numlock on startup Nov 1, 2018
keyboard_input.h Split KWin::Xkb into a dedicated .h and .cpp Feb 15, 2017
keyboard_layout.cpp Fix warning Apr 6, 2018
keyboard_layout.h Introduce support for keyboard layout switching policies Apr 22, 2017
keyboard_layout_switching.cpp Use end() instead of constEnd() for where we compare to an iterator Apr 22, 2017
keyboard_layout_switching.h Add support for keyboard layout switching policy "winclass" Apr 22, 2017
keyboard_repeat.cpp Split Keyboard Repeat handling into a dedicated InputEventSpy Jan 27, 2017
keyboard_repeat.h Split Keyboard Repeat handling into a dedicated InputEventSpy Jan 27, 2017
killwindow.cpp Use OnScreenNotification in kill window Dec 21, 2016
killwindow.h Support interactive window selection through the Platform Nov 17, 2016
kwin.kcfg Drop OpenGL based color correction from KWin Nov 22, 2016
kwin.notifyrc SVN_SILENT made messages (.desktop file) - always resolve ours Sep 8, 2018
kwinbindings.cpp Expose more default window management shortcuts Mar 16, 2018
lanczosfilter.cpp Raise minimum required Mesa version to 10.0 Jul 6, 2017
lanczosfilter.h Move SceneOpenGL into a dedicated plugin Sep 30, 2017
layers.cpp Keep Deleted transients above old parents Oct 16, 2018
logind.cpp logind: Add a function that detects the logind seat. Jan 5, 2018
logind.h logind: Add a function that detects the logind seat. Jan 5, 2018
main.cpp Remove Qt module declarations in includes Jun 5, 2018
main.h Drop OperationModeX11AndWayland and introduce OperationModeWaylandOnl… Sep 30, 2017
main_wayland.cpp Explicitly link and disable kcrash on kwin_wayland Nov 12, 2018
main_wayland.h Ensure Workspace is only started once in Wayland-only mode Oct 1, 2017
main_x11.cpp Load QtQuick settings Nov 1, 2017
main_x11.h Move everything KCrash related from Application to ApplicationX11 May 9, 2016
manage.cpp Re-evaluate the window rules when the window class of a Client changes Nov 7, 2018
modifier_only_shortcuts.cpp Track the actual pressed keys in ModifierOnlyShortcuts Feb 23, 2017
modifier_only_shortcuts.h Track the actual pressed keys in ModifierOnlyShortcuts Feb 23, 2017
moving_client_x11_filter.cpp Move X11 movingClient handling into a dedicated X11EventFilter Sep 1, 2017
moving_client_x11_filter.h Move X11 movingClient handling into a dedicated X11EventFilter Sep 1, 2017
netinfo.cpp Revert "Revert "Add "SkipSwitcher" to API"" May 24, 2018
netinfo.h Create a dedicated X11EventFilter for the events used by RootInfo Sep 30, 2017
onscreennotification.cpp Drop invalid .moc file inclusion Mar 4, 2018
onscreennotification.h Add support for skip close animation to OnScreenMessage Jan 25, 2017
options.cpp Try all supported Compositor Types of the current Platform Oct 19, 2017
options.h Move XRandR event filter into XRandRScreens Sep 12, 2017
org.freedesktop.ScreenSaver.xml Add a copy of org.freedesktop.ScreenSaver.xml for KWin Mar 24, 2014
org.kde.KWin.VirtualDesktopManager.xml [wayland] Use the new plasma virtual desktop protocol Nov 1, 2018
org.kde.KWin.xml Add a method to dbus interface to query information about a window Feb 25, 2018
org.kde.kappmenu.xml Restore global menu support Jan 11, 2017
org.kde.kwin.ColorCorrect.xml [colorcorrection] Night Color - blue light filter at nighttime Dec 11, 2017
org.kde.kwin.Compositing.xml [kcmkwin/compositing] Hide config options which don't make sense if C… Sep 13, 2016
org.kde.kwin.Effects.xml [kwin] Add a new EffectLoader Mar 28, 2014
org.kde.kwin.OrientationSensor.xml Add DBus interface to OrientationSensor and a persistent configuration Dec 26, 2017
orientation_sensor.cpp Add DBus interface to OrientationSensor and a persistent configuration Dec 26, 2017
orientation_sensor.h Add DBus interface to OrientationSensor and a persistent configuration Dec 26, 2017
osd.cpp Add support for skip close animation to OnScreenMessage Jan 25, 2017
osd.h Add support for skip close animation to OnScreenMessage Jan 25, 2017
outline.cpp Move NonComposited Outline into the X11 standalone platform Sep 1, 2017
outline.h Move NonComposited Outline into the X11 standalone platform Sep 1, 2017
outputscreens.cpp Move output refresh rate getter into AbstractOutput Nov 14, 2018
outputscreens.h Move output refresh rate getter into AbstractOutput Nov 14, 2018
overlaywindow.cpp Move the X11 specific OverlayWindow into the platform/x11 Aug 12, 2017
overlaywindow.h Move the X11 specific OverlayWindow into the platform/x11 Aug 12, 2017
placement.cpp [wayland] Set better placement for XDG Toplevels Oct 23, 2018
placement.h Move implementation of Client::packTo to AbstractClient Oct 26, 2015
platform.cpp Remove unused check Oct 25, 2018
platform.h [colorcorrection] Set gamma through Output class Aug 31, 2018
pointer_input.cpp Remove breaking pointer constraints functionality Sep 12, 2018
pointer_input.h Remove breaking pointer constraints functionality Sep 12, 2018
popup_input_filter.cpp Cancel popup if the user clicked window decoration of parent window Apr 11, 2017
popup_input_filter.h Initial support for popup window handling Apr 7, 2017
resources.qrc [libkwinglutils] Cleanup Shader API: removal of ShaderType Jan 26, 2016
rootinfo_filter.cpp Create a dedicated X11EventFilter for the events used by RootInfo Sep 30, 2017
rootinfo_filter.h Create a dedicated X11EventFilter for the events used by RootInfo Sep 30, 2017
rules.cpp Support starting the rules_dialog from build dir Nov 9, 2018
rules.h Merge branch 'Plasma/5.12' into Plasma/5.13 May 20, 2018
sc-apps-kwin.svgz Fix installing of icons Jun 2, 2014
scene.cpp Use qDeleteAll in destructor of Scene class Jul 1, 2018
scene.h Render GL Window decorations at the correct scale Nov 1, 2017
screenedge.cpp Fix minor EBN issues Aug 29, 2018
screenedge.h Move X11 specific event filtering for ScreenEdges into x11 standalone… Sep 1, 2017
screenlockerwatcher.cpp Delay query whether screenlocker is registered till WaylandServer is … Aug 16, 2016
screenlockerwatcher.h [autotests/integration] Add ScreenLockerWatcher to the Test::lockScre… Aug 16, 2016
screens.cpp Load Kwin's internal cursors for the highest resolution of attached m… Jun 23, 2018
screens.h Load Kwin's internal cursors for the highest resolution of attached m… Jun 23, 2018
settings.kcfgc Use KConfigXT in KWin::Options Feb 14, 2013
shadow.cpp [shadow] Rebuild quads after creation of shadow Sep 13, 2018
shadow.h Fix typo Aug 4, 2018
shell_client.cpp [wayland] WlShell cache the pre-maximised geometry before going fulls… Nov 16, 2018
shell_client.h [wayland] XdgPopup Positioning Oct 20, 2018
shortcutdialog.ui [kwin] Use ui-file for ShortcutDialog Feb 27, 2014
sm.cpp Avoid potential assert in SM saving Jun 27, 2018
sm.h Revert "Remove saving and loading (and client matching by) WM_COMMAND." Jun 23, 2016
tabgroup.cpp Port TabGroup from Client to AbstractClient May 20, 2018
tabgroup.h Move TabGroup functionality from Client to AbstractClient May 20, 2018
tabletmodemanager.cpp Remove remaining HAVE_INPUT ifdef sections Feb 10, 2018
tabletmodemanager.h Expose if the tablet mode switch is available Jan 25, 2018
thumbnailitem.cpp Fix minor EBN issues Aug 29, 2018
thumbnailitem.h ThumbnailItem operates on AbstractClient May 21, 2015
toplevel.cpp Render GL Window decorations at the correct scale Nov 1, 2017
toplevel.h [wayland] Move AbstractClient::desktops from QList to QVector Nov 7, 2018
touch_input.cpp Add workaround for touch input offset for decorated windows Jan 25, 2017
touch_input.h Pass LibInput::Device* through the event handlers May 30, 2016
udev.cpp udev: Only handle devices from the current seat Apr 5, 2018
udev.h udev: Add the ability to query the current framebuffer. Apr 5, 2018
unmanaged.cpp [wayland] Move AbstractClient::desktops from QList to QVector Nov 7, 2018
unmanaged.h [wayland] Move AbstractClient::desktops from QList to QVector Nov 7, 2018
useractions.cpp [wayland] add enter/leave virtual desktop API Nov 14, 2018
useractions.h [wayland] Use the new plasma virtual desktop protocol Nov 1, 2018
utils.cpp Drop unused functions from utils Sep 23, 2017
utils.h Small code style improvement Jun 14, 2018
virtual_terminal.cpp Fix build with future glibc (major/minor macros) Apr 20, 2016
virtual_terminal.h [wayland] Don't break if we try to vt-switch to vt we're on Jul 20, 2015
virtualdesktops.cpp [wayland] Use the new plasma virtual desktop protocol Nov 1, 2018
virtualdesktops.h [wayland] Use the new plasma virtual desktop protocol Nov 1, 2018
virtualdesktopsdbustypes.cpp [wayland] Use the new plasma virtual desktop protocol Nov 1, 2018
virtualdesktopsdbustypes.h [wayland] Use the new plasma virtual desktop protocol Nov 1, 2018
virtualkeyboard.cpp Add DBus protocol to virtual keyboard Oct 19, 2017
virtualkeyboard.h Fix minor EBN issues Aug 29, 2018
virtualkeyboard_dbus.cpp Add DBus protocol to virtual keyboard Oct 19, 2017
virtualkeyboard_dbus.h Add DBus protocol to virtual keyboard Oct 19, 2017
was_user_interaction_x11_filter.cpp Create a dedicated X11EventFilter for recognizing first user interaction Aug 19, 2017
was_user_interaction_x11_filter.h Create a dedicated X11EventFilter for recognizing first user interaction Aug 19, 2017
wayland_cursor_theme.cpp Load Kwin's internal cursors for the highest resolution of attached m… Jun 23, 2018
wayland_cursor_theme.h Set specific edge cursor shape when resizing Jun 11, 2018
wayland_server.cpp Add more debug output around starting the x clipboard syncer process Nov 8, 2018
wayland_server.h Remove potential endless loop from XClipboardSyncTest Nov 7, 2018
window_property_notify_x11_filter.cpp Clean up includes Aug 31, 2018
window_property_notify_x11_filter.h Add a dedicated X11EventFilter for forwarding property events to the … Sep 25, 2017
workspace.cpp [wayland] Use the new plasma virtual desktop protocol Nov 1, 2018
workspace.h [wayland] Use the new plasma virtual desktop protocol Nov 1, 2018
x11eventfilter.cpp Support multiple event types in X11EventFilter Nov 16, 2016
x11eventfilter.h Support multiple event types in X11EventFilter Nov 16, 2016
xcbutils.cpp Clean debug output Jul 20, 2015
xcbutils.h Fix minor EBN issues Aug 29, 2018
xkb.cpp Support enabling numlock on startup Nov 1, 2018
xkb.h Support enabling numlock on startup Nov 1, 2018
xkb_qt_mapping.h Support mapping QKeyEvent to xkb_keysym_t Sep 19, 2017

README

- A collection of various documents and links related to KWin is at http://techbase.kde.org/Projects/KWin .


- The mailing list for KWin is kwin@kde.org (https://mail.kde.org/mailman/listinfo/kwin).

- If you want to develop KWin, see file HACKING.

- If you want to check KWin's compliance with specifications, see file COMPLIANCE.

- File CONFIGURATION includes some details on configuring KWin.

- Below is some info for application developers about application interaction
  with the window manager, but it'd need some cleanup.








 This README is meant as an explanation of various window manager related
mechanisms that application developers need to be aware of. As some of these
concepts may be difficult to understand for people not having the required
background knowledge (since sometimes it's difficult even for people who
do have the knowledge), the mechanisms are first briefly explained, and
then an example of fixing the various problems is given.

 For comments, questions, suggestions and whatever use the kwin@kde.org
mailing list.


Table of contents:
==================

- Window relations
    - how to make the window manager know which windows belong together
- Focus stealing prevention
    - how to solve cases where focus stealing prevention doesn't work
      properly automatically



Window relations:
=================

(For now, this explanation of window relations is mainly meant for
focus stealing prevention. To be extended later.)

 All windows created by an application should be organized in a tree
with the root being the application's main window. Note that this is about
toplevel windows, not widgets inside the windows. For example, if you
have KWrite running, with a torn-off toolbar (i.e. a standalone toolbar),
a file save dialog open, and the file save dialog showing a dialog
for creating a directory, the window hiearchy should look like this:


             KWrite mainwindow
              /             \
             /               \
      file save dialog      torn-off toolbar
            \
             \
          create directory dialog

 Each subwindow (i.e. all except for the KWrite mainwindow) points to its
main window (which in turn may have another main window, as in the case
of the file save dialog). When the window manager knows these relations,
it can better arrange the windows (keeping subwindows above their
main windows, preventing activation of a main window of a modal dialog,
and similar). Failing to provide this information to the window manager
may have various results, for example having dialogs positioned below
the main window,

The window property used by subwindows to point to their mainwindows is
called WM_TRANSIENT_FOR. It can be seen by running
'xprop | grep WM_TRANSIENT_FOR' and clicking on a window. If the property
is not present, the window does not (claim to) have any mainwindow.
If the property is present, it's value is the window id of its main window;
window id of any window can be found out by running 'xwininfo'. A window
having WM_TRANSIENT_FOR poiting to another window is said to be transient
for that window.

 In some cases, the WM_TRANSIENT_FOR property may not point to any other
existing window, having value of 0, or pointing to the screen number
('xwininfo -root'). These special values mean that the window is transient
for all other windows in its window group. This should be used only
in rare cases, everytime a specific main window is known, WM_TRANSIENT_FOR
should be pointing to it instead of using one of these special values.
(The explanation why is beyond the scope of this document - just accept it
as a fact.)

 With Qt, the WM_TRANSIENT_FOR property is set by Qt automatically, based
on the toplevel widget's parent. If the toplevel widget is of a normal
type (i.e. not a dialog, toolbar, etc.), Qt doesn't set WM_TRANSIENT_FOR
on it. For special widgets, such as dialogs, WM_TRANSIENT_FOR is set
to point to the widget's parent, if it has a specific parent, otherwise
WM_TRANSIENT_FOR points to the root window.

 As already said above, WM_TRANSIENT_FOR poiting to the root window should
be usually avoided, so everytime the widget's main widget is known, the widget
should get it passed as a parent in its constructor.
(TODO KDialog etc. classes should not have a default argument for the parent
argument, and comments like 'just pass 0 as the parent' should go.)



Focus stealing prevention:
==========================

 Since KDE3.2 KWin has a feature called focus stealing prevention. As the name
suggests, it prevents unexpected changes of focus. With older versions of KWin,
if any application opened a new dialog, it became active, and
if the application's main window was on another virtual desktop, also
the virtual desktop was changed. This was annoying, and also sometimes led
to dialogs mistakenly being closed because they received keyboard input that
was meant for the previously active window.

 The basic principle of focus stealing prevention is that the window with most
recent user activity wins. Any window of an application will become active
when being shown only if this application was the most recently used one.
KWin itself, and some of the related kdecore classes should take care
of the common cases, so usually there's no need for any special handling
in applications. Qt/KDE applications, that is. Applications using other
toolkits should in most cases work fine too. If they don't support
the window property _NET_WM_USER_TIME, the window manager may fail to detect
the user timestamp properly, resulting either in other windows becoming active
while the user works with this application, or this application may sometimes
steal focus (this second case should be very rare though).

 There are also cases where KDE applications needs special handling. The two
most common cases are when windows relations are not setup properly to make
KWin realize that they belong to the same application, and when the user
activity is not represented by manipulating with the application windows
themselves.

 Also note that focus stealing prevention implemented in the window manager
can only help with focus stealing between different applications.
If an application itself suddenly pops up a dialog, KWin cannot do anything about
it, and its the application's job to handle this case.


Window relations:
-----------------

 The common case here is when a dialog is shown for an application, but this
dialog is not provided by the application itself, but by some other process.
For example, dialogs with warnings about accepted cookies are provided
by KCookieJar, instead of being shown by Konqueror. In the normal case,
from KWin's point of view the cookie dialog would be an attempt of another
application to show a dialog, and KWin wouldn't allow activation of this
window.

 The solution is to tell the window manager about the relation between
the Konqueror main window and the cookie dialog, by making the dialog
point to the mainwindow. Note that this is not special to focus stealing
prevention, subwindows such as dialogs, toolbars and similar should always
point to their mainwindow. See the section on window relations for full
description.

 The WM_TRANSIENT_FOR property that's set on dialogs to point to their
mainwindow should in the cookie dialog case point to the Konqueror window
for which it has been shown. This is solved in kcookiejar by including
the window id in the DCOP call. When the cookie dialog is shown, its
WM_TRANSIENT_FOR property is manually set using the XSetTransientForHint()
call (see kdelibs/kioslave/http/kcookiejar/kcookiewin.cpp). The arguments
to XSetTransientForHint() call are the X display (i.e. QX11Info::display()),
the window id on which the WM_TRANSIENT_FOR property is to be set
(i.e. use QWidget::winId()), and the window id of the mainwindow.


  Simple short HOWTO:
  
 To put it simply: Let's say you have a daemon application that has
DCOP call "showDialog( QString text )", and when this is called, it shows
a dialog with the given text. This won't work properly with focus stealing
prevention. The DCOP call should be changed to
"showDialog( QString text, long id )". The caller should pass something like
myMainWindow->winId() as the second argument. In the daemon, before
the dialog is shown, a call to XSetTransientHint() should be added:

 XSetTransientForHint( QX11Info::display(), dialog->winId(), id_of_mainwindow );
 
 That's it.

Non-standard user activity:
---------------------------

 The most common case in KDE will be DCOP calls. For example, KDesktop's DCOP
call "KDesktopIface popupExecuteCommand". Executing this DCOP call e.g.
from Konsole as 'dcop kdesktop KDesktopIface popupExecuteCommand" will lead
to showing the minicli, but the last user activity timestamp gained from events
sent by X server will be older than user activity timestamp of Konsole, and
would normally result in minicli not being active. Therefore, before showing
the minicli, kdesktop needs to call KApplication::updateUserTimestamp().

 However, this shouldn't be done with all DCOP calls. If a DCOP call is not
a result of direct user action, calling KApplication::updateUserTimestamp()
would lead to focus stealing. For example, let's assume for a moment
that KMail would use this DCOP call in case it detects the modem is not
connected, allowing to you to start KPPP or whatever tool you use. If KMail
would be configured to check mail every 10 minutes, this would lead to minicli
possibly suddenly showing up at every check. Basically, doing the above change
to kdesktop's minicli means that the popupExecuteCommand() DCOP call is only
for user scripting. (TODO write about focus transferring?)

 Simply said, KApplication::updateUserTimestamp() should be called only
as a result of user action. Unfortunately, I'm not aware of any universal
way how to handle this, so every case will have to be considered separately.