From 13a3fb74e6e40436e67522285232fd994cb0d895 Mon Sep 17 00:00:00 2001 From: Xavier Date: Mon, 11 Sep 2023 08:20:07 -0400 Subject: [PATCH] Update to README.md --- README.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 2609072..d1668b3 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,14 @@ -# Window Button Applet # +# Window Button Applet -The Window Button Applet provides themable window controls for the Cinnamon Desktop Environment. Multi-instance support enables multi-monitor support, as well as support for multiple workspaces. +The Window Button Applet provides themable window controls for the Cinnamon Desktop Environment. -A complete rewrite and rework of the predecessing applet was undertaken, which enables multiple instances across panels on multiple displays. Present version 1.20 is compatible with Cinnamon 5 (including 5.4) and later. +A complete rewrite and rework of the predecessing applet was undertaken, which enables multiple instances across panels on multiple displays. At present, version 1.1.2 is compatible with Cinnamon 5.4 and later. + +## Known Issues -## KNOWN ISSUES ## +**PREFACE**: These issues are a result of implementation semantics, or regressions rather, with Cinnamon's Window Manager called Muffin (which is a fork of Mutter from the Gnome Desktop). From the debugging which has been done so far, there doesn't appear to be a problem with the present applet code. Feel free to correct or challenge this assertion. -**PREFACE:** These issues are a result of implementation semantics or regressions with Cinnamon's Window Manager called Muffin (which is a fork of Mutter from the Gnome Desktop). From the debugging which has been done so far, there doesn't appear to be a problem with the present applet code. +- Muffin introduces a regression on the focus event signal (notify::focus). Swapping focus between windows on independent displays with identical attributes will fail to trigger this event; which thereby results in this applet failing to reappear for additional instances handling identical, duplicate windows after a change of focus (e.g. a duplicate, maximised window being unminimised). A workaround is to arbitrarily trigger the focus event by inputting SUPER to trigger the user menu or clicking vacant space on the desktop. An alternate workaround involves changing the Window focus mode under Windows->Behaviour in System Settings to an option other than "Click". +- Applying a new theme CSS through the applet requires Cinnamon to be restarted. (Ctrl+Alt+ESC). -- Muffin introduces a regression on the focus event signal (notify::focus). Swapping focus between windows with identical attributes will fail to trigger this event; which thusly results in this applet failing to reappear for additional instances handling identical, duplicate windows after a change of focus (e.g. a duplicate, maximised window being unminimised). Workaround is clicking the desktop on another display or inputting SUPER to trigger the user menu. -- Applying a new theme CSS through the applet requires the window manager to be reloaded (ctrl+alt+`).