diff options
Diffstat (limited to 'desktop/weston/README')
-rw-r--r-- | desktop/weston/README | 92 |
1 files changed, 4 insertions, 88 deletions
diff --git a/desktop/weston/README b/desktop/weston/README index 5c0ccf7dcc..19af6655a8 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. @@ -19,84 +11,8 @@ 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. +This is the bleeding edge version of this SlackBuild that is ONLY compatible +with Slackware Current which has been relatively newly PAM-ified as of the +time of writing (May, 2020). -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. +Please see README.SBo for more detailed instructions and information. |