README: update build instructions

This commit is contained in:
Jente Hidskes 2020-02-01 16:17:58 +01:00
parent 66313efb01
commit e664fdce79
No known key found for this signature in database
GPG key ID: 04BE5A29F32D91EA

View file

@ -7,8 +7,8 @@ application.
This README is only relevant for development resources and instructions. For a This README is only relevant for development resources and instructions. For a
description of Cage and installation instructions for end-users, please see description of Cage and installation instructions for end-users, please see
[the Wiki](https://github.com/Hjdskes/cage/wiki/) and [its project [its project page](https://www.hjdskes.nl/projects/cage) and [the
page](https://www.hjdskes.nl/projects/cage). Wiki](https://github.com/Hjdskes/cage/wiki/).
## Release signatures ## Release signatures
@ -30,20 +30,21 @@ $ meson build
$ ninja -C build $ ninja -C build
``` ```
By default, this builds a debug build. To build a release build, use `meson
build --buildtype=release`.
Cage comes with compile-time support for XWayland. To enable this, Cage comes with compile-time support for XWayland. To enable this,
first make sure that your version of wlroots is compiled with this first make sure that your version of wlroots is compiled with this
option. Then, add `-Dxwayland=true` to the `meson` command above. Note option. Then, add `-Dxwayland=true` to the `meson` command above. Note
that you'll need to have the XWayland binary installed on your system that you'll need to have the XWayland binary installed on your system
for this to work. for this to work.
You can run Cage by running `./build/cage APPLICATION`. If you run it You can run Cage by running `./build/cage APPLICATION`. If you run it from
from within an existing X11 or Wayland session, it will open in a within an existing X11 or Wayland session, it will open in a virtual output as
virtual output as a window in your existing session. If you run it at a window in your existing session. If you run it at a TTY, it'll run with the
a TTY, it'll run with the KMS+DRM backend. In debug mode (default KMS+DRM backend. In debug mode (default build type with Meson), press
build type with Meson), press Alt+Esc to quit. To build a release <kbd>Alt</kbd>+<kbd>Esc</kbd> to quit. For more configuration options, see
build, use `meson build --buildtype=release`. [Configuration](https://github.com/Hjdskes/cage/wiki/Configuration).
For more information, see the [Wiki](https://github.com/Hjdskes/cage/wiki).
Cage is based on the annotated source of tinywl and rootston. Cage is based on the annotated source of tinywl and rootston.