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