aboutsummaryrefslogtreecommitdiff
path: root/rootston/README.md
diff options
context:
space:
mode:
authorDrew DeVault <sir@cmpwn.com>2019-01-03 10:10:03 -0500
committerDrew DeVault <sir@cmpwn.com>2019-01-03 10:10:03 -0500
commitf0d8b793a8e816afdb46cd47004994e3279beda3 (patch)
tree7ee7fc7b6e006fa327684feececf389650fea086 /rootston/README.md
parentfc2ba30cfa771252e5707ddeb49c696043f4905d (diff)
Update READMEs per tinywl merge
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