gnome-shell/subprojects/shew/README.md
Florian Müllner 6baf490aab shew: Add small library for dealing with external windows
In order to support OpenExtensionPrefs()'s parentWindow parameter,
we will need the ability to make a window transient to an external
window identified by a string handle.

This takes the corresponding code from xdg-desktop-portal-gtk and
brings it into an introspectable form, likewise the counterpart in
libportal to export a string handle for a GtkWindow.

https://gitlab.gnome.org/GNOME/gnome-shell/-/merge_requests/1087
2020-03-26 18:32:30 +01:00

25 lines
838 B
Markdown

# Shell External Windows
Shew is a small support library for dealing with external windows.
The code for creating external windows from a handle that are suitable for
setting a transient parent was copied from [xdg-desktop-portal-gtk].
The code for exporting a handle for a GtkWindow is losely based on code
from GTK/[libportal].
## Stability
This is an unstable library with no API or ABI guarantees, and no
soname versioning.
It is not recommended to use it outside the gnome-shell project, and
may only be used as a subproject.
## License
shew is distributed under the terms of the GNU Lesser General Public License
version 2.1 or later. See the [COPYING][license] file for details.
[xdg-desktop-portal-gtk]: https://github.com/flatpak/xdg-desktop-portal-gtk
[libportal]: https://github.com/flatpak/libportal
[license]: COPYING