Flush docs
[mono.git] / doc / download
index 9ac6f1afa1f1215e87d4cfd0f51dccb5766d60c6..2784186e63c1ed15aba6479e65e42e0a89651cf6 100644 (file)
 * Software Availability
 
-       The Virtual Execution System is available in package `mono'. 
+       The Virtual Execution System is available in package `mono'.
+       Currently this contains a metadata library and the
+       disassembler.  Please refer to our <a
+       href="runtime.html">Runtime</a> description for more details
+       on this part of the project.
 
-       Currently the code for the C# compiler as well as the error
-       test suite and the class library is in package `mcs', we will
-       move this later into `mono'.
+       Some useful links: <a
+       href="http://www.go-mono.org/mono-beginning.html">Resources/Beginning
+       section</a>, the <a
+       href="http://www.go-mono.org/faq.html">FAQ</a> and the <a
+       href="http://geneura.ugr.es/~jaime/deploy/mono-common-problems.html">
+       Mono Common Problems</a>. 
 
-       The parser generator required by `mcs' is available in the
-       module `jay'. 
+       <table>
+         <tbody>
+         <tr bgcolor="#DDDDDD">
+           <td>
+             <b>Release 0.15</b><br>
+             <a href="archive/mono-0.15">Release notes</a><br>
+             Aug 23rd, 2002.
+           </td>
+           <td>
+             <table cellspacing="1" cellpadding="3">
+               <tr bgcolor="#BBBBBB">
+                 <td>
+                   <b>Source Code</b>
+                 </td>
+                 <td>
+                   <ul>
+                     <li><a href="archive/mcs-0.15.tar.gz">Mono Class Libraries and C# Compiler.</a>
+                     <li><a href="archive/mono-0.15.tar.gz">Mono Runtime</a>
+                     <li><a href="archive/gc6.1alpha5.tar.gz">Boehm GC 6.1alpha5</a>
+                   </ul>
+                 </td>
+               </tr>
+               <tr bgcolor="#BBBBBB">
+                 <td>
+                    <b>Source RPMs</b>
+                 </td>
+                 <td>
+                   <ul>
+                       <li><a href="archive/libgc-6.1alpha5-1.src.rpm">libgc-6.1alpha5-1.src.rpm</a>
+                       <li><a href="archive/mono-0.15-1.src.rpm">mono-0.15-1.src.rpm</a>
+                   </ul>
+                 </td>
+               </tr>
+               <tr>
+                <td></td>
+               </tr>
+               <tr>
+                 <td bgcolor="#999999">
+                   <b>Red Hat 7.3/x86</b>
+                    <ul>
+                       <li><a href="archive/redhat-73-i386/libgc-6.1alpha5-1.i386.rpm">libgc-6.1alpha5-1.i386.rpm</a>
+                       <li><a href="archive/redhat-73-i386/libgc-devel-6.1alpha5-1.i386.rpm">libgc-devel-6.1alpha5-1.i386.rpm</a>
+                       <li><a href="archive/redhat-73-i386/mono-0.15-1.i386.rpm">mono-0.15-1.i386.rpm</a>
+                       <li><a href="archive/redhat-73-i386/mono-devel-0.15-1.i386.rpm">mono-devel-0.15-1.i386.rpm</a>
+                   </ul>
+                 </td>
+                 <td bgcolor="#999999">
+                   <b>Red Hat 7.1/x86</b>
+                    <ul>
+                       <li><a href="archive/redhat-71-i386/libgc-6.1alpha5-1.i386.rpm">libgc-6.1alpha5-1.i386.rpm</a>
+                       <li><a href="archive/redhat-71-i386/libgc-devel-6.1alpha5-1.i386.rpm">libgc-devel-6.1alpha5-1.i386.rpm</a>
+                       <li><a href="archive/redhat-71-i386/mono-0.15-1.i386.rpm">mono-0.15-1.i386.rpm</a>
+                       <li><a href="archive/redhat-71-i386/mono-devel-0.15-1.i386.rpm">mono-devel-0.15-1.i386.rpm</a>
+                   </ul>
+                 </td>
+               </tr>
+               <tr>
+                 <td bgcolor="#999999">
+                   <b>Mandrake 8.2/x86</b>
+                    <ul>
+                       <li><a href="archive/mandrake-82-i386/libgc-6.1alpha5-1.i386.rpm">libgc-6.1alpha5-1.i586.rpm</a>
+                       <li><a href="archive/mandrake-82-i386/libgc-devel-6.1alpha5-1.i386.rpm">libgc-devel-6.1alpha5-1.i586.rpm</a>
+                       <li><a href="archive/mandrake-82-i386/mono-0.15-1.i386.rpm">mono-0.15-1.i586.rpm</a>
+                       <li><a href="archive/mandrake-82-i386/mono-devel-0.15-1.i386.rpm">mono-devel-0.15-1.i586.rpm</a>
+                   </ul>
+                 </td>
+                 <td bgcolor="#999999">
+                   <b>SuSE 8.0/x86</b>
+                    <ul>
+                       <li><a href="archive/suse-80-i386/libgc-6.1alpha5-1.i386.rpm">libgc-6.1alpha5-1.i386.rpm</a>
+                       <li><a href="archive/suse-80-i386/libgc-devel-6.1alpha5-1.i386.rpm">libgc-devel-6.1alpha5-1.i386.rpm</a>
+                       <li><a href="archive/suse-80-i386/mono-0.15-1.i386.rpm">mono-0.15-1.i386.rpm</a>
+                       <li><a href="archive/suse-80-i386/mono-devel-0.15-1.i386.rpm">mono-devel-0.15-1.i386.rpm</a>
+                   </ul>
+                 </td>
+               </tr>
+               <tr bgcolor="#999999">
+                 <td>
+                   <b>Windows (win95 friendly)</b>
+                   <ul>
+                     <li><a href="archive/mono-w32-Aug_28_2002.zip">Mono-w32</a>
+                   </ul>
+                 </td>
+                 <td bgcolor="#999999">
+                   <b>Red Hat null-8.0/x86</b>
+                    <ul>
+                       <li><a href="archive/redhat-null-i386/libgc-6.1alpha5-1.i386.rpm">libgc-6.1alpha5-1.i386.rpm</a>
+                       <li><a href="archive/redhat-null-i386/libgc-devel-6.1alpha5-1.i386.rpm">libgc-devel-6.1alpha5-1.i386.rpm</a>
+                       <li><a href="archive/redhat-null-i386/mono-0.15-1.i386.rpm">mono-0.15-1.i386.rpm</a>
+                       <li><a href="archive/redhat-null-i386/mono-devel-0.15-1.i386.rpm">mono-devel-0.15-1.i386.rpm</a>
+                   </ul>
+                 </td>
+               </tr>
+             </table>
+           </td>
+         </tr>
+         <tr>
+           <tr bgcolor="#CCCCC">
+           <td>
+             <b>Regression Tests</b><br>
+           </td>
+           <td>
+               You can get binaries for the Mono Regression Test
+               Suite <a href="archive/mono-tests.tar.gz">here</a>
+           </td>
+         </tr>
+         </tbody>
+       </table>
+
+** Binaries for other platforms.
+
+       Already daily volunteer's made binaries:
+
+       <ul>
+               * <a href="http://www.debianplanet.org/mono/">DebianPlanet</a>
+               * <a href="http://www.superin.formativ.net/mono/mono.htm">Windows</a> (works without cygwin!)
+       </ul>
+
+* Snapshots
+
+<a name="snapshots">
+
+       <a href="http://www.go-mono.com/snapshots">Nightly snapshots</a> of 
+       the CVS repository are made every day at 10pm EST (Boston
+       Time).  These are not guaranteed to build, they are just a
+       snapshot of the tree.
+
+       The <a href="anoncvs.html">anoncvs</a> mirrors provided by
+       Hispalinux are updated every six hours.
+
+* Compiling with scripts
+
+       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 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. You should also take care of setting
+       the right environment variables as the PKG_CONFIG_FLAGS, etc.
+
+       The script will download required packages from
+       www.go-mono.com and do a cvs checkout of mono in the current
+       directory.  <b>IMPORTANT!:</b> The cvs server chosen defaults to 
+       anonymous cvs;
+       set your CVSROOT environment variable before running the script to
+       select a particular cvs server.
+
+<a name="install">
+** Building the software manually
+
+       You will need to obtain the Mono dependencies first: <a
+       href="http://www.gtk.org">glib 2.x</a> and 
+       <a href="http://www.freedesktop.org/software/pkgconfig">pkg-config</a>.
+
+*** Building on Linux
+
+       <ul>
+               Unpack the Mono runtime distribution:
+               <pre>
+               tar xzvf mono-X.XX.tar.gz
+               cd mono-X.XX
+               
+               </pre>
+               <p>
+
+               Then configure, compile and install:
+
+               <pre>
+               
+               ./configure --prefix=/usr/local
+               make
+               make install</pre>
+
+               This will give you a runtime, C# compiler and runtime
+               libraries.  
+
+               If you want to recompile the runtime and the compiler,
+               follow these steps, first unpack the MCS package:
+
+               <pre>
+               tar xzvf mcs-X.XX.tar.gz
+               
+               cd mcs-X.XX
+               </pre>
+
+               Then use the following command to compile and install:
+
+               <pre>
+               
+               make -f makefile.gnu install prefix=/usr/local
+               </pre>
+
+               You can change /usr/local to something else if you want.
+       </ul>
+       
+*** On Windows, to install and work on the compiler and the class libraries:
+
+**** Install Cygwin and the GNU build tools, Microsoft's .NET Framework SDK and the precompiled GLIB 2.0 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 /usr/local directory
+                 of your Cygwin installation.<br>
+                 Unzip the precompiled packages listed above.
+
+       </ul>
+       <ul>
+               
+               * If you downloaded the Mono 
+               <a href="http://www.go-mono.com/snapshots">nightly snapshot
+               </a>, untar the snapshot.
+
+               * Change directories to "mcs".
+
+               * Compile:
+               
+               <pre>
+               make
+               </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 "mono".
+
+               * Configure, compile and install:
+               <pre>
+               ./configure --prefix=c:/mono
+               make
+               make install
+               </pre>
+
+       </ul>
+
+* Software resources and notes
+
+               The required and additional software can be downloaded here:
+
+               * 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 2.0 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><br>
+                 <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> <br>
+                 <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> <br>
+                 <a href="http://www.go-mono.com/archive/libiconv-1.7.zip">http://www.go-mono.com/archive/libiconv-1.7.zip</a> <br>
+                 <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> <br>
+                 <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><br>
+
+
+               * 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>
+
+
+*** Notes on compiling GLIB 2.0 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>
+tar xzvf pkg-config-0.8.0.tar.gz
+cd pkg-config-0.8.0
+./configure --prefix=/usr
+make
+make install
+</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/v2.0/glib-2.0.6.tar.gz">
+                 glib 2.0</a> from source.
+
+       </ul>