Sapphirus/window-controls-applet
1
0
Fork 0
Code Issues Releases 1 Activity

Update to README.md

Browse source
This commit is contained in:
Xavier Moffett 2023-09-11 08:20:07 -04:00
parent 03190ae2d8
commit 13a3fb74e6
1 changed files with 8 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
README.md
View file

@ -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+`).