Moved the marker.
[mono.git] / README
diff --git a/README b/README
index 07c2df049aff42b38c5d0ef97b478c39b4645af5..2b6683f503fc0b56ba1d810b4dbf44e5fdd880c0 100644 (file)
--- a/README
+++ b/README
 
 This is Mono.
 
-Installation:
+1. Installation
+2. Using Mono
+3. Directory Roadmap
 
-       Read doc/download for installation instructions, 
-       or read the HTML version:
+1. Compilation and Installation
+===============================
 
-               http://www.go-mono.com/download.html
+   a. Build Requirements
+   ---------------------
 
-* Using Mono
+       To build Mono, you will need the following components:
+
+               * pkg-config
+
+                 Available from: http://www.freedesktop.org/Software/pkgconfig
+
+               * glib 2.0
+
+                 Available from: http://www.gtk.org/
+
+       Optional dependencies:
+
+               * ICU library
+
+                 http://oss.software.ibm.com/icu/index.html
+
+                 You will need this one to get complete support for the international
+                 features of the .NET Framework.
+
+               * Cairo and libgdiplus
+
+                 If you want to get support for System.Drawing, you will need to get
+                 both Libgdiplus and Cairo.
+
+    b. Building the Software
+    ------------------------
+       
+       If you obtained this package as an officially released tarball,
+       this is very simple, use configure and make:
+
+               ./configure --prefix=/usr/local
+               make
+               make install
+
+       Mono supports a JIT engine on x86, SPARC and PowerPC systems.
+       The various commands that ship with Mono default to the JIT engine
+       on x86 and SPARC, to turn it on for PPC systems, use the --with-jit=yes 
+       command line option to configure.
+
+       MacOS X Users: you will need to download the latest Boehm GC
+       Alpha release for garbage collection to work properly.
+
+       If you obtained this as a snapshot, you will need an existing
+       Mono installation.  To upgrade your installation, unpack both
+       mono and mcs:
+
+               tar xzf mcs-XXXX.tar.gz
+               tar xzf mono-XXXX.tar.gz
+               mv mono-XXX mono
+               mv mcs-XXX mcs
+               cd mono
+               ./autogen.sh --prefix=/usr/local
+               make bootstrap 
+
+    c. Upgrade from CVS
+    -------------------
+
+       If you are upgrading from CVS you will need an existing Mono installation.
+       First verify that you have a working installation:
+
+               echo 'class X { static void Main () { System.Console.Write("OK");}}' > x.cs
+
+       Compile:
+
+               mcs x.cs
+
+       And run:
+
+               mono x.exe
+
+       If you get the output `OK' and no errors, you are ready to start your CVS upgrade.
+
+       First, make sure that you have up-to-date mcs and mono sources:
+
+               cvs co mono mcs
+
+       Then, go into the mono directory, and configure:
+
+               cd mono
+               ./autogen.sh --prefix=/usr/local
+
+       Then compile using the special target `bootstrap':
+
+               make bootstrap
+       
+       You can now install it:
+
+               make install
+
+       This step will compile and install at the same time.
+
+       Failure to follow these steps will result in a broken installation. 
+
+
+2. Using Mono
+=============
 
        Once you have installed the software, you can run a few programs:
 
@@ -29,10 +127,17 @@ Installation:
        See the man pages for mono(1), mint(1), monodis(1) and mcs(2)
        for further details.
 
-* A directory roadmap:
+3. Directory Roadmap
+====================
 
        doc/
-               Contains documentation and the web site contents.
+               Contains the web site contents.
+
+       docs/
+               Technical documents about the Mono runtime.
+
+       data/
+               Configuration files installed as part of the Mono runtime.
 
        mono/
                The core of the Mono Runtime.
@@ -63,4 +168,17 @@ Installation:
                arch/
                        Architecture specific portions.
 
+       man/
+
+               Manual pages for the various Mono commands and programs.
+
+       scripts/
+
+               Scripts used to invoke Mono and the corresponding program.
+
+       runtime/
+
+               A directory holding a pre-compiled version of the Mono
+               runtime.
+