2014-03-18 02:11:28 -07:00
|
|
|
Wayland support in Enlightenment 0.19.0
|
|
|
|
|
|
|
|
Caution: Support for running Enlightenment in a Wayland-Only
|
|
|
|
configuration is considered Highly Experimental !! Use at your own
|
|
|
|
risk !! We are not responsible if it nukes your files, burns up your cpu,
|
|
|
|
kills your cat, sells your house, divorces you, or otherwise messes
|
|
|
|
Anything up !
|
|
|
|
|
|
|
|
Use at your own risk !! You have been warned !!
|
|
|
|
|
|
|
|
|
|
|
|
Requirements:
|
|
|
|
-------------
|
|
|
|
|
|
|
|
Aside from the normal requirements that Enlightenment needs, there are
|
|
|
|
a few things to note in order to get Enlightenment to build without
|
|
|
|
X11 support.
|
|
|
|
|
|
|
|
Firstly, you MUST have EFL built with the following options:
|
|
|
|
|
|
|
|
--enable-drm
|
|
|
|
--enable-wayland
|
2014-08-22 07:28:50 -07:00
|
|
|
--enable-systemd
|
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
|
|
|
Wayland-Only:
|
|
|
|
-------------
|
|
|
|
|
|
|
|
If you wish to test out the Highly Experimental standalone
|
2014-11-03 10:45:30 -08:00
|
|
|
Wayland-Only (no X11) compositor, then read below about how to compile
|
|
|
|
support for a wayland-only Enlightenment.
|
2014-08-22 07:28:50 -07:00
|
|
|
|
|
|
|
Compiling:
|
|
|
|
-------------
|
2014-03-18 02:11:28 -07:00
|
|
|
|
|
|
|
Next, you will need to adjust the options that you pass to
|
|
|
|
Enlightenment during the compile phase.
|
|
|
|
|
|
|
|
Please note, we recommend installing This version of Enlightenment into it's
|
|
|
|
own separate prefix so that you can still safely fallback to the X11 version.
|
|
|
|
|
|
|
|
This can be done by passing:
|
|
|
|
|
|
|
|
--prefix=<some_other_install_location>
|
|
|
|
|
|
|
|
Now, on to the magic bits ;)
|
|
|
|
|
|
|
|
In order for Enlightenment to be compiled without X11, using Wayland
|
|
|
|
only, you will need to pass a few more options to the configure stage
|
|
|
|
of Enlightenment:
|
|
|
|
|
|
|
|
--enable-wayland-clients
|
|
|
|
--enable-wl-drm
|
|
|
|
|
2014-08-22 07:28:50 -07:00
|
|
|
If you wish to test the experimental Wayland-Only compositor, then
|
|
|
|
also pass to configure:
|
|
|
|
|
|
|
|
--enable-wayland-only
|
|
|
|
|
2014-03-18 02:11:28 -07:00
|
|
|
Since this is all still a work-in-progress, there are a few
|
|
|
|
Enlightenment modules that have not been "fixed" to work without X11
|
2014-08-22 07:28:50 -07:00
|
|
|
yet. Those will need to be disabled if you enabled the wayland-only
|
|
|
|
option:
|
2014-03-18 02:11:28 -07:00
|
|
|
|
|
|
|
--disable-shot
|
|
|
|
--disable-xkbswitch
|
|
|
|
--disable-conf-randr
|
2014-03-27 00:37:39 -07:00
|
|
|
--disable-wl-x11
|
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
|
|
|
|
Enlightenment in preparation for a Wayland-only setup. Congratulations
|
|
|
|
!! Now, let's get it running...
|
|
|
|
|
|
|
|
The following steps assume you are currently at a Virtual Terminal
|
|
|
|
without anything else running (ie: no other window managers, X11, etc).
|
|
|
|
|
|
|
|
In order for Enlightenment to function without X11, we need to setup
|
|
|
|
the environment. In your current tty, do:
|
|
|
|
|
|
|
|
export E_WL_FORCE=drm
|
2014-08-22 07:28:50 -07:00
|
|
|
export ELM_DISPLAY=wl
|
|
|
|
export ELM_ACCEL=opengl (or 'none' for SHM engine)
|
2014-03-18 02:11:28 -07:00
|
|
|
|
|
|
|
This will make sure that Enlightenment renders using DRM, and any
|
|
|
|
Elementary applications use a Wayland engine.
|
|
|
|
|
|
|
|
At this point, you should just be able 'cd' to the Enlightenment
|
|
|
|
prefix where you installed, and issue:
|
|
|
|
|
|
|
|
./enlightenment_start
|
|
|
|
|
|
|
|
Please Note: It is suggested that you create a separate configuration
|
|
|
|
profile with only a Minimum of modules loaded. Due to the experimental
|
|
|
|
(and ongoing) status of Wayland-Only support in Enlightenment, Many
|
|
|
|
modules May Not Work. Very few have actually been tested yet !!
|
|
|
|
|
|
|
|
If you have a separate configuration profile (as suggested) that you
|
|
|
|
would like to use, you can tell Enlightenment to use that when you
|
|
|
|
start it:
|
|
|
|
|
|
|
|
./enlightenment_start -profile <my_profile>
|
|
|
|
|
|
|
|
|
|
|
|
Notes:
|
|
|
|
-------------
|
|
|
|
|
|
|
|
Please Note: There is currently NO support for running X11
|
|
|
|
applications with this !! So basically, your web browsers won't work,
|
|
|
|
don't expect to be able to run Firefox, Thunderbird, or practically
|
|
|
|
Any Other X11 application yet. About the only things "known" to work
|
|
|
|
so far are EFL/Elementary applications.
|
|
|
|
|
|
|
|
|
|
|
|
Bugs:
|
|
|
|
-------------
|
|
|
|
|
|
|
|
Yes, there are Lots of them !!
|
|
|
|
Yes, I am already aware of 99.9% of them.
|
2014-08-22 07:28:50 -07:00
|
|
|
Yes, you can start reporting them ... if you do create tickets for
|
|
|
|
any bugs, please note in your ticket that you are using the e_comp_wl
|
|
|
|
branch.
|
2014-03-18 02:11:28 -07:00
|
|
|
|
|
|
|
When we feel that the work is reaching a "finalizing" stage, we will
|
|
|
|
put out a request for actual testers and bug reports !
|