Updated build instructions.

1 files changed, 36 insertions, 4 deletions

diff --git a/HOWTO b/HOWTO
index 4357f01a..c4d66373 100644
--- a/HOWTO
+++ b/HOWTO
@@ -1,5 +1,37 @@
-TODO
+IKVM Build Instructions
+-----------------------
 
-> - extend HOWTO file with information about .NET versions
-> - extend HOWTO with information about signing
-> - extend HOWTO with information that build has two passes
+This IKVM source bundle requires GNU Classpath 0.95 and OpenJDK 6 b12 sources (and resources).
+
+They can be downloaded from the SourceForge IKVM project, or from:
+
+http://www.frijters.net/classpath-0.95-stripped.zip
+http://www.frijters.net/openjdk6-b12-stripped.zip
+
+These files should be unzipped in the same directory as where the ikvm directory
+(that contains this unzipped source bundle) lives.
+
+Open a Visual Studio 2008 Command Prompt (i.e. one that has the Windows and .NET Framework SDK
+environment variables set).
+
+Add NAnt 0.85 to the PATH.
+
+From the ikvm directory run "nant clean" and "nant".
+
+You now should have the built binaries in ikvm/bin.
+
+
+Additional Information
+----------------------
+
+IKVM.Runtime.dll and IKVM.OpenJDK.ClassLibrary.dll mutually depend on eachother. This is
+accomplished by building IKVM.Runtime.dll in two passes. The first pass defines the methods
+and types that IKVM.OpenJDK.ClassLibrary.dll uses, but generally with an empty method body
+(look for #if FIRST_PASS in the IKVM.Runtime.dll sources). The second pass is built after
+IKVM.OpenJDK.ClassLibrary.dll has been built.
+
+The version numbers of the build are defined in ikvm/CommonAssemblyInfo.cs,
+ikvm/openjdk/openjdk.build and ikvm/jvm.JVM.il.
+
+If you want to do a strong named build, make sure you have a key container installed named
+"ikvm-key" and run the build with "nant clean" and "nant signed".