diff --git a/README.md b/README.md
index 72eb8407d25..78a4092b3ff 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,9 @@ sudo port install autoconf213
 On Debian-based Linuxes:
 
 ``` sh
-sudo apt-get install autoconf2.13 curl freeglut3-dev libtool libfreetype6-dev libfontconfig1-dev libgl1-mesa-dri libglib2.0-dev
+sudo apt-get install autoconf2.13 curl freeglut3-dev libtool \
+    libfreetype6-dev libfontconfig1-dev libgl1-mesa-dri libglib2.0-dev \
+    xorg-dev
 ```
 
 Servo builds its own copy of Rust, so there is no need to provide a Rust
@@ -30,6 +32,9 @@ compiler.
 
 ## Building
 
+Servo cannot be built in-tree; you must create a directory in which to run
+configure and make and place the build artifacts.
+
 ``` sh
 git clone git://github.com/mozilla/servo.git
 cd servo
@@ -39,4 +44,31 @@ make && make check
 ./servo ../src/test/html/about-mozilla.html
 ```
 
-[issue]: https://github.com/mxcl/homebrew/issues/5117
+## Running
+
+### Commandline Arguments
+
+- `-p INTERVAL` turns on the profiler and dumps info to the console every
+  `INTERVAL` seconds
+- `-s SIZE` sets the tile size for rendering; defaults to 512
+
+### Keyboard Shortcuts
+
+- `Ctrl-L` opens a dialog to browse to a new URL (Mac only currently)
+- `Ctrl--` zooms out
+- `Ctrl-=` zooms in
+- `Backspace` goes backwards in the history
+- `Shift-Backspace` goes forwards in the history
+
+## Developing
+
+There are lots of make targets you can use:
+
+- `make clean` - cleans Servo and its dependencies, but not Rust
+- `make clean-rust` - cleans Rust
+- `make clean-servo` - only cleans Servo itself (code in `src/components`
+- `make clean-DEP` - cleans the dependency `DEP`. e.g. `make clean-rust-opengles`
+- `make bindings` - generate the Rust WebIDL bindings
+- `make DEP` - builds only the specified dependency. e.g. `make rust-opengles`
+- `make check-DEP` - build and run tests for specified dependency
+