diff --git a/README.md b/README.md
index 72b09d4..766d29d 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,78 @@
 #j2js-compiler
 
 A Java Bytecode to JavaScript Cross-Compiler.
+
+##Installation
+
+1. You need to install this and the following projects
+
+* https://github.com/decatur/j2js-compiler
+* https://github.com/decatur/j2js-jre
+* https://github.com/decatur/j2js-agent
+
+2. Build all projects. An Eclipse project description is included.
+
+3. Optionally install https://github.com/decatur/j2js-demos
+
+##Usage
+
+    java -cp <RUNTIME_CLASSPATH> com.j2js.J2JSCompiler <basedir> <CROSS_COMPILE_CLASSPATH> <entryPointClassName> <targetLocation>
+
+###`<RUNTIME_CLASSPATH>`
+
+This is the standard Java classpath.
+The cross-compiler needs the project j2js-compiler, bcel and commons-io on its classpath. 
+
+###`<basedir>`
+
+All non-absolute paths are relative to the basedir.
+
+###`<entryPointClassName>`
+
+The name of the class to cross-compile. This class must have a method
+`public void main(java.lang.String[])`.
+
+The compiler cross-compiles the `main` method and all other methods which are called from the `main` method.
+
+###`<CROSS_COMPILE_CLASSPATH>`
+
+This classpath must contain all classes whose methods are referenced by the main method.
+In normal operation, this classpath consists of
+* the j2js-jre classes directory or jar
+* the j2js-agent classes directory or jar
+* the classes directory of your personal project
+
+###`<targetLocation>`
+All cross-compiled code is stored in the target location. It is one or more JavaScript file starting at
+`0.js`. Only this initial file must be included in your web page with
+`<script src='targetLocation/0.js'/>`.
+
+###Example
+
+Suppose the directory layout is
+
+    |- j2js-compiler
+    |- j2js-jre
+    |- j2js-agent
+    |- my-project
+         |- target
+             |- assemblies
+                 |- 0.js
+                 |- 1.js
+                 |- 2.js ...
+
+and you want to cross-compile class `org.mydomain.my-project.MyClass`. Then
+    
+    java -cp ../j2js-compiler/libs/commons-io-1.4.jar;^
+    ../j2js-compiler/libs/bcel-5.1.jar;^
+    ../j2js-compiler/target/classes ^
+    com.j2js.J2JSCompiler . ^
+    target/classes;../j2js-jre/target/classes;../j2js-agent/target/classes ^
+    org.mydomain.my-project.MyClass target/assemblies
+
+will create the assemblies.
+
+##Warning
+The project j2js-jre contains a hand-crafted version of the Java Runtime Environment. Do not substitute the path
+to this project by a path to `Java/jreX/lib/rt.jar`. 
+