aboutsummaryrefslogtreecommitdiff
path: root/rootston/README.md
diff options
context:
space:
mode:
authorDrew DeVault <sir@cmpwn.com>2019-01-03 17:14:00 -0500
committerGitHub <noreply@github.com>2019-01-03 17:14:00 -0500
commitbcf48931db14f24fcd35a6999969864ca2539d32 (patch)
treead5aa20d125e8feae2b8dceb87d4e8bba0ed867a /rootston/README.md
parente2c216a4b84803668a10351dc1d5d9d922ae5539 (diff)
parent25f905fdaa60fedd4ff8797e52b0da3cb2a888ab (diff)
Merge pull request #1449 from swaywm/tinywl
Merge tinywl
Diffstat (limited to 'rootston/README.md')
-rw-r--r--rootston/README.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/rootston/README.md b/rootston/README.md
new file mode 100644
index 00000000..be2e6698
--- /dev/null
+++ b/rootston/README.md
@@ -0,0 +1,18 @@
+# rootston
+
+Rootston is the "big" wlroots test compositor. It implements basically every
+feature of wlroots and may be useful as a reference for new compositors.
+However, it's mostly used as a testbed for wlroots development and does not have
+particularly clean code and is not particularly well designed: proceed with a
+grain of salt. It is not designed for end-users.
+
+## Running rootston
+
+If you followed the build instructions in `../README.md`, the rootston
+executable can be found at `build/rootston/rootston`. To use it, refer to the
+example config at [rootston/rootston.ini.example][rootston.ini] and place a
+config file of your own at `rootston.ini` in the working directory (or in an
+arbitrary location via `rootston -C`). Other options are available, refer to
+`rootston -h`.
+
+[rootston.ini]: https://github.com/swaywm/wlroots/blob/master/rootston/rootston.ini.example