From a446f735aea6f294bc75a1675f191521d45ed2d0 Mon Sep 17 00:00:00 2001
From: Tony Crisci <tony@dubstepdish.com>
Date: Thu, 16 Nov 2017 15:39:48 -0500
Subject: [PATCH] readme: add basic running doc

---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index 0f221e3c2..721265ae9 100644
--- a/README.md
+++ b/README.md
@@ -33,3 +33,25 @@ Run these commands:
     ninja -C build
 
 (On FreeBSD, you need to pass an extra flag to prevent a linking error: `meson build -D b_lundef=false`)
+
+## Running the Reference Compositor
+
+wlroots comes with a reference compositor called rootston that demonstrates the
+features of the library.
+
+After building, run rootston from a terminal or VT with:
+
+    ./build/rootston/rootston
+
+Run windows on the compositor with the display variable set:
+
+```bash
+# run gtk apps like this
+gnome-calculator --display=wayland-0
+
+# run QT apps like this
+qgit -platform wayland
+
+# run X11 apps like this
+DISPLAY=:1 firefox
+```