doc/download

   1 * Software Availability
   2
   3         The Virtual Execution System is available in package `mono'.
   4         Currently this contains a metadata library and the
   5         disassembler.  Please refer to our <a
   6         href="runtime.html">Runtime</a> description for more details
   7         on this part of the project.
   8
   9         The code for the C# compiler as well as the language error
  10         test suite and the class library are in the `mcs' package, we
  11         will move this later into `mono' itself.
  12
  13         <b>Note: (Beginners read!)</b> There are a couple of documents you
  14         should read before going ahead. You can reach them in the
  15         <a href="http://www.go-mono.org/mono-beginning.html">Resources/Beginning        section</a>. And the <a href="http://www.go-mono.org/faq.html">FAQ</a>
  16         and the <a href="http://geneura.ugr.es/~jaime/deploy/mono-common-problems.html">
  17         Mono Common Problems</a>. Might be useful too. Take the Mono Beginners
  18         HOWTO for your system and proceed as it's described there.
  19
  20
  21 <a name="sources">
  22 *** Sources
  23
  24         Stay up to date on the Mono team's development using the
  25         <a href="http://lists.ximian.com/mailman/listinfo/mono-cvs-list">
  26         mono-cvs-list</a> mailing list.  The CVS source code can also
  27         be browsed <a href="http://cvs.hispalinux.es/cgi-bin/cvsweb/?cvsroot=Mono#dirlist">here</a>
  28
  29 <a name="jun-7">
  30         <b>Mono 0.13</b>
  31
  32         New packaged versions of the Mono C# compiler and Mono runtime
  33         are now available.  The latest version is 0.13.
  34
  35         <ul>
  36                 * <a href="archive/mono-0.13">Mono 0.13 release notes</a>
  37
  38                 * <a href="archive/mcs-0.13.tar.gz">mcs-0.13.tar.gz</a>
  39                 Mono C# compiler with class library source code.
  40
  41                 * <a href="archive/mono-0.13.tar.gz">mono-0.13.tar.gz</a>
  42                 Mono runtime.
  43         </ul>
  44
  45 * Snapshots
  46
  47         Already daily volunteer's made binaries:
  48
  49         <ul>
  50                 * <a href="http://www.atoker.com/mono">Debian Linux</a>
  51
  52                 * <a href="http://noa.tm/mono/">Red Hat (and RPM based systems)</a>
  53                 * <a href="http://www.superin.formativ.net/mono/mono.htm">Windows</a> (works without cygwin!)
  54         </ul>
  55
  56         <b>Note1:</b> Don't look for the Mono BaseLabs RPMs; they are not providing it
  57         anymore.<br>
  58         <b>Note2:</b> You will find that you can get binaries for the gtk-sharp
  59         package too.
  60
  61 <a name="snapshots">
  62         For up to date sources, it is recommended that you use the Mono
  63         source code from either the
  64         <a href="http://www.go-mono.com/snapshots">nightly snapshots</a> or
  65         the <a href="anoncvs.html">Anonymous CVS</a>.  The nightly
  66         snapshots are done every night at 10pm EST (Boston Time).
  67         The anoncvs mirrors provided by Hispalinux are updated every six
  68         hours.
  69
  70         The nightly snapshots are not guaranteed to build, but most of the
  71         time they should.  They should give you a window to see what we are
  72         up to.
  73
  74         There are scripts to help build mono for both Unix and Windows.  Get
  75         <a href="mono-build.sh">mono-build.sh</a> for Unix, or <a
  76         href="mono-build-w32.sh">mono-build-w32.sh</a> for Windows.
  77         These scripts automate the installation of GLIB and pkgconfig
  78         (building from source on Unix, and using binary packages
  79         provided by the GIMP for Windows project on Windows.)  To use
  80         the script, follow these simple steps:
  81
  82         <ul>
  83                 * Save the script for your platform somewhere (e.g. /usr/local/bin)
  84                 * Make the script executable (i.e chmod 755 /usr/local/bin/mono-build.sh)
  85                 * Create a directory to hold the mono source, and the compiled binaries (e.g. mkdir ~/mono)
  86                 * Change to the new directory (i.e. cd ~/mono)
  87                 * run the script (i.e. /usr/local/bin/mono-build.sh)
  88         </ul>
  89
  90         The script requires wget on either platform, and building the
  91         software requires make, gcc, automake, autoconf, and libtool.
  92         You should install these packages from your distribution or
  93         with the cygwin installer. You should also take care of setting
  94         the right environment variables as the PKG_CONFIG_FLAGS, etc.
  95
  96         The script will download required packages from
  97         www.go-mono.com and do a cvs checkout of mono in the current
  98         directory.  <b>IMPORTANT!:</b> The cvs server chosen defaults to
  99         anonymous cvs;
 100         set your CVSROOT environment variable before running the script to
 101         select a particular cvs server.
 102
 103 ** Mono Regression Test Suite
 104
 105         You can get binaries for the Mono Regression Test Suite <a
 106         href="archive/mono-tests.tar.gz">here</a>
 107
 108 <a name="install">
 109 ** Building the software manually
 110
 111 *** Building on Linux
 112
 113         <ul>
 114
 115                 You can build mono and mcs in Linux but to do that be
 116                 sure to obtain the corlib.dll and install it before
 117                 trying to compile.
 118
 119                 In linux be sure you get <a href="http://www.gtk.org">glib2.0</a>
 120                 (>= 2.0.4, 2.0.6
 121                 recomended) and <a href="http://www.freedesktop.org/software/pkgconfig">pkg-config</a> 0.80.
 122                 Also the corresponding development packages for those as
 123                 well as the GNU Build Tools (make, autoconf...).
 124                 Then download the mono packages and compile them.
 125                 You must start compiling mcs and then mono.
 126                 Be sure you set all the environment variables before
 127                 compiling. You can use pkg-config --list-all to see
 128                 if you forgot to set some of them.
 129
 130                 Normally you should enter:
 131                 export ACLOCAL_FLAGS="-I /usr/local/share/aclocal"
 132                 if your install prefix is /usr/local.
 133
 134                 If you downloaded the Mono nightly snapshots, untar the
 135                 snapshot.
 136
 137                 Change directories to "<strong>mcs</strong>".
 138
 139                 Configure, compile and install:
 140
 141                 <pre>
 142                 <strong>./configure
 143                 make
 144                 make install</strong></pre>
 145
 146                 Do the same in the "<strong>mono</strong>" directory.
 147
 148
 149 *** On Windows, to install and work on the compiler and the class libraries:
 150
 151 **** Install Cygwin and the GNU build tools, Microsoft's .NET Framework SDK and the precompiled GLIB 2.0 and pkg-config libraries.
 152
 153         <ul>
 154
 155                 * Install <a href="http://www.cygwin.com">Cygwin</a>.
 156
 157                 * Install <a href="http://msdn.microsoft.com/downloads">
 158                   Microsoft .NET Framework SDK</a>.
 159
 160                 * Change to the <strong>/usr/local</strong> directory
 161                   of your Cygwin installation.<br>
 162                   Unzip the precompiled packages listed above.
 163
 164         </ul>
 165         <ul>
 166
 167                 * If you downloaded the Mono
 168                 <a href="http://www.go-mono.com/snapshots">nightly snapshot
 169                 </a>, untar the snapshot.
 170
 171                 * Change directories to <strong>"mcs"</strong>.
 172
 173                 * Compile:
 174
 175                 <pre>
 176                 <strong>make windows</strong>
 177                 </pre>
 178
 179 *** On Windows, to compile the mono runtime:
 180
 181         <ul>
 182
 183                 * If you downloaded the Mono
 184                   <a href="http://www.go-mono.com/snapshots">nightly snapshot
 185                   </a>, untar the snapshot.
 186
 187                 * Change directories to <strong>"mono"</strong>.
 188
 189                 * Configure, compile and install:
 190                 <pre><strong>
 191                 ./configure --prefix=c:/mono
 192                 make
 193                 make install
 194                 </strong></pre>
 195
 196         </ul>
 197
 198 * Software resources, notes and old releases:
 199
 200                 The required and additional software can be downloaded here:
 201
 202                 * Microsoft's .NET Framework SDK from
 203                   <a href="http://msdn.microsoft.com/downloads">
 204                   msdn.microsoft.com/downloads</a>.
 205
 206                 * Cygwin and the GNU Make tools from
 207                   <a href="http://www.cygwin.com">www.cygwin.com</a>.
 208                   Some people observed problems with autoconf 2.52. Installing
 209                   autoconf 2.13 helped in those cases.
 210
 211                 * Precompiled GLIB 2.0 and pkg-config packages (and
 212                   their dependencies) by the <a href="http://www.gimp.org/~tml/gimp/win32//index.html">GIMP for Windows</a> project from
 213                   <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>
 214                   <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>
 215                   <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>
 216                   <a href="http://www.go-mono.com/archive/libiconv-1.7.zip">http://www.go-mono.com/archive/libiconv-1.7.zip</a>
 217                   <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>
 218                   <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>
 219
 220                 * Download the Mono source code from the
 221                   <a href="#feb-11">packaged versions</a> or
 222                   the <a href="http://www.go-mono.com/snapshots">
 223                   nightly snapshots</a> or the <a href="anoncvs.html">
 224                   Anonymous CVS</a>.  The nightly snapshots are done every
 225                   night at 10pm EST (Boston Time). The nightly snapshots are
 226                   not guaranteed to build, but most of the time they should.
 227
 228
 229         </ul>
 230
 231
 232 *** Notes on compiling GLIB 2.0 and pkg-config from source:
 233
 234
 235         <ul>
 236
 237                 * Some people observed problems with autoconf 2.52. Installing
 238                   autoconf 2.13 helped in those cases (don't forget to do a
 239                   `make maintainer-clean' after the update).
 240
 241                 * Download, compile and install <a href="http://www.freedesktop.org/software/pkgconfig">pkg-config</a> from source.
 242                   (I had to change line 674 of
 243                   <nobr><tt>pkg-config-0.8.0/glib-1.2.8/gstrfuncs.c</tt></nobr> from
 244                   <nobr><tt>extern char *strsignal (int sig);</tt></nobr> to
 245                   <nobr><tt>extern const char *strsignal (int sig);</tt></nobr>.
 246
 247 <pre><strong>
 248 tar xzvf pkg-config-0.8.0.tar.gz
 249 cd pkg-config-0.8.0
 250 ./configure --prefix=/usr
 251 make
 252 make install</strong>
 253 </pre>
 254
 255                 * Download, compile and install <a href="ftp://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.7.tar.gz">libiconv</a> from source.<br>
 256                   If you dont have MS Visual C/C++ 4.0 or 5.0 or 6.0 you can also try
 257                   the binary package available at <a
 258                   href="http://www.gimp.org/win32/libiconv-dev-20001007.zip">
 259                   http://www.gimp.org/win32/libiconv-dev-20001007.zip</a>.
 260
 261
 262                 * Download, compile and install the
 263                   <a href="ftp://ftp.gtk.org/pub/gtk/v2.0/glib-2.0.6.tar.gz">
 264                   glib 2.0</a> from source.
 265
 266         </ul>
 267
 268
 269 <a name="oldreleases">
 270
 271 *** Old releases.
 272
 273         <ul>
 274
 275         <ul>
 276         <a name="apr-24">
 277         <b>Mono 0.11; April 24, 2002</b>
 278                 * <a href="archive/mono-0.11">Mono 0.11 release notes</a>
 279
 280                 * <a href="archive/mcs-0.11.tar.gz">mcs-0.11.tar.gz</a>
 281                 Mono C# compiler
 282                 * <a href="archive/mono-0.11.tar.gz">mono-0.11.tar.gz</a>
 283                 Mono runtime
 284         </ul>
 285
 286         <ul>
 287         <a name="mar-27">
 288         <b>Mono 0.10; March 27, 2002</b>
 289                 * <a href="archive/mono-0.10">Mono 0.10 release notes</a>
 290                 * <a href="archive/mcs-0.10.tar.gz">mcs-0.10.tar.gz</a>
 291                 Mono C# compiler
 292                 * <a href="archive/mono-0.10.tar.gz">mono-0.10.tar.gz</a>
 293                 Mono runtime
 294         </ul>
 295
 296         <ul>
 297         <a name="feb-22">
 298         <b>Mono 0.9; February 22, 2002</b>
 299                 * <a href="archive/mono-0.9">Mono 0.9 release notes</a>
 300
 301                 * <a href="archive/mcs-0.9.tar.gz">mcs-0.9.tar.gz</a>
 302                 Mono C# compiler
 303                 * <a href="archive/mono-0.9.tar.gz">mono-0.9.tar.gz</a>
 304                 Mono runtime
 305         </ul>
 306
 307                 <a name="feb-11">
 308                 <b>February 11, 2002</b>
 309                 * <a href="archive/mcs-0.8.tar.gz">mcs-0.8.tar.gz</a>
 310                 Mono C# compiler
 311                 * <a href="archive/mono-0.8.tar.gz">mono-0.8.tar.gz</a>
 312                 Mono runtime
 313                 </ul>
 314
 315                 <a name="sep-18">
 316                 <b>September 18, 2001</b>
 317                 <ul>
 318                 * <a href="archive/mono-0.7.tar.gz">mono-0.7.tar.gz</a>: Mono Runtime 0.7 release.
 319                 * <a href="archive/mcs-0.7.tar.gz">mcs-0.7.tar.gz</a>: Mono Compiler and Classes 0.7 release.
 320                 * <a href="archive/mono-0.7">Release Notes.</a>
 321                 </ul>
 322
 323                 <a name="august-22">
 324                 <b>August 22, 2001</b>
 325                 <ul>
 326                 * <a href="archive/mono-0.6.tar.gz">mono-0.6.tar.gz</a>: Mono Runtime 0.6 release.
 327                 * <a href="archive/mono-compiler-classes-0.6.tar.gz">mono-compiler-classes-0.6.tar.gz</a>: Mono Compiler and Classes 0.6 release.
 328                 * <a href="archive/mono-0.6">Release Notes.</a>
 329                 </ul>
 330
 331
 332                 <a name="july-29">
 333                 <b>July 29, 2001</b>
 334                 <ul>
 335                 * <a href="archive/mono-0.5.tar.gz">mono-0.5.tar.gz</a>: Mono Runtime 0.5 release.
 336                 * <a href="archive/mono-0.5">Release Notes.</a>
 337                 </ul>
 338
 339
 340                 <a name="july-22">
 341                 <b>July 22, 2001</b>
 342                 <ul>
 343                 * <a href="archive/mcs-22-Jul-2001.tar.gz">mcs-22-Jul-2001.tar.gz</a>: CVS snapshot.
 344                 * <a href="archive/mcs-Jul-22-Jul-19-2001.tar.gz">Differences since 19</a>: CVS snapshot.
 345                 * <a href="archive/mcs-22">Release Notes.</a>
 346                 </ul>
 347
 348                 <a name="july-19">
 349                 <b>July 19th, 2001</b>
 350                 <ul>
 351                 * <a href="archive/mcs-19-Jul-2001.tar.gz">mcs-19-Jul-2001.tar.gz</a>: CVS snapshot.
 352                 * <a href="archive/mcs-Jul-17-Jul-19-2001.tar.gz">Differences since 17</a>: CVS snapshot.
 353                 * <a href="archive/mcs-19">Release Notes.</a>
 354                 </ul>
 355
 356                 <a name="july-17">
 357                 <b>July 17th, 2001</b>
 358                 <ul>
 359                 * <a href="archive/mcs-17-Jul-2001.tar.gz">mcs-17-Jul-2001.tar.gz</a>: CVS snapshot.
 360                 * <a href="archive/mcs-Jul-15-Jul-17-2001.tar.gz">Differences since 15</a>: CVS snapshot.
 361                 * <a href="archive/mcs-17">Release Notes.</a>
 362                 </ul>
 363
 364                 <a name="july-15">
 365                 <b>July 15th, 2001</b>
 366                 <ul>
 367                 * <a href="archive/mcs-15-Jul-2001.tar.gz">mcs-15-Jul-2001.tar.gz</a>: CVS snapshot.
 368                 * <a href="archive/mono-0.4.tar.gz">mono-0.4.tar.gz</a>: Packaged Source Code.
 369                 * <a href="archive/mono-0.4">Release Notes.</a>
 370                 </ul>
 371
 372                 <a name="july-14">
 373                 <b>July 14th, 2001</b>
 374                 <ul>
 375                 * <a href="archive/mcs-12-Jul-2001.tar.gz">mcs-12-Jul-2001.tar.gz</a>: CVS snapshot.
 376                 * <a href="archive/mono-0.3.tar.gz">mono-0.3.tar.gz</a>: Packaged Source Code.
 377                 </ul>
 378
 379                 <a name="july-8">
 380                 <b>July 8th, 2001</b>
 381
 382                 <ul>
 383                 * <a href="archive/mcs-08-Jul-2001.tar.gz">mcs-08-Jul-2001.tar.gz</a>: CVS Snapshot
 384                 * <a href="archive/mono-08-Jul-2001.tar.gz">mono-08-Jul-2001.tar.gz</a>: CVS Snapshot
 385                 </ul>
 386         </ul>
 387