diff options
Diffstat (limited to 'desktop/weston/README')
| -rw-r--r-- | desktop/weston/README | 91 |
1 files changed, 0 insertions, 91 deletions
diff --git a/desktop/weston/README b/desktop/weston/README index 49412fa858..390aa05e91 100644 --- a/desktop/weston/README +++ b/desktop/weston/README @@ -1,11 +1,3 @@ -Weston: reference implementation of a Wayland compositor. -========================================================== - -This README is current as of Weston 7.0.0. - -Introduction ------------- - Weston is the reference implementation of a Wayland compositor, as well as a useful environment in and of itself. @@ -18,86 +10,3 @@ environments on top of Weston's core. A small suite of example or demo clients are also provided: though they can be useful in themselves, their main purpose is to be an example or test case for others building compositors or clients. - - -Slackware-specific Information ------------------------------- - -***************************************** -IMPORTANT: MANUAL INTERVENTION REQUIRED. -***************************************** - -This SlackBuild of Weston takes a fairly "hands off" approach, and there -are a few things users need to be aware of. - -Firstly, it is, by default, patched to remove the PAM dependency. This -necessitates the elimination of the "-u" option of `weston-launch`, as -PAM is required for that feature to function. - -To launch Weston, here are some required steps. - -1. You must add a group to your system called "weston-launch". You may -do so, for instance, by running the following as root: - - # groupadd weston-launch - -2. Add users to the "weston-launch" group that you would like to be able -to run weston-launch: - - # usermod -a -G weston-launch $USER - -3. The `weston-launch` must be setuid root. This comes with the standard -warnings associated with doing so. - - # chmod +s /usr/bin/weston-launch - -4. If you do not have another script exporting XDG_RUNTIME_DIR, you -should enable the one that comes with this SlackBuild: - - # chmod +x /etc/profile.d/weston.sh - (or .csh, depending on your shell) - -Once you've logged out and back in as a normal user that has been -added to the "weston-launch" group from a virtual console, you should -be able to run `weston-launch` from that virtual console, and Weston -will then launch and run directly in that console. - -You can use the Ctrl+Alt+Backspace keyboard combination to kill Weston. - - -PAM ---- - -Ordinarily, PAM is a mandatory dependency for Weston. This SlackBuild -of Weston is, by default, patched to remove that dependency. If you -happen to have PAM installed on your system and would like to build -Weston with PAM support, make sure the USE_PAM variable is set to -"true" (nb: nothing else, such as "1", "yes", "on", etc. will work) -before running the SlackBuild. For example: - - # USE_PAM=true ./weston.SlackBuild - - -Optional Dependencies ---------------------- - -Above and beyond the hard dependencies listed in the .info file, Weston -contains many optional dependencies. Kindly consult the documentation -for a complete list. - -At the present time, the only optional dependency that this SlackBuild -accounts for is colord, which is disabled by default. That is because -colord pulls in many large dependencies, most of which are present on --current (at the time of writing) but not on 14.2, so disabling it seems -like a sensible default on a balance of convenience. - -If you would like to enable colord functionality in this SlackBuild, -set the USE_COLORD variable to "true" before running the SlackBuild. - - -Known Issues ------------- - -I have not had success getting Weston to launch with the proprietary -nvidia drivers in use. YMMV. I have had the best luck with the Intel -KMS drivers. |