2015-08-19 10:33:43 -07:00
|
|
|
*Wayland support in Enlightenment*
|
2014-03-18 02:11:28 -07:00
|
|
|
|
2015-08-19 10:33:43 -07:00
|
|
|
Running Enlightenment as a Wayland compositor is not considered "safe"
|
|
|
|
for everyday desktop use, though it is functional enough to test or
|
|
|
|
use in specialized environments.
|
|
|
|
A list of known issues can be found at the bottom of this file.
|
2014-03-18 02:11:28 -07:00
|
|
|
|
|
|
|
|
|
|
|
Requirements:
|
|
|
|
-------------
|
|
|
|
|
|
|
|
Aside from the normal requirements that Enlightenment needs, there are
|
2015-08-19 10:33:43 -07:00
|
|
|
a few things to note in order to get Enlightenment to build with
|
|
|
|
Wayland support.
|
2014-03-18 02:11:28 -07:00
|
|
|
|
|
|
|
Firstly, you MUST have EFL built with the following options:
|
|
|
|
|
|
|
|
--enable-drm
|
2016-09-21 13:05:27 -07:00
|
|
|
--enable-gl-drm (for hardware acceleration)
|
2014-03-18 02:11:28 -07:00
|
|
|
--enable-wayland
|
2014-08-22 07:28:50 -07:00
|
|
|
--enable-systemd
|
2016-08-18 22:51:51 -07:00
|
|
|
--enable-elput
|
2014-03-18 02:11:28 -07:00
|
|
|
|
2015-02-12 20:31:36 -08:00
|
|
|
Note that the drm engine will not be functional unless the target system
|
|
|
|
has libsystemd-login installed.
|
|
|
|
|
2014-03-18 02:11:28 -07:00
|
|
|
This Readme does not address the dependencies needed to enable Wayland
|
|
|
|
in EFL. If you require any information for that, please see:
|
|
|
|
|
|
|
|
https://phab.enlightenment.org/w/wayland/
|
|
|
|
|
|
|
|
If you would like support for EGL in Wayland, then also build EFL with:
|
|
|
|
|
|
|
|
--enable-egl
|
|
|
|
--with-opengl=es
|
|
|
|
|
|
|
|
The above options can be enabled for EFL without any adverse effects to
|
|
|
|
existing applications.
|
|
|
|
|
2014-08-22 07:28:50 -07:00
|
|
|
|
|
|
|
Compiling:
|
|
|
|
-------------
|
2014-03-18 02:11:28 -07:00
|
|
|
|
2015-08-10 08:00:25 -07:00
|
|
|
In order for Enlightenment to be compiled as Wayland compositor you will need to
|
2015-08-19 10:33:43 -07:00
|
|
|
pass an option to the configure stage of Enlightenment:
|
2014-03-18 02:11:28 -07:00
|
|
|
|
2017-11-07 08:30:19 -08:00
|
|
|
-Dwayland=true
|
2015-10-21 14:17:49 -07:00
|
|
|
|
2014-03-18 02:11:28 -07:00
|
|
|
At this stage, you should have EFL properly built, and Enlightenment
|
|
|
|
properly built. Let's move on to running it...
|
|
|
|
|
|
|
|
|
|
|
|
Usage:
|
|
|
|
-------------
|
|
|
|
|
|
|
|
Hopefully at this stage you have successfully built EFL and
|
2015-08-19 10:33:43 -07:00
|
|
|
Enlightenment in preparation for a Wayland-supported setup. Congratulations!!
|
|
|
|
Now, let's get it running...
|
2014-03-18 02:11:28 -07:00
|
|
|
|
2015-08-19 10:33:43 -07:00
|
|
|
Enlightenment, when compiled with Wayland support and started from a tty,
|
|
|
|
will automatically attempt to load the wl_drm output module and start
|
|
|
|
a Wayland session. Simply start as usual:
|
2014-03-18 02:11:28 -07:00
|
|
|
|
2016-05-16 02:09:12 -07:00
|
|
|
enlightenment_start
|
2014-03-18 02:11:28 -07:00
|
|
|
|
2015-08-19 10:33:43 -07:00
|
|
|
If you have a separate configuration profile that you would like to use,
|
|
|
|
you can tell Enlightenment to use that when you start it:
|
2014-03-18 02:11:28 -07:00
|
|
|
|
2016-09-21 05:07:15 -07:00
|
|
|
enlightenment_start -profile <my_profile>
|
2014-03-18 02:11:28 -07:00
|
|
|
|
2015-09-23 04:28:32 -07:00
|
|
|
To run a wayland session inside x11, export E_WL_FORCE=x11 before starting
|
|
|
|
enlightenment.
|
2014-03-18 02:11:28 -07:00
|
|
|
|
2015-08-19 10:33:43 -07:00
|
|
|
Known Issues
|
2014-03-18 02:11:28 -07:00
|
|
|
-------------
|
2015-08-19 10:33:43 -07:00
|
|
|
* Internal window (eg. filemanager), DnD is not currently functional
|
2016-05-06 11:05:33 -07:00
|
|
|
- Requires various improvements
|
|
|
|
* Restarting Enlightenment kills some applications
|
|
|
|
- Requires upstream external protocol support, XWayland improvements
|
2015-08-19 10:33:43 -07:00
|
|
|
* XWayland clients do not smoothly resize
|
|
|
|
- Requires upstream XWayland improvements
|
2016-07-13 09:06:45 -07:00
|
|
|
* There are not more than 4 keyboard layouts possible
|
|
|
|
- Requires libxkbcommon changes - https://github.com/xkbcommon/libxkbcommon/issues/37
|