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         In order to make mcs and the class libraries you will need a computer
  14         running Windows with the <strong>GNU make tools</strong> from the
  15         <strong>Cygwin</strong> environment, <strong>Microsoft's .NET Framework
  16         SDK</strong>, <strong>GLIB 2.0</strong> and
  17         <strong>pkg-config</strong>.
  18
  19         When installing Cygwin, don't forget to include
  20         <tt>mingw-runtime</tt>. If you omit this, you will encounter
  21         configure problems regarding not being able to generate
  22         executables.
  23
  24 <a name="sources">
  25 *** Sources
  26
  27         Stay up to date on the Mono team's development using the
  28         <a href="http://lists.ximian.com/mailman/listinfo/mono-cvs-list">
  29         mono-cvs-list</a> mailing list.  The CVS source code can also
  30         be browsed <a href="http://cvs.hispalinux.es/cgi-bin/cvsweb/?cvsroot=Mono#dirlist">here</a>
  31
  32 <a name="jun-7">
  33         <b>Mono 0.12</b>
  34
  35         New packaged versions of the Mono C# compiler and Mono runtime
  36         are now available.  The latest version is 0.12.
  37
  38         <ul>
  39                 * <a href="archive/mono-0.12">Mono 0.12 release notes</a>
  40
  41                 * <a href="archive/mcs-0.12.tar.gz">mcs-0.12.tar.gz</a>
  42                 Mono C# compiler with class library source code.
  43
  44                 * <a href="archive/mono-0.12.tar.gz">mono-0.12.tar.gz</a>
  45                 Mono runtime.
  46         </ul>
  47
  48 * Snapshots
  49
  50         Volunteers package up daily the sources:
  51
  52         <ul>
  53                 * <a href="http://www.atoker.com/mono">Debian Linux</a>
  54                 * <a href="http://mono.baselabs.org/index.php/software">Red Hat Linux</a>
  55                 * <a href="http://www.superin.formativ.net/mono/mono.htm">Windows</a> (works without cygwin!)
  56         </ul>
  57
  58 <a name="snapshots">
  59         For up to date sources, it is recommended that you use the Mono
  60         source code from either the
  61         <a href="http://www.go-mono.com/snapshots">nightly snapshots</a> or
  62         the <a href="anoncvs.html">Anonymous CVS</a>.  The nightly
  63         snapshots are done every night at 10pm EST (Boston Time).
  64
  65         The nightly snapshots are not guaranteed to build, but most of the
  66         time they should.  They should give you a window to see what we are
  67         up to.
  68
  69         You can download the GNU make tools and the Cygwin environment from
  70         <a href="http://www.cygwin.com">www.cygwin.com</a>.
  71
  72         You can download Microsoft's .NET Framework SDK from
  73         <a href="http://msdn.microsoft.com/downloads">
  74         msdn.microsoft.com/downloads</a>.
  75
  76         There are scripts to help build mono for both Unix and Windows.  Get
  77         <a href="mono-build.sh">mono-build.sh</a> for Unix, or <a
  78         href="mono-build-w32.sh">mono-build-w32.sh</a> for Windows.
  79         These scripts automate the installation of GLIB and pkgconfig
  80         (building from source on Unix, and using binary packages
  81         provided by the GIMP for Windows project on Windows.)  To use
  82         the script, follow these simple steps:
  83
  84         <ul>
  85                 * Save the script for your platform somewhere (e.g. /usr/local/bin)
  86                 * Make the script executable (i.e chmod 755 /usr/local/bin/mono-build.sh)
  87                 * Create a directory to hold the mono source, and the compiled binaries (e.g. mkdir ~/mono)
  88                 * Change to the new directory (i.e. cd ~/mono)
  89                 * run the script (i.e. /usr/local/bin/mono-build.sh)
  90         </ul>
  91
  92         The script requires wget on either platform, and building the
  93         software requires make, gcc, automake, autoconf, and libtool.
  94         You should install these packages from your distribution or
  95         with the cygwin installer.
  96
  97         The script will download required packages from
  98         www.go-mono.com and do a cvs checkout of mono in the current
  99         directory.  The cvs server chosen defaults to 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 *** Download the required software.
 112
 113         <ul>
 114
 115                 * Microsoft's .NET Framework SDK from
 116                   <a href="http://msdn.microsoft.com/downloads">
 117                   msdn.microsoft.com/downloads</a>.
 118
 119                 * Cygwin and the GNU Make tools from
 120                   <a href="http://www.cygwin.com">www.cygwin.com</a>.
 121                   Some people observed problems with autoconf 2.52. Installing
 122                   autoconf 2.13 helped in those cases.
 123
 124                 * Precompiled GLIB 1.3 and pkg-config packages (and
 125                   their dependencies) by the <a href="http://www.gimp.org/~tml/gimp/win32//index.html">GIMP for Windows</a> project from
 126                   <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>
 127                   <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>
 128                   <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>
 129                   <a href="http://www.go-mono.com/archive/libiconv-1.7.zip">http://www.go-mono.com/archive/libiconv-1.7.zip</a>
 130                   <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>
 131                   <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>
 132
 133                 * Download the Mono source code from the
 134                   <a href="#feb-11">packaged versions</a> or
 135                   the <a href="http://www.go-mono.com/snapshots">
 136                   nightly snapshots</a> or the <a href="anoncvs.html">
 137                   Anonymous CVS</a>.  The nightly snapshots are done every
 138                   night at 10pm EST (Boston Time). The nightly snapshots are
 139                   not guaranteed to build, but most of the time they should.
 140
 141
 142         </ul>
 143
 144
 145 *** Install Cygwin and the GNU build tools, Microsoft's .NET Framework SDK and the precompiled GLIB 1.3 and pkg-config libraries.
 146
 147         <ul>
 148
 149                 * Install <a href="http://www.cygwin.com">Cygwin</a>.
 150
 151                 * Install <a href="http://msdn.microsoft.com/downloads">
 152                   Microsoft .NET Framework SDK</a>.
 153
 154                 * Change to the <strong>/usr/local</strong> directory
 155                   of your Cygwin installation.<br>
 156                   Unzip the precompiled packages listed above.
 157
 158         </ul>
 159
 160 *** On Windows, to install and work on the compiler and the class libraries:
 161
 162         <ul>
 163
 164                 * If you downloaded the Mono
 165                   <a href="http://www.go-mono.com/snapshots">nightly snapshot
 166                   </a>, untar the snapshot.
 167
 168                 * Change directories to <strong>"mcs"</strong>.
 169
 170                 * Compile:
 171
 172 <pre>
 173 <strong>make windows</strong>
 174 </pre>
 175
 176         </ul>
 177
 178 *** On Windows, to compile the mono runtime:
 179
 180         <ul>
 181
 182                 * If you downloaded the Mono
 183                   <a href="http://www.go-mono.com/snapshots">nightly snapshot
 184                   </a>, untar the snapshot.
 185
 186                 * Change directories to <strong>"mono"</strong>.
 187
 188                 * Configure, compile and install:
 189
 190 <pre><strong>
 191 ./configure --prefix=c:/mono
 192 make
 193 make install
 194 </strong></pre>
 195
 196         </ul>
 197
 198 *** On Unix, to compile the mono runtime:
 199
 200         <ul>
 201
 202                 * Install <a href="http://www.freedesktop.org/software/pkgconfig">pkg-config</a>.
 203
 204                 * Install glib 1.3. You can download it
 205                   from <a href="ftp://ftp.gtk.org/pub/gtk/v1.3/glib-1.3.12.tar.gz">ftp.gtk.org</a>. Maybe you need
 206                   to modify your ACLOCAL_FLAGS for pkg-config, for example if
 207                   your install prefix is /usr/local:
 208 <pre>
 209 <strong>export ACLOCAL_FLAGS="-I /usr/local/share/aclocal"</strong>
 210 </pre>
 211
 212                 * If you downloaded the Mono
 213                   <a href="http://www.go-mono.com/snapshots">nightly snapshots
 214                   </a>, untar the snapshot.
 215
 216                 * Change directories to <strong>"mono"</strong>.
 217
 218                 * Configure, compile and install:
 219 <pre><strong>
 220 ./configure
 221 make
 222 make install</strong>
 223 </pre>
 224         </ul>
 225
 226 *** Notes on compiling GLIB 1.3 and pkg-config from source:
 227
 228
 229         <ul>
 230
 231                 * Some people observed problems with autoconf 2.52. Installing
 232                   autoconf 2.13 helped in those cases (don't forget to do a
 233                   `make maintainer-clean' after the update).
 234
 235                 * Download, compile and install <a href="http://www.freedesktop.org/software/pkgconfig">pkg-config</a> from source.
 236                   (I had to change line 674 of
 237                   <nobr><tt>pkg-config-0.8.0/glib-1.2.8/gstrfuncs.c</tt></nobr> from
 238                   <nobr><tt>extern char *strsignal (int sig);</tt></nobr> to
 239                   <nobr><tt>extern const char *strsignal (int sig);</tt></nobr>.
 240
 241 <pre><strong>
 242 tar xzvf pkg-config-0.8.0.tar.gz
 243 cd pkg-config-0.8.0
 244 ./configure --prefix=/usr
 245 make
 246 make install</strong>
 247 </pre>
 248
 249                 * Download, compile and install <a href="ftp://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.7.tar.gz">libiconv</a> from source.<br>
 250                   If you dont have MS Visual C/C++ 4.0 or 5.0 or 6.0 you can also try
 251                   the binary package available at <a
 252                   href="http://www.gimp.org/win32/libiconv-dev-20001007.zip">
 253                   http://www.gimp.org/win32/libiconv-dev-20001007.zip</a>.
 254
 255
 256                 * Download, compile and install the
 257                   <a href="ftp://ftp.gtk.org/pub/gtk/v1.3/glib-1.3.12.tar.gz">
 258                   glib 1.3</a> from source.
 259
 260         </ul>
 261
 262
 263 <a name="oldreleases">
 264
 265 *** Old releases.
 266
 267         <ul>
 268
 269         <ul>
 270         <a name="apr-24">
 271         <b>Mono 0.11; April 24, 2002</b>
 272                 * <a href="archive/mono-0.11">Mono 0.11 release notes</a>
 273
 274                 * <a href="archive/mcs-0.11.tar.gz">mcs-0.11.tar.gz</a>
 275                 Mono C# compiler
 276                 * <a href="archive/mono-0.11.tar.gz">mono-0.11.tar.gz</a>
 277                 Mono runtime
 278         </ul>
 279
 280         <ul>
 281         <a name="mar-27">
 282         <b>Mono 0.10; March 27, 2002</b>
 283                 * <a href="archive/mono-0.10">Mono 0.10 release notes</a>
 284                 * <a href="archive/mcs-0.10.tar.gz">mcs-0.10.tar.gz</a>
 285                 Mono C# compiler
 286                 * <a href="archive/mono-0.10.tar.gz">mono-0.10.tar.gz</a>
 287                 Mono runtime
 288         </ul>
 289
 290         <ul>
 291         <a name="feb-22">
 292         <b>Mono 0.9; February 22, 2002</b>
 293                 * <a href="archive/mono-0.9">Mono 0.9 release notes</a>
 294
 295                 * <a href="archive/mcs-0.9.tar.gz">mcs-0.9.tar.gz</a>
 296                 Mono C# compiler
 297                 * <a href="archive/mono-0.9.tar.gz">mono-0.9.tar.gz</a>
 298                 Mono runtime
 299         </ul>
 300
 301                 <a name="feb-11">
 302                 <b>February 11, 2002</b>
 303                 * <a href="archive/mcs-0.8.tar.gz">mcs-0.8.tar.gz</a>
 304                 Mono C# compiler
 305                 * <a href="archive/mono-0.8.tar.gz">mono-0.8.tar.gz</a>
 306                 Mono runtime
 307                 </ul>
 308
 309                 <a name="sep-18">
 310                 <b>September 18, 2001</b>
 311                 <ul>
 312                 * <a href="archive/mono-0.7.tar.gz">mono-0.7.tar.gz</a>: Mono Runtime 0.7 release.
 313                 * <a href="archive/mcs-0.7.tar.gz">mcs-0.7.tar.gz</a>: Mono Compiler and Classes 0.7 release.
 314                 * <a href="archive/mono-0.7">Release Notes.</a>
 315                 </ul>
 316
 317                 <a name="august-22">
 318                 <b>August 22, 2001</b>
 319                 <ul>
 320                 * <a href="archive/mono-0.6.tar.gz">mono-0.6.tar.gz</a>: Mono Runtime 0.6 release.
 321                 * <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.
 322                 * <a href="archive/mono-0.6">Release Notes.</a>
 323                 </ul>
 324
 325
 326                 <a name="july-29">
 327                 <b>July 29, 2001</b>
 328                 <ul>
 329                 * <a href="archive/mono-0.5.tar.gz">mono-0.5.tar.gz</a>: Mono Runtime 0.5 release.
 330                 * <a href="archive/mono-0.5">Release Notes.</a>
 331                 </ul>
 332
 333
 334                 <a name="july-22">
 335                 <b>July 22, 2001</b>
 336                 <ul>
 337                 * <a href="archive/mcs-22-Jul-2001.tar.gz">mcs-22-Jul-2001.tar.gz</a>: CVS snapshot.
 338                 * <a href="archive/mcs-Jul-22-Jul-19-2001.tar.gz">Differences since 19</a>: CVS snapshot.
 339                 * <a href="archive/mcs-22">Release Notes.</a>
 340                 </ul>
 341
 342                 <a name="july-19">
 343                 <b>July 19th, 2001</b>
 344                 <ul>
 345                 * <a href="archive/mcs-19-Jul-2001.tar.gz">mcs-19-Jul-2001.tar.gz</a>: CVS snapshot.
 346                 * <a href="archive/mcs-Jul-17-Jul-19-2001.tar.gz">Differences since 17</a>: CVS snapshot.
 347                 * <a href="archive/mcs-19">Release Notes.</a>
 348                 </ul>
 349
 350                 <a name="july-17">
 351                 <b>July 17th, 2001</b>
 352                 <ul>
 353                 * <a href="archive/mcs-17-Jul-2001.tar.gz">mcs-17-Jul-2001.tar.gz</a>: CVS snapshot.
 354                 * <a href="archive/mcs-Jul-15-Jul-17-2001.tar.gz">Differences since 15</a>: CVS snapshot.
 355                 * <a href="archive/mcs-17">Release Notes.</a>
 356                 </ul>
 357
 358                 <a name="july-15">
 359                 <b>July 15th, 2001</b>
 360                 <ul>
 361                 * <a href="archive/mcs-15-Jul-2001.tar.gz">mcs-15-Jul-2001.tar.gz</a>: CVS snapshot.
 362                 * <a href="archive/mono-0.4.tar.gz">mono-0.4.tar.gz</a>: Packaged Source Code.
 363                 * <a href="archive/mono-0.4">Release Notes.</a>
 364                 </ul>
 365
 366                 <a name="july-14">
 367                 <b>July 14th, 2001</b>
 368                 <ul>
 369                 * <a href="archive/mcs-12-Jul-2001.tar.gz">mcs-12-Jul-2001.tar.gz</a>: CVS snapshot.
 370                 * <a href="archive/mono-0.3.tar.gz">mono-0.3.tar.gz</a>: Packaged Source Code.
 371                 </ul>
 372
 373                 <a name="july-8">
 374                 <b>July 8th, 2001</b>
 375
 376                 <ul>
 377                 * <a href="archive/mcs-08-Jul-2001.tar.gz">mcs-08-Jul-2001.tar.gz</a>: CVS Snapshot
 378                 * <a href="archive/mono-08-Jul-2001.tar.gz">mono-08-Jul-2001.tar.gz</a>: CVS Snapshot
 379                 </ul>
 380         </ul>
 381