f8a46b548a
This reverts commit bad48ea8155d94af7b62bf4ff42d747f27c7464c. Commit 666e5f1f9 (keybindings: Port to Clutter, 2013-10-03) changed the Meta.KeyEventHandler callback so that it would take a Clutter.KeyEvent instead of an XIDeviceEvent. This removed the need for the "(type gpointer)" annotation, since Clutter works with introspection. The gpointer annotation caused GJS to simply skip over the callback argument. Since this was only the second-last argument, reintroducing it required updating gnome-shell JS code that used the last 'binding' argument. This was likely inconvenient at the time, since work was happening in a separate 'wayland' branch, and compatibility with the X11-only branch had to be kept. So shortly after, the gpointer annotation was reintroduced with commit bad48ea81 (introspection: Make MetaKeyHandlerFunc compatible with master, 2013-12-09), unbreaking the gnome-shell JS code. But now that the 'wayland' branch has long been merged, we can fix this properly by removing the gpointer annotation and updating the JS handlers instead. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/4079>
Mutter
Mutter is a Wayland display server and X11 window manager and compositor library.
When used as a Wayland display server, it runs on top of KMS and libinput. It implements the compositor side of the Wayland core protocol as well as various protocol extensions. It also has functionality related to running X11 applications using Xwayland.
When used on top of Xorg it acts as a X11 window manager and compositing manager.
It contains functionality related to, among other things, window management, window compositing, focus tracking, workspace management, keybindings and monitor configuration.
Internally it uses a fork of Cogl, a hardware acceleration abstraction library used to simplify usage of OpenGL pipelines, as well as a fork of Clutter, a scene graph and user interface toolkit.
Mutter is used by, for example, GNOME Shell, the GNOME core user interface, and by Gala, elementary OS's window manager. It can also be run standalone, using the command "mutter", but just running plain mutter is only intended for debugging purposes.
Contributing
To contribute, open merge requests at https://gitlab.gnome.org/GNOME/mutter.
It can be useful to first look at the GNOME Handbook and the documentation and API references below first.
Documentation
- Coding style and conventions
- Git conventions
- Code overview
- Building and Running
- Debugging
- Monitor configuration
API Reference
- Meta: https://mutter.gnome.org/meta/
- Clutter: https://mutter.gnome.org/clutter/
- Cogl: https://mutter.gnome.org/cogl/
- Mtk: https://mutter.gnome.org/mtk/
Meetings
There are recurring meetings to discuss development of GNOME Shell, mutter and related components.
License
Mutter is distributed under the terms of the GNU General Public License, version 2 or later. See the COPYING file for detalis.