diff --git a/sys/android/Makefile.src b/sys/android/Makefile.src
index cb9572837..ddf3f7283 100644
--- a/sys/android/Makefile.src
+++ b/sys/android/Makefile.src
@@ -84,7 +84,7 @@ SYSOBJ = ioctl.o androidmain.o unixtty.o androidunix.o
 # CC = arm-linux-gcc
 #
 # For cross-compiling with Android NDK
-NDK = /home/gurr/android-ndk-r9d
+NDK = /path/to/android-ndk-r9d
 SYSROOT=$(NDK)/platforms/android-9/arch-arm
 CC = $(NDK)/toolchains/arm-linux-androideabi-4.6/prebuilt/linux-x86_64/bin/arm-linux-androideabi-gcc --sysroot=$(SYSROOT)
 
@@ -138,8 +138,8 @@ CC = $(NDK)/toolchains/arm-linux-androideabi-4.6/prebuilt/linux-x86_64/bin/arm-l
 # flags for Linux
 #   compile normally
 # CFLAGS = -O2 -fomit-frame-pointer -I../include
-#CFLAGS = -DANDROID -O -Wno-format -fsigned-char -I../include
-CFLAGS = -DANDROID -g -Wno-format -fsigned-char -I../include
+CFLAGS = -DANDROID -O2 -Wno-format -fsigned-char -I../include
+#CFLAGS = -DANDROID -g -Wno-format -fsigned-char -I../include
 LFLAGS = -shared -Wl,--fix-cortex-a8
 
 # LFLAGS = -L/usr/X11R6/lib
diff --git a/sys/android/README b/sys/android/README
new file mode 100644
index 000000000..e36bb5c29
--- /dev/null
+++ b/sys/android/README
@@ -0,0 +1,48 @@
+
+Build instructions
+
+
+These instructions are written for a 64-bit Ubuntu installation.
+Modifying them for other linux distributionos should be little to no
+work. If you're running Windows you're on your own.
+
+
+
+=== Preparations ===
+
+ - Install the Android SDK
+     http://developer.android.com/sdk
+ 
+ - Download and extract the Android NDK
+     http://developer.android.com/sdk/ndk
+      
+ - Install 'bison' and 'flex'
+ 
+ - Check out the source
+     git clone https://github.com/gurrhack/ForkFront-Android.git
+     git clone https://github.com/gurrhack/SlashEM-Android.git
+
+
+
+=== Building Slash'EM ===
+
+1. cd <SlashEM-Android>/sys/android
+2. Open Makefile.src and change NDK to the appropriate path
+3. sh ./setup.sh
+4. cd ../..
+5. make install
+
+
+
+
+=== Building the app ===
+
+1. Start IntelliJ
+2. Create an empty project in the parent directory
+3. Add a new empty Java module to the project root
+4. Import the ForkFront module located at <ForkFront-Android>/forkfront.iml
+5. Import the Slash'EM module located at <SlashEM-Android>/sys/android/slashem.iml
+6. Build and Run!
+
+
+Happy hacking!