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