2002-08-11 Rodrigo Moya <rodrigo@ximian.com>
[mono.git] / doc / download
index 11869427fddfc880de0e7bac403167486fe8bad7..148b29d60ccf1cb018cf90e931f5c23b4a7ecd16 100644 (file)
@@ -2,7 +2,7 @@
 
        The Virtual Execution System is available in package `mono'.
        Currently this contains a metadata library and the
-       disassembler.  Please reffer to our <a
+       disassembler.  Please refer to our <a
        href="runtime.html">Runtime</a> description for more details
        on this part of the project.
 
        test suite and the class library are in the `mcs' package, we
        will move this later into `mono' itself. 
 
-       In order to make mcs and the class libraries you will need the
-       GNU make tools.  These may be obtained for the Windows
-       environment from <a href="http://www.cygwin.com">cygwin.com</a>.
+       In order to make mcs and the class libraries you will need a computer
+       running Windows with the <strong>GNU make tools</strong> from the 
+       <strong>Cygwin</strong> environment, <strong>Microsoft's .NET Framework
+       SDK</strong>, <strong>GLIB 2.0</strong> and 
+       <strong>pkg-config</strong>.  
 
-       You will also need to get GLIB, from: <a
-href="ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz">ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz</a>
+        When installing Cygwin, don't forget to include
+       <tt>mingw-runtime</tt>. If you omit this, you will encounter
+       configure problems regarding not being able to generate
+       executables.
 
 <a name="sources">
-** Sources
+*** Sources
 
-       We provide both <a href="#packaged">packaged and tested</a>
-       tarballs (those are known to compile and pass `make
-       distcheck') as well as <a href="snapshots">daily snapshots</a> done
-       at 10pm Boston Time
+       Stay up to date on the Mono team's development using the 
+       <a href="http://lists.ximian.com/mailman/listinfo/mono-cvs-list">
+       mono-cvs-list</a> mailing list.  The CVS source code can also
+       be browsed <a href="http://cvs.hispalinux.es/cgi-bin/cvsweb/?cvsroot=Mono#dirlist">here</a>
+
+<a name="jun-7">
+       <b>Mono 0.13</b>
+
+       New packaged versions of the Mono C# compiler and Mono runtime
+       are now available.  The latest version is 0.13.
+
+       <ul>
+               * <a href="archive/mono-0.13">Mono 0.13 release notes</a>
+
+               * <a href="archive/mcs-0.13.tar.gz">mcs-0.13.tar.gz</a>
+               Mono C# compiler with class library source code.
+
+               * <a href="archive/mono-0.13.tar.gz">mono-0.13.tar.gz</a>
+               Mono runtime.
+       </ul>
+
+* Snapshots    
+
+       Volunteers package up daily the sources:
+
+       <ul>
+               * <a href="http://www.atoker.com/mono">Debian Linux</a>
+               * <a href="http://mono.baselabs.org/index.php/software">Red Hat Linux</a>
+               * <a href="http://www.superin.formativ.net/mono/mono.htm">Windows</a> (works without cygwin!)
+       </ul>
 
 <a name="snapshots">
-*** Snapshots
+       For up to date sources, it is recommended that you use the Mono 
+       source code from either the 
+       <a href="http://www.go-mono.com/snapshots">nightly snapshots</a> or 
+       the <a href="anoncvs.html">Anonymous CVS</a>.  The nightly
+       snapshots are done every night at 10pm EST (Boston Time).
+
+       The nightly snapshots are not guaranteed to build, but most of the 
+       time they should.  They should give you a window to see what we are 
+       up to.
+
+       You can download the GNU make tools and the Cygwin environment from
+       <a href="http://www.cygwin.com">www.cygwin.com</a>.
+
+       You can download Microsoft's .NET Framework SDK from
+       <a href="http://msdn.microsoft.com/downloads">
+       msdn.microsoft.com/downloads</a>.
+
+       There are scripts to help build mono for both Unix and Windows.  Get
+       <a href="mono-build.sh">mono-build.sh</a> for Unix, or <a
+       href="mono-build-w32.sh">mono-build-w32.sh</a> for Windows.
+       These scripts automate the installation of GLIB and pkgconfig
+       (building from source on Unix, and using binary packages
+       provided by the GIMP for Windows project on Windows.)  To use
+       the script, follow these simple steps:
+
+       <ul>
+               * Save the script for your platform somewhere (e.g. /usr/local/bin)
+               * Make the script executable (i.e chmod 755 /usr/local/bin/mono-build.sh)
+               * Create a directory to hold the mono source, and the compiled binaries (e.g. mkdir ~/mono)
+               * Change to the new directory (i.e. cd ~/mono)
+               * run the script (i.e. /usr/local/bin/mono-build.sh)
+       </ul>
 
-       The daily snapshots are available <a
-       href="http://www.go-mono.com/snapshots">here</a>.  These
-       snapshots are done every day at 10pm EST (Boston Time). 
+       The script requires wget on either platform, and building the
+       software requires make, gcc, automake, autoconf, and libtool.
+       You should install these packages from your distribution or
+       with the cygwin installer.
 
-       They are not guaranteed to build, but most of the time they
-       should.  They should give you a window to see what we are up to.
+       The script will download required packages from
+       www.go-mono.com and do a cvs checkout of mono in the current
+       directory.  The cvs server chosen defaults to anonymous cvs;
+       set your CVSROOT environment variable before running the script to
+       select a particular cvs server.
 
-       You might also want to track our development using the <a
-       href="http://lists.ximian.com/mailman/listinfo/mono-cvs-list">mono-cvs-list</a>
-       mailing list.
+** Mono Regression Test Suite
 
-<a name="packaged">
-*** Released and tested packages
+       You can get binaries for the Mono Regression Test Suite <a
+       href="archive/mono-tests.tar.gz">here</a>
+       
+<a name="install">
+** Building the software manually
+
+*** Download the required software.
 
        <ul>
+
+               * Microsoft's .NET Framework SDK from 
+                 <a href="http://msdn.microsoft.com/downloads">
+                 msdn.microsoft.com/downloads</a>.
+
+               * Cygwin and the GNU Make tools from  
+                 <a href="http://www.cygwin.com">www.cygwin.com</a>.
+                 Some people observed problems with autoconf 2.52. Installing 
+                 autoconf 2.13 helped in those cases.
+
+               * Precompiled GLIB 1.3 and pkg-config packages (and
+                 their dependencies) by the <a href="http://www.gimp.org/~tml/gimp/win32//index.html">GIMP for Windows</a> project from
+                 <a href="http://www.go-mono.com/archive/pkgconfig-0.80-tml-20020101.zip">http://www.go-mono.com/archive/pkgconfig-0.80-tml-20020101.zip</a>
+                 <a href="http://www.go-mono.com/archive/glib-1.3.12-20020101.zip">http://www.go-mono.com/archive/glib-1.3.12-20020101.zip</a>
+                 <a href="http://www.go-mono.com/archive/glib-dev-1.3.12-20020101.zip">http://www.go-mono.com/archive/glib-dev-1.3.12-20020101.zip</a>
+                 <a href="http://www.go-mono.com/archive/libiconv-1.7.zip">http://www.go-mono.com/archive/libiconv-1.7.zip</a>
+                 <a href="http://www.go-mono.com/archive/libiconv-dev-1.7.zip">http://www.go-mono.com/archive/libiconv-dev-1.7-20020101.zip</a>
+                 <a href="http://www.go-mono.com/archive/libintl-0.10.40-20020101.zip">http://www.go-mono.com/archive/libintl-0.10.40-20020101.zip</a>
+
+               * Download the Mono source code from the
+                 <a href="#feb-11">packaged versions</a> or
+                 the <a href="http://www.go-mono.com/snapshots">
+                 nightly snapshots</a> or the <a href="anoncvs.html">
+                 Anonymous CVS</a>.  The nightly snapshots are done every 
+                 night at 10pm EST (Boston Time). The nightly snapshots are 
+                 not guaranteed to build, but most of the time they should.
+
+
+       </ul>
+
+
+*** Install Cygwin and the GNU build tools, Microsoft's .NET Framework SDK and the precompiled GLIB 1.3 and pkg-config libraries.
+
+       <ul>
+
+               * Install <a href="http://www.cygwin.com">Cygwin</a>.
+
+               * Install <a href="http://msdn.microsoft.com/downloads">
+                 Microsoft .NET Framework SDK</a>.
+
+               * Change to the <strong>/usr/local</strong> directory
+                 of your Cygwin installation.<br>
+                 Unzip the precompiled packages listed above.
+
+       </ul>
+
+*** On Windows, to install and work on the compiler and the class libraries:
+
+       <ul>
+
+               * If you downloaded the Mono 
+                 <a href="http://www.go-mono.com/snapshots">nightly snapshot
+                 </a>, untar the snapshot.
+
+               * Change directories to <strong>"mcs"</strong>.
+
+               * Compile:
+
+<pre>
+<strong>make windows</strong>
+</pre>
+
+       </ul>
+
+*** On Windows, to compile the mono runtime:
+
+       <ul>    
+
+               * If you downloaded the Mono 
+                 <a href="http://www.go-mono.com/snapshots">nightly snapshot
+                 </a>, untar the snapshot.
+
+               * Change directories to <strong>"mono"</strong>.
+
+               * Configure, compile and install:
+
+<pre><strong>
+./configure --prefix=c:/mono
+make
+make install
+</strong></pre>
+               
+       </ul>
+
+*** On Unix, to compile the mono runtime:
+
+       <ul>
+               
+               * Install <a href="http://www.freedesktop.org/software/pkgconfig">pkg-config</a>.
+
+               * Install glib 1.3. You can download it
+                  from <a href="ftp://ftp.gtk.org/pub/gtk/v1.3/glib-1.3.12.tar.gz">ftp.gtk.org</a>. Maybe you need
+                  to modify your ACLOCAL_FLAGS for pkg-config, for example if
+                  your install prefix is /usr/local:
+<pre>
+<strong>export ACLOCAL_FLAGS="-I /usr/local/share/aclocal"</strong>
+</pre>
+
+               * If you downloaded the Mono 
+                 <a href="http://www.go-mono.com/snapshots">nightly snapshots
+                 </a>, untar the snapshot.
+
+               * Change directories to <strong>"mono"</strong>.
+
+               * Configure, compile and install:
+<pre><strong>
+./configure
+make
+make install</strong>
+</pre>
+       </ul>
+
+*** Notes on compiling GLIB 1.3 and pkg-config from source:
+
+
+       <ul>
+
+               * Some people observed problems with autoconf 2.52. Installing 
+                 autoconf 2.13 helped in those cases (don't forget to do a
+                 `make maintainer-clean' after the update).
+
+               * Download, compile and install <a href="http://www.freedesktop.org/software/pkgconfig">pkg-config</a> from source.
+                  (I had to change line 674 of
+                  <nobr><tt>pkg-config-0.8.0/glib-1.2.8/gstrfuncs.c</tt></nobr> from 
+                 <nobr><tt>extern char *strsignal (int sig);</tt></nobr> to
+                 <nobr><tt>extern const char *strsignal (int sig);</tt></nobr>.
+
+<pre><strong>
+tar xzvf pkg-config-0.8.0.tar.gz
+cd pkg-config-0.8.0
+./configure --prefix=/usr
+make
+make install</strong>
+</pre>
+
+               * Download, compile and install <a href="ftp://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.7.tar.gz">libiconv</a> from source.<br>
+                 If you dont have MS Visual C/C++ 4.0 or 5.0 or 6.0 you can also try
+                 the binary package available at <a
+                 href="http://www.gimp.org/win32/libiconv-dev-20001007.zip">
+                 http://www.gimp.org/win32/libiconv-dev-20001007.zip</a>.
+
+               * Download, compile and install the 
+                 <a href="ftp://ftp.gtk.org/pub/gtk/v1.3/glib-1.3.12.tar.gz">
+                 glib 1.3</a> from source.
+
+       </ul>
+
+
+<a name="oldreleases">
+
+*** Old releases.
+
+       <ul>
+
+       <ul>
+       <a name="apr-24">
+       <b>Mono 0.11; April 24, 2002</b>
+               * <a href="archive/mono-0.11">Mono 0.11 release notes</a>
+
+               * <a href="archive/mcs-0.11.tar.gz">mcs-0.11.tar.gz</a>
+               Mono C# compiler
+               * <a href="archive/mono-0.11.tar.gz">mono-0.11.tar.gz</a>
+               Mono runtime
+       </ul>
+
+       <ul>    
+       <a name="mar-27">
+       <b>Mono 0.10; March 27, 2002</b>
+               * <a href="archive/mono-0.10">Mono 0.10 release notes</a>
+               * <a href="archive/mcs-0.10.tar.gz">mcs-0.10.tar.gz</a>
+               Mono C# compiler
+               * <a href="archive/mono-0.10.tar.gz">mono-0.10.tar.gz</a>
+               Mono runtime
+       </ul>
+       
+       <ul>
+       <a name="feb-22">
+       <b>Mono 0.9; February 22, 2002</b>
+               * <a href="archive/mono-0.9">Mono 0.9 release notes</a>
+
+               * <a href="archive/mcs-0.9.tar.gz">mcs-0.9.tar.gz</a>
+               Mono C# compiler
+               * <a href="archive/mono-0.9.tar.gz">mono-0.9.tar.gz</a>
+               Mono runtime
+       </ul>
+       
+               <a name="feb-11">
+               <b>February 11, 2002</b>
+               * <a href="archive/mcs-0.8.tar.gz">mcs-0.8.tar.gz</a>
+               Mono C# compiler
+               * <a href="archive/mono-0.8.tar.gz">mono-0.8.tar.gz</a>
+               Mono runtime
+               </ul>
+
                <a name="sep-18">
                <b>September 18, 2001</b>
                <ul>
@@ -116,101 +379,3 @@ href="ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz">ftp://ftp.gtk.org/pub/g
                </ul>
        </ul>
 
-<a name="install">
-** Installing the software
-
-       To install and work on the compiler and the class libraries,
-       follow these instructions:
-
-       <ul>
-               * Install <a href="http://www.cygwin.com">CygWin</a> first.
-
-               * Untar the MCS distribution (see below for information).
-
-               * Go into the MCS directory and type `make windows'
-       </ul>
-
-       To compile the mono runtime on windows:
-
-       <ul>    
-               * Warning: We switched over to glib2.0, and we are still searching
-               for a volunteer who is able to provide us with binary packages
-               of glib2.0, pkgconfig and iconv. I was unable to compile
-               glib2.0 myself, so the following is only a rough outline how it
-               should work.
-
-               * Install <a href="http://www.cygwin.com">CygWin</a> first.
-
-               * Install <a href="http://www.freedesktop.org/software/pkgconfig">pkgconfig</a>.
-                  (I had to change line 674 of
-                  <nobr><tt>pkgconfig-0.8.0/glib-1.2.8/gstrfuncs.c</nobr> from 
-                 <nobr><tt>extern char *strsignal (int sig);</nobr> to
-                 <nobr><tt>extern const char *strsignal (int sig);</nobr>.
-<pre>
-tar xzvf pkgconfig-0.8.0.tar.gz
-cd pkgconfig-0.8.0
-./configure --prefix=/usr
-make
-make install
-</pre>
-
-               * Install <a href="ftp://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.7.tar.gz">libiconv</a>.
-                 If you dont have MS Visual C/C++ 4.0 or 5.0 or 6.0 you can also try
-                 the binary package available at <a
-                 href="http://www.gimp.org/win32/libiconv-dev-20001007.zip">here</a>.
-               * Install the newest glib (cvs head version). You can download it
-                  from <a href="glib-1.3.11.tar.gz">here</a>.
-
-               * Unpack the mono distribution:
-
-<pre>
-tar xzvf mono-XXX.tar.gz
-</pre>
-
-               * Configure, compile and install:
-
-<pre>
-./configure --prefix=//c/mono
-make
-make install
-</pre>
-
-               * Some people observed problems with autoconf 2.52. Installing 
-                 autoconf 2.13 helped in those cases (don't forget to do a
-                 `make maintainer-clean' after the update)
-
-       </ul>
-
-       To compile the mono runtime on Unix:
-
-       <ul>
-               
-               * Install <a href="http://www.freedesktop.org/software/pkgconfig">pkgconfig</a>.
-
-               * Install newest glib (cvs head version). You can download it
-                  from <a href="glib-1.3.11.tar.gz">here</a>. Maybe you need
-                  to modify your ACLOCAL_FLAGS for pkgconfig, for example if
-                  your install prefix is /usr/local:
-<pre>
-export ACLOCAL_FLAGS="-I /usr/local/share/aclocal"
-</pre>
-
-               * Download the mono distribution
-
-               * Unpack the mono distribution:
-
-<pre>
-tar xzvf mono-XXX.tar.gz
-</pre>
-
-               * Configure, compile and install:
-<pre>
-./configure
-make
-make install
-</pre>
-       </ul>
-       
-
-