Add/update FAQ
[mono.git] / web / faq
1 <a href="#basics">Basics</a><br>
2 <a href="#ximian">The Ximian Role in the Mono project</a><br>
3 <a href="#gnome">Mono and GNOME</a><br>
4 <a href="#gui">Building GUI applications with Mono</a><br>
5 <a href="#msft">Mono and Microsoft</a><br>
6 <a href="#platforms">Mono platforms</a><br>
7 <a href="#compatibility">Compatibility</a></br>
8 <a href="#pnpproject">Mono and the Portable.NET Project</a><br>
9 <a href="#webservices">Web Services</a><br>
10 <a href="#asp">Mono and ASP.NET</a><br>
11 <a href="#ado">Mono and ADO.NET</a><br>
12 <a href="#monodoc">MonoDoc</a><br>
13 <a href="#devel">Development Tools and Issues</a><br>
14 <a href="#java">Mono and Java</a><br>
15 <a href="#extending">Extending Mono</a><br>
16 <a href="#portability">Portability</a><br>
17 <a href="#reuse">Reusing Existing Code</a><br>
18 <a href="#gcc">Mono and GCC</a><br>
19 <a href="#performance">Performance</a><br>
20 <a href="#licensing">Licensing</a><br>
21 <a href="#patents">Patents</a><br>
22 <a href="#etc">Miscellaneous Questions</a><br>
23 <a href="#problems">Mono Common Problems</a><br>
24
25 A <a
26 href="http://www.es.gnome.org/documentacion/articulos/mono-puf/mono-puf/">Spanish
27 translation</a> is also available
28
29 <a name="basics"></a>
30 ** Basics
31
32 Q: What is Mono exactly?
33
34 A: The Mono Project is an open development initiative sponsored by
35    Ximian that is working to develop an open source, Unix
36    version of the Microsoft .NET development platform.  Its objective
37    is to enable Unix developers to build and
38    deploy cross-platform .NET Applications.  The project will
39    implement various technologies developed by Microsoft that have now
40    been submitted to the ECMA for standardization.
41
42 Q: What is the difference between Mono and the .NET Initiative?
43
44 A: The ".NET Initiative" is a somewhat nebulous company-wide effort by
45    Microsoft, one part of which is a cross-platform development
46    framework.  Mono is an implementation of the development framework,
47    but not an implementation of anything else related to the .NET
48    Initiative, such as Passport, software-as-a-service, or
49    corporate re-branding.
50
51 Q: What technologies are included in Mono?
52
53 A: Mono contains a number of components useful for building new
54    software:
55
56         <ul>
57                 * A Common Language Infrastructure (CLI) virtual
58                   machine that contains a class loader, Just-in-time
59                   compiler, and a garbage collecting runtime.
60
61                 * A class library that can work with any language
62                   which works on the CLR.
63
64                 * A compiler for the C# language.  In the future we
65                   might work on other compilers that target the Common
66                   Language Runtime.
67         </ul>
68
69
70    Windows has compilers that target the virtual machine from <a
71    href="http://msdn.microsoft.com/net/thirdparty/default.asp#lang">a
72    number of languages:</a> Managed C++, Java Script, Eiffel,
73    Component Pascal, APL, Cobol, Perl, Python, Scheme,
74    Smalltalk, Standard ML, Haskell, Mercury and Oberon.
75
76    The CLR and the Common Type System (CTS) enables applications and
77    libraries to be written in a collection of different languages that
78    target the byte code
79
80    This means for example that if you define a class to do algebraic
81    manipulation in C#, that class can be reused from any other
82    language that supports the CLI.  You could create a class in C#,
83    subclass it in C++ and instantiate it in an Eiffel program. 
84
85    A single object system, threading system, class libraries, and
86    garbage collection system can be shared across all these languages.
87    
88 Q: Where can I find the specification for these technologies?
89
90 A: You can find the information here:
91  
92
93    C# <a href="http://www.ecma.ch/ecma1/STAND/ecma-334.htm">http://www.ecma.ch/ecma1/STAND/ecma-334.htm</a>
94
95    CLI <a href="http://www.ecma.ch/ecma1/STAND/ecma-335.htm">http://www.ecma.ch/ecma1/STAND/ecma-335.htm</a>
96
97 Q: Will you implement the .NET Framework SDK class libraries?
98
99 A: Yes, we will be implementing the APIs of the .NET Framework SDK
100    class libraries. 
101
102 Q: Will you offer an ECMA-compliant set of class libraries?
103
104 A: Eventually we will.  Our current focus is on inter-operating
105    with the Microsoft SDK, but we will also offer an ECMA compliant
106    set of libraries. 
107
108 Q: What does the name "Mono" mean?
109
110 A: Mono is the word for `monkey' in Spanish. We like monkeys.
111
112 Q: Is Mono usable?
113
114 A: The JIT engine is usable on Intel x86 machines.  An interpreter
115    can be used on other non-Intel x86 machines.  
116
117    The class libraries are mature enough to run some real applications
118    (the compiler for instance, and every day more and more applications
119    are natively developed with Mono).
120
121 Q: When will you ship it?
122
123 A: Different parts of Mono will achieve usability at different stages,
124    once we are comfortable with the compiler, we will release "Mono Core",
125    which contains everything needed to develop applications with the base
126    class libraries, this will happen soon and in the meantime you can 
127    download daily snapshots of our work. Also the full ASP.NET support is 
128    close to completion. 
129
130    Other higher level class libraries (ASP.NET, ADO.NET, WinForms) will
131    be released when they become stable. 
132
133 Q: When will Mono 1.0 ship?
134
135 A: We are planning on releasing Mono 1.0 (Mono Core) which will ship all the
136    components of Mono that are known to be stable in Q4 2003.
137
138    This release will lack System.Windows.Forms  and
139    Enterprise.Services, as they will not be production ready on this timeframe.
140
141    Mono 1.2 should come in Q2 2004 and include the missing components
142    libraries that will make Mono feature-compatible with .NET 1.0
143
144 Q: What major components will you include in Mono?
145
146 A: Hopefully everything that Microsoft ships on their Framework
147    (ADO.NET, ASP.NET, WinForms), and we encourage third party developers to 
148    create reusable components that work on both Mono and Windows.
149
150 Q: How can I contribute?
151
152 A: Check the <a href="contributing.html">contributing</a> section. 
153
154 Q: Aren't you just copying someone else's work?
155
156 A: We are interested in providing the best tools for programmers to
157    develop applications for Free Operating Systems.  We also want to help
158    provide the interoperability that will allow those systems to fit in
159    with other standards.
160
161    For more background, read the <a href="http://www.go-mono.com/rationale.html">Mono
162    Project white paper</a>.
163    the project.
164
165 Q: Miguel said once that Mono was being implemented in COBOL. Is that true?.
166
167 A: No. It was a joke.
168
169
170 <a name="ximian"></a> 
171
172 ** The Ximian Role in the Mono Project
173
174 Q: Why is Ximian working on .NET?
175
176 A: Ximian is interested in providing the best tools for programmers to
177    develop applications for Free Operating Systems.  
178
179    For more information, read the project <a
180    href="rationale.html">rationale</a> page.
181
182 Q: Will Ximian be able to take on a project of this size?  
183
184 A: Of course not. Ximian a supporter of the Mono project, but the only way
185    to implement something of this size is for the entire free software
186    community to get involved. Visit the <a href="contributing.html">contributing</a> 
187    page if you'd like to help out.
188
189 Q: What pieces will Ximian be working on?
190
191 A: We will devote most of our resources to work on the pieces which are
192    on the critical path to release a development and execution
193    environment. Once the project is at a stage where it is useful in
194    the real world, it will achieve a critical mass of developers to
195    improve it further.
196
197 Q: Will Ximian offer Mono commercially?
198
199 A: When Mono is ready to be shipped Ximian will offer a commercial
200    support and services for Mono. 
201
202 Q: Does Ximian provide consulting services around Mono?
203
204 A: Yes, Ximian does provide consulting services around Mono to
205    make it suitable to your needs.  Porting the runtime engine,
206    customizing it, working on specific classes or tuning the code
207    for your particular needs. 
208
209 Q: Will you wait until Mono is finished?
210
211 A: Mono will ship on various stages as they mature.  Some people
212    require only a subset of the technologies, those will ship first.
213
214    More advanced features will take more time to develop.  A support
215    time line will be available in June 2002.
216
217 <a name="gnome"></a> 
218 ** Mono and GNOME
219
220 Q: How is Mono related to GNOME?
221
222 A: In a number of ways.  This project was born out of the need of
223    providing improved tools for the GNOME community, and will use
224    existing components that have been developed for GNOME when they
225    are available.  For example, we plan to use Gtk+ and Libart to
226    implement Winforms and the Drawing2D API and are considering
227    GObject support.
228
229 Q: Has the GNOME Foundation or the GNOME team adopted Mono?
230
231 A: Mono is too new to be adopted by those groups. We hope that the
232    tools that we will provide will be adopted by free software
233    programmers including the GNOME Foundation members and the GNOME
234    project generally.
235
236 Q: Should GNOME programmers switch over to Mono now?
237
238 A: It is still far to early for discussions of "switching over."  No
239    pieces of Mono will be ready within the next six months, and a
240    complete implementation is roughly one year away.
241
242    We encourage GNOME developers to continue using the existing tools,
243    libraries and components.  Improvements made to GNOME will have an
244    impact on Mono, as they would be the "back-end" for various classes.
245
246 Q: Will Mono include compatibility with Bonobo components? What is the
247    relationship between Mono and Bonobo?
248
249 A: Yes, we will provide a set of classes for implementing and using
250    Bonobo components from within Mono.  Mono should allow you to write
251    Bonobo components more easily, just like .NET on Windows allows you
252    to export .NET components to COM.
253
254 Q: Does Mono depend on GNOME?
255
256 A: No, Mono does not depend on GNOME.  We use a few packages produced by
257    the GNOME team like the `glib' library.  
258
259 Q: But will I be able to build GNOME applications?
260
261 A: Yes, we will enable people to write GNOME applications using Mono.
262
263 Q: Do you have C# bindings for GNOME?.
264
265 A: Yes, we currently bind libgnome, libgnomecanvas, and libgnomeui --
266    although I dare say I have no idea how functional the bindings are
267    outside of what I tested in the sample app. I imagine other libraries 
268    under the GNOME framework will be added on an as-needed (and as-requested) 
269    basis...although a truly good bonobo binding will have to wait on the CORBA 
270    remoting support which has been started recently.
271
272 <a name="gui"></a>
273 ** GUI applications
274
275 Q: Will Mono enable GUI applications to be authored?
276
277 A: Yes, you will be able to build GUI applications.  Indeed, that is our
278    main focus.  We will provide both the Windows.Forms API and the Gtk# API.
279
280 Q: What is the difference between Gtk# and System.Windows.Forms?
281
282 A: Gtk# is a set of bindings for the Gtk+ toolkit for C# (and other
283    CIL-enabled languages).  System.Windows.Forms is an API defined
284    by Microsoft to build GUI applications.
285
286 Q: Why not implement System.Windows.Forms on top of Gtk# or Qt#?
287
288 A: There are several reasons for this.
289
290    First of all, Gtk+ and Qt are standard toolkits on Linux, and their
291    proponents want to use their favorite toolkits when writing
292    applications.
293   
294    Related to this is the idea that System.Windows.Forms is 
295    brain-dead in certain areas, such as internationalization.  
296    System.Windows.Forms uses explicit sizes for all controls, as opposed 
297    to Gtk+ and Qt which use a box/packing model, which can better deal with 
298    the different string lengths different languages will have.
299   
300    Next is compatibility.  It is not possible to implement 
301    System.Windows.Forms on top of Gtk+/Qt and have 100% compatibility, 
302    because System.Windows.Forms exposes some Win32-isms, such as the 
303    Win32 message loop.  In order to maintain compatibility, Wine must be used, 
304    and this is being done; see the 
305    <a href="/winforms.html">System.Windows.Forms effort page</a>.
306   
307    Additionally, Wine apps don't currently fit in -- visually -- with 
308    Gtk+ or Qt apps.
309
310 Q: Will I be able to run my smart clients on systems powered by Mono?
311
312 A: As long as your applications are 100% .NET and do not make use
313    of P/Invoke to call Win32 functions, your smart client applications
314    will run on Mono platforms.
315
316 Q: Where can I learn more about Gtk#?
317
318 A: The following <a href="http://gtk-sharp.sourceforge.net>link</a> sends you to the page of the project.
319
320 Q: What can I do with Gtk#?. 
321
322 A: Gtk# is becoming very usable and you can create applications and
323    applets like those you see in a GNOME desktop environment. It's 
324    easy to install so it's worth a try. 
325
326 Q: How can I compile my HelloWorld.cs which uses Gtk#?.
327
328 A: Try: mcs --unsafe -o HelloWorld.exe -r glib-sharp -r pango-sharp -r
329         atk-sharp -r gdk-sharp -r gtk-sharp -r gdk-imaging-sharp
330         HelloWorld.cs
331
332 Q: Is there any way how to connect DataAdapter to some GTK# controls?
333
334 A: There is a sample file called `DbClient' in gtk-sharp/samples that you
335    might to look at.  It is a sample program in Gtk# that adds/updates/deletes 
336    information on a Postgress database. When we have the new table/tree widgets, 
337    I am sure someone would write an adapter for System.Data (in Gtk2 the 
338    tree/list widgets are written using a view/model, so you only need to write 
339    a model that maps to the database). You can have a look at 
340    gtk-sharp/sample/DbClient, where there is a GTK# application that uses 
341    System.Data. It does not use DataAdapter, but DataReader though.
342
343 Q: Do you have an estimate for when Windows.Forms will be released?
344
345 A: We do not know, volunteers are working on this, but there is no set
346    date yet.  The current approach is using the Wine Library to implement
347    it.
348
349 <a name="msft"></a>
350 ** Mono and Microsoft
351
352 Q: Is Microsoft helping Ximian with this project?
353
354 A: There is no high level communication between Ximian and Microsoft
355    at this point, but engineers who work on .NET or the ECMA groups
356    have been very friendly, and very nice to answer our questions, or
357    clarify part of the specification for us. 
358
359    Microsoft is interested in other implementations of .NET and are
360    willing to help make the ECMA spec more accurate for this purpose.
361
362    Ximian was also invited to participate in the ECMA committee
363    meetings for C# and the CLI.
364
365 Q: Is Microsoft or Corel paying Ximian to do this?
366
367 A: No.
368
369 Q: Do you fear that Microsoft will change the spec and render Mono
370    useless?
371
372 A: No.  Microsoft proved with the CLI and the C# language that it was
373    possible to create a powerful foundation for many languages to
374    inter-operate.  We will always have that.  
375
376    Even if changes happened in the platform which were undocumented,
377    the existing platform would a value on its own.
378
379 Q: Are you writing Mono from the ECMA specs?
380
381 A: Yes, we are writing them from the ECMA specs and the published
382    materials in print about .NET.
383
384 Q: If my applications use Mono, will I have to pay a service fee?
385
386 A: No.  Mono is not related to Microsoft's initiative of
387    software-as-a-service.
388
389 Q: Is the Mono Project is related to the Microsoft Hailstorm effort?  Is
390    Ximian endorsing Hailstorm?  
391
392 A: No.  The Mono Project is focused on providing a compatible set of
393    tools for the Microsoft .NET development platform.  It does not
394    address, require, or otherwise endorse the MS Passport-based
395    Hailstorm single sign-on system that is part of Windows XP and
396    other services.
397
398 Q: Will Mono or .NET applications depend on Microsoft Passport?
399
400 A: No. MS Passport is unrelated to running .NET compatible applications
401    produced with the Mono tools.  The only thing you will need is a
402    just-in-time compiler (JIT).
403
404 Q: If Microsoft will release a port of their .NET platform under the
405    `Shared Source' license, why should I bother with anything else?
406
407 A: The Shared Source implementation will be expensive and its uses
408    will be tightly restricted, especially for commercial use. We are
409    working towards an implementation that will grant a number of
410    important rights to recipients: use for any purpose,
411    redistribution, modification, and redistribution of modifications.
412
413    This is what we call <a
414    href="http://www.gnu.org/philosophy/free-sw.html">Free Software</a>
415
416 Q: Is Mono a free implementation of Passport?
417
418 A: No. Mono is just a runtime, a compiler and a set of class
419    libraries.
420
421 Q: Will the System.Web.Security.PassportIdentity class mean
422    that my software will depend on Passport?
423    
424 A: No.  Applications may use that API to contact a Passport site, but
425    are not required to do so.
426
427    As long as your application does not use Passport, you will not
428    need Passport.  
429
430 Q: Will Mono running on Linux make Passport available for Linux?
431
432 A: No.  However, the Passport toolkit for Linux-based web servers is
433    available from Microsoft.
434
435 Q: Will Mono allow me to run Microsoft Office on Linux?
436
437 A: No, it will not.  Microsoft Office is a Windows application.  To
438    learn more about running Windows applications on Intel Unix systems
439    refer to <a href="http://www.winehq.com">the Wine Project</a>.
440
441 Q: Can mono run the WebMatrix?
442
443 A: No. That requires System.Windows.Forms support which is not
444    currently implemented.
445
446 Q: Does mono have something like Passport? 
447    Will mono have a server side Passport/Similar framework for XSP as well as client classes?
448
449 A: Not yet, but the client side API for authentication is not the problem. 
450    We will likely have a lot of other authentication APIs, like the Liberty
451    Alliance APIs. The problem is people on the web provider end that might use 
452    this for authentication.
453
454 <a name="platforms"></a>
455 ** Mono Platforms 
456
457 Q: What operating systems does Mono run on?
458
459 A: Mono is known to run on Linux, Unix and Windows systems.   
460
461 Q: What architectures does Mono support?
462
463 A: Mono today ships with a Just-in-Time compiler for x86-based
464    systems.  It is tested regularly on Linux, FreeBSD and Windows
465    (with the XP/NT core).
466
467    There is also an interpreter, which is slower that runs on the
468    s390, SPARC and PowerPC architectures.
469
470 Q: Can Mono run on Windows 9x, or ME editions?
471
472 A: Mono requires Unicode versions of Win32 APIs to run,
473    and only a handful of *W functions is supported under Win9x.
474
475    There is Microsoft Layer for Unicode that provides implementation
476    of these APIs on 9x systems.
477
478    Unfortunately it uses linker trick for delayed load that is not
479    supported by ld, so some sort of adapter is necessary.
480    
481    You will need MSLU and one of the following libs to link Mono to
482    unicows.dll <a
483    href="http://mono.eurosoft.od.ua/files/unimono.zip">http://mono.eurosoft.od.ua/files/unimono.zip</a>
484    or alternatively search the net for "libunicows".
485
486    No changes to Mono source code required, the only thing is to make
487    sure that linker will resolve imports to adapter library instead of
488    Win32 libs. This is achieved by inserting -lunimono before
489    -lkerner32/user32 in the linker's specs file.
490
491 <a name="compatibility"></a>
492 ** Compatibility
493
494 Q: Can Mono run applications developed with the Microsoft.NET framework?
495
496 A: Yes, Mono can run applications developed with the Microsoft .NET Framework
497    on Unix.  There are a few caveats to keep in mind: Mono has not
498    been completed yet, so a few API calls might be missing; And in
499    some cases the Mono behavior *might* be incorrect.
500
501 Q: Will missing API entry points be implemented?
502
503 A: Yes, the goal of Mono is to implement precisely the .NET Framework
504    API (as well as compile-time selectable subsets, for those
505    interested in a lighter version of Mono).
506
507 Q: If the behavior of an API call is different, will you fix it?
508
509 A: Yes, we will.  But we will need your assistance for this.  If you find a bug
510    in the Mono implementation, please fill a bug report in <a
511    href="http://bugzilla.ximian.com">http://bugzilla.ximian.com</a>.
512    Do not assume we know about the problem, we might not, and using the bug tracking
513    system helps us organize the development process.
514
515 Q: Can I develop my applications on Windows, and deploy on a supported
516    Mono platform (like Linux)?
517
518 A: Yes, you can.  
519
520    As of today, Mono is not 100% finished, so it is sometimes useful
521    to compile the code with Mono, to find out if your application
522    depends on unimplemented functionality. 
523
524 Q: Will applications run out the box with Mono?
525
526 A: Sometimes they will.  But sometimes a .NET application might invoke
527    Win32 API calls, or assume certain patterns that are not correct
528    for cross-platform applications.
529
530 Q: What is a 100% .NET application?
531
532 A: A `100% .NET application' is one that only uses the APIs defined
533    under the System namespace and does not use P/Invoke.  These
534    applications would in theory run unmodified on Windows, Linux,
535    HP-UX, Solaris, MacOS X and others. 
536
537    Note that this requirement also holds for all assemblies used by the
538    application.  If one of them is Windows-specific, then the entire program
539    is not a 100% .NET application.
540
541    Furthermore, a 100% .NET application must not contain non-standard data
542    streams in the assembly.  For example, Visual Studio .NET will insert a 
543    <tt>#-</tt> stream into assemblies built under the "Debug" target.  
544    This stream contains debugging information for use by Visual Studio .NET; 
545    however, this stream can not be interpreted by Mono (unless you're willing 
546    to donate support).
547
548    Thus, it is recommended that all Visual Studio .NET-compiled code be
549    compiled under the Release target before it is executed under Mono.
550
551 Q: Can I execute my Visual Studio .NET program (Visual Basic .NET, Visual C#,
552    Managed Extensions for C++, etc.) under Mono?
553
554 A: Yes, with some reservations.
555
556    The .NET program must either be a 100% .NET application, or (somehow) have
557    all dependent assemblies available on all desired platforms.  (How to do so
558    is outside the bounds of this FAQ.)
559
560    For example, since Mono's System.Windows.Forms implementation will use
561    Wine, System.Windows.Forms is only as portable as Wine is.  It's possible
562    that Mono may run on a platform, but Wine will not, in which case a
563    System.Windows.Forms app will not run on that platform.  This is similarly
564    true for all assemblies that are not 100% managed code.
565
566    Mono must also have an implementation for the .NET assemblies used.  For
567    example the System.EnterpriseServices namespace is part of .NET, but it
568    has not been implemented in Mono.  Thus, any applications using this
569    namespace will not run under Mono.
570
571    With regards to languages, C# applications tend to be most portable.
572
573    Visual Basic .NET applications are portable, but Mono's 
574    Microsoft.VisualBasic.dll implementation is incomplete.  It is recommended 
575    to either avoid using this assembly in your own code, only use the 
576    portions that Mono has implemented, or to help implement the missing
577    features.
578
579    Managed Extensions for C++ is least likely to operate under Mono.  Mono
580    does not support mixed mode assemblies (that is, assemblies containing both
581    managed and unmanaged code, which Managed C++ can produce).  You need a
582    fully-managed assembly to run under Mono, and getting the Visual C++ .NET
583    compiler to generate such an executable can be difficult.  You need to use
584    only the .NET-framework assemblies, not the C libraries (you can't use
585    <b>printf</b>(3) for example.), and you need to use
586    the linker options <tt>/nodefaultlib /entry:main mscoree.lib</tt> in
587    addition to the <tt>/clr</tt> compiler flag.  You can still use certain
588    compiler intrinsic functions (such as <b>memcpy</b>(3)) and the STL.
589    You should also see <a 
590    href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vcmex/html/vcgrfconvertingmanagedextensionsforcprojectsfrommixed-modetopureil.asp"
591    >Converting Managed Extensions for C++ Projects from Mixed Mode to Pure
592    Intermediate Language</a> at MSDN.
593    Finally, you can use PEVERIFY.EXE from the .NET SDK to determine if the 
594    assembly is fully managed.
595
596    Thanks to Serge Chaban for the linker flags to use.
597
598 <a name="pnpproject"></a>
599 ** Mono and Portable.NET
600
601 Q: What are the differences between Mono and Portable.NET?
602
603 A: Most of Mono is being written using C#, with only
604    a few parts written in C (The JIT engine, the runtime, the
605    interfaces to the garbage collection system).  
606
607    It is easier to describe what is unique about Mono:
608    <ul>
609      <li> An advanced native-code compilation engine: Both
610           just-in-time compilation (JIT) and pre-compilation of CIL
611           bytecodes into native code are supported.
612
613      <li> A foundation for code optimization: The new code generator in
614           Mono builds on the experience of our first JIT engine, and enables
615           us to implement various advanced compiler optimization
616           tricks.  With an SSA-framework, plenty of new optimizations are possible. 
617
618           The current list of optimizations are: Peephole postpass,
619           Branch optimizations, Inline method calls, Constant folding, Constant
620           propagation, Copy propagation, Dead code elimination, Linear scan
621           global reg allocation, Conditional moves, Emit per-domain code,
622           Instruction scheduling, Intrinsic method implementations, Tail
623           recursion and tail calls, Loop related optimizations, Fast x86 FP
624           compares, Leaf procedures optimizations
625
626      <li> A self-hosting C# compiler written in C#, which is clean, easy
627           to maintain.
628
629      <li> Focus on the .NET Framework: we are tracking down the .NET
630           Framework API definition, as we believe it is the API people
631           will be most familiar with.
632
633      <li> A multi-platform runtime engine: both a JIT engine and an
634           interpreter exist.  The JIT engine runs currently on x86
635           systems, while the interpreter works on SPARC, StrongARM,
636           s390 and PowerPC systems.  
637
638           Our new compilation engine is being ported to the PowerPC.
639
640      <li> Supports Linux, BSD, Windows and Solaris at this point.
641
642      <li> The JIT engine is written using a portable instruction
643           selector which not only generates good code but
644           is also the foundation to re-target the JIT engine to other
645           systems.  
646
647      <li> Full support for remoting in the runtime.
648
649      <li> The C# compiler, the JIT engine and the class libraries are
650           mature enough that the whole system has been self-hosting
651           since April 2002.  This means that we develop Mono
652           completely with itself at this point.
653
654           By forcing ourselves to use our own code to develop our
655           tools, we bug fix problems rapidly, and the system is
656           overall more robust and tested than if we did not.
657
658      <li> We have a great community of developers, without which Mono
659           would not be possible.
660    </ul>
661
662    In general, Mono is more mature and complete since it has been used
663    to develop itself, which is a big motivator for stability and
664    correctness, while Portable.NET remains pretty much an untested
665    platform.
666
667 Q: I hear Mono keeps changing the P/Invoke API, why?
668
669 A: We are just fixing our implementation to be compatible with the
670    Microsoft implementation.  In other words, the Mono P/Invoke API is
671    more complete when compared to the Portable.NET version, hence
672    various pieces of software that depend on this extended
673    functionality fail to work properly with Portable.NET.
674
675 <a name="webservices"></a>
676 ** Web Services
677
678 Q: How is Mono related to Web Services?
679
680 A: Mono is only related to Web Services in that it will implement the
681    same set of classes that have been authored in the .NET Framework
682    to simplify and streamline the process of building Web Services.
683
684    But most importantly, Mono is an Open Source implementation of the
685    .NET Framework.
686
687 Q: Can I author Web Services with Mono?
688
689 A: You will be able to write Web Services on .NET that run on Mono and
690    vice-versa. 
691
692 Q: If Mono implements the SDK classes, will I be able to write and
693    execute .NET Web Services with it?
694    
695 A: Yes.  When the project is finished, you will be able to use the
696    same technologies that are available through the .NET Framework SDK
697    on Windows to write Web Services.
698
699 Q: What about Soup?  Can I use Soup without Mono?
700
701 A: Soup is a library for GNOME applications to create SOAP servers and
702    SOAP clients, and can be used without Mono.  You can browse the
703    source code for soup using <a
704    href="http://cvs.gnome.org/bonsai">GNOME's Bonsai</a>.
705
706 Q: Can I use CORBA?
707
708 A: Yes. The CLI contains enough information about a class that
709    exposing it to other RPC systems (like CORBA) is really simple, and
710    does not even require support from an object.  
711
712    <a href="http://remoting-corba.sourceforge.net/">Remoting.CORBA</a> is
713    a CORBA implementation that is gaining momentum.
714
715    Building an implementation of the Bonobo interfaces once this is ready
716    should be relatively simple. 
717
718 Q: Can I serialize my objects to other things other than XML?
719
720 A: Yes, although the serializing tools have not yet been planned, and
721    you would probably have to implement them yourself.
722
723 Q: Will Mono use ORBit?
724
725 A: There are a few advantages in using ORBit, like reusing existing code
726    and leveraging all the work done on it.  Michael Meeks has posted
727    a few <a href="http://lists.ximian.com/archives/public/mono-list/2002-September/008592.html">reasons</a>,
728    as well as some <a href="http://lists.ximian.com/archives/public/mono-list/2002-September/008657.html">ideas</a>
729    that could be used to reuse ORBit.
730
731    Most users are likely to choose a native .NET solution, like <a href="http://cvs.gnome.org/bonsai">Remoting.CORBA</a>
732
733
734 <a name="monodoc"></a>
735 ** MonoDoc
736
737 Q: What is MonoDoc?
738
739 A: MonoDoc is a graphical documentation browser for the Mono class
740    libraries. Currently, monodoc consists of a Gtk# application and is
741    in heavy development.
742
743 <a name="devel"></a>
744 ** Development Tools and Issues
745
746 Q: I am having trouble compiling a new version of Mono from CVS, it 
747    complains about my runtime being out of sync.
748
749 A: Jonathan Pryor has provided the following answer:
750
751    To upgrade your class libraries and compiler, see the See
752    README.building in the MCS directory.
753
754    The single biggest source of confusion seems to be the "Your
755    runtime is out of sync" messages.  Realize that this is *normal*
756    while BUILDING.  Think about it: you're building a new class
757    library with the old runtime.  If the new class library references
758    a function that the old runtime knows nothing about, the runtime
759    system issues this warning.
760
761    Basically what needs to happen is for a new mono runtime to be
762    compiled, then the corlib class library be compiled, and once this
763    is done, install the new runtime, followed by corlib.
764
765    Once this is done, you can continue building your entire
766    environment.
767
768 Q: Will it be possible to use the CLI features without using byte codes
769    or the JIT?
770
771 A: Yes. The CLI engine will be made available as a shared library.
772    The garbage collection engine, the threading abstraction, the
773    object system, the dynamic type code system and the JIT will be
774    available for C developers to integrate with their applications if
775    they wish to do so. 
776
777 Q: Will you have new development tools?
778
779 A: With any luck, Free Software enthusiasts will contribute tools to
780    improve the developer environment.  These tools could be developed
781    initially using the Microsoft implementation of the CLI and then
782    executed later with Mono.
783
784    We are recommending people to use and contribute to existing
785    projects like SharpDevelop, Anjuta and Eclipse.
786
787 Q: What kind of rules make the Common Intermediate Language useful for
788    JITers?
789
790 A: The main rule is that the stack in the CLI is not a general purpose
791    stack.   You are not allowed to use it for other purposes than
792    computing values and passing arguments to functions or return
793    values.  
794
795    At any given call or return instruction, the types on the stack
796    have to be the same independently of the flow of execution of your
797    code. 
798
799 Q: Is it true that the CIL is ideal for JITing and not efficient for
800    interpreters?
801
802 A: The CIL is better suited to be JITed than JVM byte codes, but you
803    can interpret them as trivially as you can interpret JVM byte
804    codes. 
805
806 Q: Isn't it a little bit confusing to have the name of "XSP" (the same 
807    as in the Apache Project) for the ASP.NET support in Mono?.
808
809 A: In Mono, xsp is just the name of the C# code generator for ASP.NET 
810    pages. In the Apache Project, it is a term for the "eXtensible Server 
811    Pages" technology so as they are very different things, they don't 
812    conflict.
813
814 Q: Is there any plan to develop an aspx server for Mono?.
815
816 A: The XSP reference server is available and you can also use mod_mono
817    with Apache.
818
819 Q: Is there any way I can develop the class libraries using Linux yet?
820
821 A: Yes.  Mono has been self hosting since May 2002.
822
823 Q: Is there any way I can install a known working copy of mono in /usr, 
824    and an experimental copy somewhere else, and have both copies use 
825    their own libraries? (I'm still not very good at library paths in 
826    Linux)
827
828 A: Yes. Just use two installation prefixes.
829
830 Q: How should I write tests or a tests suite?
831
832 A: If you do a test suite for C#, you might want to keep it 
833    independent of the Mono C# compiler, so that other compiler 
834    implementations can later use it.  
835
836 Q: Would it be too terrible to have another corlib signed as mscorlib? 
837
838 A: We rename corlib to mscorlib also when saving the PE files, in fact, 
839    the runtime can execute program created by mono just fine.  
840
841 Q: Is it possible to build a C# file to some sort of intermediate format which 
842    can linked into a final module, like the traditional .c -> .o -> .so path? 
843    
844 A: You can use: 
845
846         mcs /target:library file1.cs, mcs /target:library file2.cs, 
847         mcs /target:exe file1.dll file2.dll /out:mybin.exe
848
849 Q: Is there any plans for implementing remoting in the near future?
850
851 A: The remoting infrastructure is in place.  We have implementations
852    of the TcpChannel, HttpChannel and the Soap and Binary Formatters.
853    They are compatible with .NET.
854
855    However, some classes from the library may have a different binary
856    representation, because they may have a different internal data
857    structure, so for example you won't be able to exchange a Hastable
858    object between Mono and MS.NET. It should not be a problem if you
859    are using primitive types, arrays or your own classes. In any case,
860    could you post a test case?
861
862
863 Q: My C code uses the __stdcall which is not availble on Linux, how can I
864    make the code portable Windows/Unix across platforms?
865
866 A: Replace the __stdcall attribute with the STDCALL macro, and include this
867    in your C code for newer gcc versions:
868
869         #ifndef STDCALL
870         #define STDCALL __attribute__((stdcall))
871         #endif
872
873 Q: I want to be able to execute Mono binaries, without having to use the "mono"
874    command.  How can I do this?
875
876 A: From Carlos Perelló:
877
878    <i>I think that the best solution is the binfmt feature with the
879    wrapper that exists with Debian packages at:
880
881    <a href="http://www.debianplanet.org/mono/dists/unstable/main/source/admin/">http://www.debianplanet.org/mono/dists/unstable/main/source/admin/</a>
882
883    If you want use it with Big endian machines, you should apply a patch
884    (<a href="http://carlos.pemas.net/debian/mono/binfmt-detector-cli.c.diff">http://carlos.pemas.net/debian/mono/binfmt-detector-cli.c.diff</a>)
885
886    It works really good and lets you use wine also, it reads the .exe file
887    headers and check if it's a .net executable.
888
889    This way you just execute: ./my-cool-mono-application.exe and it works
890    without the need of any wrapper.</i>
891
892 Q: I see funny characters when I run programs, what is the problem?
893
894 A: (From Peter Williams and Gonzalo Paniagua):
895
896    This is Red Hat 9 (probably) using UTF8 on its console; the bytes are
897    the UTF8 endianness markers.   You can do:
898  
899          LC_ALL=C mono myexe.exe
900
901    And they wont show up.
902
903    Alternatively, you can do:
904
905         $ echo -e "\033%G"
906
907    to enable UTF-8 on the console.
908
909 <a name="asp">
910 ** Mono and ASP.NET
911
912 Q: Does Mono support ASP.NET?
913
914 A: Yes. 
915
916    Mono supports ASP.NET, we have shown an unmodified IBuySpy
917    installation running on Mono as well as various other programs.  You can
918    try it yourself downloading the XSP server. 
919
920 Q: Do I need install cygwin to work on ASP.NET in mono or Linux is enough since 
921    it is self host right now.
922
923 A: Linux is enough.
924
925 Q: How can I run ASP.NET-based applications with Mono?
926
927 A: You need the Mono runtime and a hosting web server.  Currently we distribute a 
928    small web server called `xsp' which is used to debug applications, or you can choose
929    to use Daniel's Apache 2 module.
930
931 Q: Any plan to make ASP.NET in mono works with Apache in Linux?.
932
933 A: Daniel has authored an Apache2 Module for Mono that hosts the ASP.NET runtime
934    and is available here: <a
935    href="http://apacheworld.org/modmono/">http://apacheworld.org/modmono/</a>
936
937 Q: Will you support Apache 1?
938
939 A: Modules developed for Apache 2 are not compatible with Apache 1.3
940    Daniel plans to support Apache 1.3 in the future but the current focus is on
941    Apache 2, because of the better support for threading and Windows.
942
943 Q: Can I run Apache 1 and Apache 2 on the same machine?
944
945    You can always keep a copy of Apache 2 running in parallel with your Apache
946    1.3 (either different port or using a reverse proxy).
947
948    You can also bind the two servers to different IP addresses on the
949    same physical machine.
950
951 <a name="ado">
952 ** Mono and ADO.NET
953
954 Q: What is the status of ADO.NET support?. Could I start migrating 
955    applications from MS.NET to Mono?.
956
957 A: You could start right now using the ADO.NET support in mono, of course,
958    if you want to help filling the missing gaps while you develop your app
959    :-) Well, what I mean is that we're not that far to having full ADO.NET
960    support in Mono, and we've got a lot of working things, so if we could
961    get more help, we'd finish it really soon :-)
962
963 Q: In developing the data architecture for the application are there and
964    objects I should stay away from in order to insure the smoothest possible
965    transition (minimum code rewrite) to Mono's ADO.NET implementation?  (For
966    example, strongly typed datasets versus untyped datasets, etc...)
967
968 A: We are implementing all the classes in Microsoft .NET's System.Data, so
969    you can be sure that things will work the same in Mono as with the Microsoft
970    implementation. 
971
972 Q: Does Mono can to connect to Sybase by using Mono.Data.*?
973
974 A: Yes. use Mono.Data.SybaseClient. First of all you have to create a
975    SybaseConnection, and then, from it, use it as any other
976    IDbConnection-based class.
977
978 <a name="java">
979 ** Mono and Java
980    
981 Q: Why don't you use Java?  After all, there are many languages that
982    target the Java VM.
983
984 A: You can get very good tools for doing Java development on free
985    systems right now.  <a href="http://www.redhat.com">Red Hat</a> has
986    contributed a <a href="http://gcc.gnu.org">GCC</a> <a
987    href="http://gcc.gnu.org/java">front-end for Java</a> that can take
988    Java sources or Java byte codes and generate native executables; <a
989    href="http://www.transvirtual.com">Transvirtual</a> has implemented
990    <a href="http://www.kaffe.org">Kaffe</a> a JIT engine for Java;
991    Intel also has a Java VM called <a
992    href="http://www.intel.com/research/mrl/orp">ORP</a>.
993
994    The JVM is not designed to be a general purpose virtual machine.
995    The Common Intermediate Language (CIL), on the other hand, is
996    designed to be a target for a
997    wide variety of programming languages, and has a set of rules
998    designed to be optimal for JITers.
999
1000 Q: Could Java target the CLI?
1001
1002 A: Yes, Java could target the CLI, Microsoft's J# compiler does that.
1003
1004    The <a href="http://weblog.ikvm.net/">IKVM</a> project builds a
1005    Java runtime that works on top of .NET and on top of Mono.  IKVM is
1006    essentially a JIT compiler that translates from JVM bytecodes into
1007    CIL instructions, and then lets the native JIT engine take over. 
1008
1009 Q: Is it possible to write a JVM byte code to CIL converter?
1010
1011 A: Yes, it is possible.  Here are a few starting point:
1012
1013         <ul>
1014                 * A byte code representation is really a flattened forest of
1015                   trees.  Look at the Mono JIT engine to see how we compute
1016                   the basic blocks (this is used to figure out the "trees").
1017
1018                   The forest is just an array of trees.
1019
1020                   Indeed, run the JIT engine with -d (mono -d prog.exe) and
1021                   you will see how these trees look like.
1022
1023                   You will have to do something similar for Java.
1024
1025                 * Each "forest of trees" has a meaning.  This meaning can now
1026                   be translated into the equivalent "meaning" in CLR-land.
1027         </ul>
1028
1029    See also the <a href="http://weblog.ikvm.net/">IKVM project</a>
1030
1031 Q: Could mono become a hybrid CIL/java platform?
1032
1033 A: No. It is quite far from the philosophy of the project. The idea of Mono 
1034    is, to have only _one_ VM, on which all can run. And if there existing a 
1035    binary-converter from Java-.class to IL and if there existing something 
1036    like J-Sharp on Mono, you can write programs in Java, which than can run 
1037    on Mono. You do not need two bindings (like your example: GTK-Sharp _and_ 
1038    Java-Gnome). You need only _one_ of it (GTK-Sharp). Thats the idea of Mono.
1039    An other point is, that there are no people, who use Open Source-JVMs. They 
1040    all prefer Suns original. But for Unix there don't exist a .NET-Framework. 
1041    So it is possible, that in the future Mono is the standard .NET for Unixes.
1042
1043 Q: Do you plan to implement a Javascript compiler?
1044
1045 A: Yes.  The beginnings of the JScript compiler can be found on CVS.
1046    Cesar coordinates this effort.
1047
1048 Q: Can Mono or .NET share system classes (loaded from mscore.dll and other 
1049    libs) or will it behave like Sun's Java VM?
1050
1051 A: What you can do with mono is to load different applications in their own
1052    application domain: this is a feature of the CLR that allows sandboxing
1053    applications inside a single process space. This is usualy exploited to
1054    compartmentalize different parts of the same app, but it can also be
1055    effectively used to reduce the startup and memory overhead.
1056    Using different appdomains the runtime representation of types and
1057    methods is shared across applications.
1058
1059 <a name="extending"></a>
1060 ** Extending Mono
1061
1062 Q: Would you allow other classes other than those in the
1063    specification?
1064
1065 A: Yes.  The Microsoft class collection is very big, but it is by no
1066    means complete.  It would be nice to have a port of `Camel' (the
1067    Mail API used by Evolution inspired by Java Mail) for Mono
1068    applications.  
1069
1070    You might also want to look into implementing CORBA for Mono.  Not
1071    only because it would be useful, but because it sounds like a fun
1072    thing to do, given the fact that the CLI is such a type rich
1073    system. 
1074
1075    For more information on extending Mono, see our <a
1076    href="ideas.html">ideas</a> page.
1077
1078 Q: Do you plan to Embrace and Extend .NET?
1079
1080 A: Embracing a good technology is good.  Extending technologies in
1081    incompatible ways is bad for the users, so we do not plan on 
1082    extending the technologies.
1083
1084    If you have innovative ideas, and want to create new classes, we 
1085    encourage you to make those classes operate correctly well in both
1086    Mono and .NET.
1087
1088    Today Mono ships with a number of extra libraries that were
1089    developed either by members of the Mono community, or other
1090    groups.  
1091
1092 Q: Is there any way I can develop the class libraries using Linux yet?
1093
1094 A: Yes.  Mono has been selfhosting since March 2002. 
1095
1096 Q: Is there any way I can install a known working copy of mono in /usr, 
1097    and an experimental copy somewhere else, and have both copies use 
1098    their own libraries? (I'm still not very good at library paths in 
1099    Linux)
1100
1101 A: Yes. Just use two installation prefixes.
1102
1103
1104 <a name="portability"></a>
1105 ** Portability
1106
1107 Q: Will Mono only work on Linux?
1108
1109 A: Currently, we are doing our work on Linux-based systems and
1110    Windows.  We do not expect many Linux-isms in the code, so it
1111    should be easy to port Mono to other UNIX variants.   
1112
1113 Q: What about Mono on non Linux-based systems?
1114
1115 A: Our main intention at Ximian is to be able to develop GNOME
1116    applications with Mono, but if you are interested in providing a
1117    port of the Winforms classes to other platforms (frame buffer or
1118    MacOS X for example), we would gladly integrate them, as long
1119    they are under an open source license.  
1120
1121 Q: What operating systems/CPUs do you support
1122
1123 A: Mono currently runs on Linux, Windows, Solaris and FreeBSD.
1124    There is a JIT engine available for x86 processors that can
1125    generate code and optimizations tailored for a particular CPU.
1126
1127    Interpreters exist for the SPARC, PowerPC and StrongARM CPUs.
1128
1129 Q: Does Mono run on Windows?
1130
1131 A: Yes.   You can get pre-compiled
1132    binaries from <a href="http://www.go-mono.com/download.html">http://www.go-mono.com/download.html</a>
1133
1134 Q: Does Mono run on Linux?
1135
1136 A: Yes.  You can get pre-compiled
1137    binaries from <a href="http://www.go-mono.com/download.html">http://www.go-mono.com/download.html</a>
1138
1139 Q: Will I require Cygwin to run mono?
1140
1141 A: No.  Cygwin is only required to build Mono.
1142
1143 Q: Will Mono depend on GNOME?
1144
1145 A: It will depend only if you are using a particular assembly (for
1146    example, for doing GUI applications).  If you are just interested
1147    in Mono for implementing a `Hello World Enterprise P2P Web
1148    Service', you will not need any GNOME components.
1149
1150 Q: Is anyone working on porting Mono to IA-64?
1151
1152 A: Nobody is working on such port.
1153
1154 Q: If I were about to start a Mono port to IA-64,would the same lburg code 
1155    generator work for IA-64 also? or anything else need to be used for code 
1156    generation(as the processor architecture is totally different from IA32)
1157
1158 A: The lburg approach can be use for any processor architecture. But you might
1159    think in another better approach.
1160
1161 Q: Do you plan to port Rhino to C#?.
1162
1163 A: Eto Demerzal has started a Rhino port to C#.
1164
1165 Q: Has anyone succeeded in building a Mac version of the C# environment. 
1166    If so can you explain how?  
1167
1168 A: You could try to check with the Darwin people, or the Fink people.
1169    Mono/C# is self hosting on Linux/PPC which is the hard part, so it
1170    should be relatively simple to get it to work on MacOS
1171
1172 <a name="reuse"></a>
1173 ** Reusing Existing Code
1174
1175 Q: What projects will you reuse or build upon?
1176
1177 A: We want to get Mono in the hands of programmers soon.  We are
1178    interested in reusing existing open source software.
1179
1180 Q: What about Intel's research JIT framework, ORP?
1181
1182 A: At this time, we are investigating whether we can use elements of
1183    ORP for Mono.   ORP is a research JIT engine that has a clearly
1184    defined API that splits the JIT from the GC system and the actual
1185    byte code implementation.
1186
1187    We are using some pieces of ORP (Their code generation interface)
1188    and we use it as a source of inspiration for optimizations.  Paolo
1189    and Dietmar consider ORP as being one of the best JIT engines out
1190    there (and their research work and papers are very useful if you are
1191    interested in JIT technology).
1192
1193 Q: What about using GNU Lightning?
1194
1195 A: We are not using GNU Lightning.  Our JIT is using an instruction
1196    selector based on tree-pattern matching, and a code generation
1197    interface that is very tied to the current architecture.
1198
1199 Q: Will I be able to use Microsoft SQL Server 2000 or will I need to switch
1200    to a specific Open Source Database. Will I need to recode?
1201
1202 A: There should not be any need to recode.
1203
1204 Q: What do I need to watch out for when programming in VB.NET so that I'm
1205    sure to be able to run those apps on Linux?
1206
1207 A: Not making any P/Invoke or DLL calls should and not using anything in
1208    the Microsoft.* namespaces should suffice. Also do not use any 
1209    Methods/Classes marked as "This type/method supports the .NET Framework 
1210    infrastructure and is not intended to be used directly from your code." 
1211    even if you know what these classes/methods do.
1212
1213 Q: Will built-in reporting be supported for crystal reports? This is a
1214    heavily used part of our system.
1215
1216 A: Probably not. Crystal Reports are propriety. Someone may try to emulate
1217    the behavior, but no-one has yet volunteered.
1218
1219 Q: Who about writing to the registry? As I understand it, Linux does not have
1220    a counterpart to the registry. Should I avoid relying on that feature?
1221
1222 A: Try to avoid it. Although there would be a emulation for registry in
1223    Mono too. GNOME does have a registry like mechanism for configuration. But
1224    Even if gnome has a configuration system similar to the registry, the keys 
1225    will not be equal, so you will probably end up having to do some runtime 
1226    detection, and depending on this load an assembly that has your 
1227    platform-specific hacks.
1228
1229 Q: System.Data.SqlClient with FreeTDS, will you port parts of these to C# and 
1230    use them?
1231
1232 A: if their license is compatible with mono's, yes, we'd think about porting 
1233    them. If not, we'll continue with the plan of using FreeTDS.
1234
1235 <a name="gcc"></a>
1236 ** Mono and GCC
1237
1238 Q: Are you working on a GCC front-end to C#? A GCC back-end that will
1239    generate CIL images? What about making a front-end to GCC that
1240    takes CIL images and generates native code?
1241
1242 A: We are currently seeking volunteers for those projects.
1243    Visit the <a href="contributing.html">contributing</a> section if
1244    you are interested.
1245
1246 Q: But would this work around the GPL in the GCC compiler and allow
1247    people to work on non-free front-ends?
1248
1249 A: People can already do this by targeting the JVM byte codes (there
1250    are about 130 compilers for various languages that target the JVM).
1251
1252 Q: Why are you writing a JIT engine instead of a front-end to GCC?
1253
1254 A: We want the JIT engine and runtime engine because they will be able
1255    to execute CIL executables generated on Windows, and so no recompilation 
1256    will be necessary.
1257
1258 <a name="performance"></a>
1259 ** Performance
1260
1261 Q: How fast will Mono be?
1262
1263 A: We can not predict the future, but a conservative estimate is that
1264    it would be at least `as fast as other JIT engines'.
1265
1266    We would like to ship various JIT engines with Mono, just like
1267    Microsoft has done with their .NET development platform. We could
1268    provide a faster, JIT for fast load times but lower performance,
1269    and an and an optimizing JIT that would be slower at generating
1270    code but produce more optimal output.
1271
1272    The CIL has some advantages over the Java byte code:  it is really
1273    an intermediate representation and there are a number of
1274    restrictions on how you can emit CIL code that simplify creating
1275    better JIT engines.
1276
1277    For example, on the CIL, the stack is not really an abstraction
1278    available for the code generator to use at will.  Rather, it is a
1279    way of creating a postfix representation of the parsed tree.  At
1280    any given call point or return point, the contents of the stack are
1281    expected to contain the same object types independently of how the
1282    instruction was reached.
1283
1284 <a name="licensing"></a>
1285 ** Licensing
1286
1287 Q: Will I be able to write proprietary applications that run with
1288    Mono?
1289
1290 A: Yes.  The licensing scheme is planned to allow proprietary
1291    developers to write applications with Mono.
1292    
1293 Q: What license or licenses are you using for the Mono Project?
1294
1295 A: The C# Compiler is released under the terms of the <a 
1296    href="http://www.opensource.org/licenses/gpl-license.html">GNU GPL</a>.  The runtime
1297    libraries are under the <a
1298    href="http://www.opensource.org/licenses/lgpl-license.html">GNU
1299    Library GPL</a>.  And the class libraries are released
1300    under the terms of the <a
1301    href="http://www.opensource.org/licenses/mit-license.html">MIT X11</a>
1302    license.
1303
1304    The Mono runtime and the Mono C# Compiler are also available under
1305    a proprietary license for those who can not use the LGPL and the
1306    GPL in their code.  
1307
1308    For licensing details, contact <a
1309    href="mailto:mono-licensing@ximian.com">mono-licensing@ximian.com</a>
1310
1311
1312 Q: I would like to contribute code to Mono under a particular
1313    license. What licenses will you accept?
1314
1315 A: We will have to evaluate the licenses for compatibility first,
1316    but as a general rule, we will accept the code under the same
1317    terms of the "container" module. 
1318
1319 <a name="patents"></a>
1320 ** Patents
1321
1322 Q: Could patents be used to completely disable Mono (either submarine
1323    patents filed now, or changes made by Microsoft specifically to
1324    create patent problems)?
1325
1326 A: First some background information.
1327
1328    The .NET Framework is divided in two parts: the ECMA/ISO covered
1329    technologies and the other technologies developed on top of it like
1330    ADO.NET, ASP.NET and Windows.Forms.
1331
1332    Mono implements the ECMA/ISO covered parts, as well as being a
1333    project that aims to implement the higher level blocks like
1334    ASP.NET, ADO.NET and Windows.Forms.  
1335
1336    The Mono project has gone beyond both of those components and has
1337    developed and integrated third party class libraries, the most
1338    important being: Debugging APIs, integration with the Gnome
1339    platform (Accessibility, Pango rendering, Gdk/Gtk, Glade, GnomeUI),
1340    Mozilla, OpenGL, extensive database support (Microsoft only
1341    supports a couple of providers out of the box, while Mono has
1342    support for 11 different providers), our POSIX integration
1343    libraries and finally the embedded API (used to add scripting to
1344    applications and host the CLI, or for example as an embedded
1345    runtime in Apache). 
1346
1347    The core of the .NET Framework, and what has been patented by
1348    Microsoft falls under the ECMA/ISO submission.  Jim Miller at
1349    Microsoft has made a statement on the patents covering ISO/ECMA,
1350    (he is one of the inventors listed in the patent): <a
1351    href="https://mailserver.di.unipi.it/pipermail/dotnet-sscli/msg00218.html">here</a>.
1352
1353    Basically a grant is given to anyone who want to implement those
1354    components for free and for any purpose.
1355
1356    The controversial elements are the ASP.NET, ADO.NET and
1357    Windows.Forms subsets.  Those are convenient for people who need
1358    full compatibility with the Windows platform, but are not required
1359    for the open source Mono platform, nor integration with today's
1360    Mono's rich support of Linux. 
1361
1362    The Mono strategy for dealing with these technologies is as
1363    follows: (1) work around the patent by using a different
1364    implementation technique that retains the API, but changes the
1365    mechanism; if that is not possible, we would (2) remove the pieces
1366    of code that were covered by those patents, and also (3) find prior
1367    art that would render the patent useless.
1368  
1369    Not providing a patented capability would weaken the
1370    interoperability, but it would still provide the free software /
1371    open source software community with good development tools, which
1372    is the primary reason for developing Mono.  
1373
1374    The patents do not apply in countries where software patents are
1375    not allowed.
1376
1377    For Linux server and desktop development, we only need the ECMA
1378    components, and things that we have developed (like Gtk#) or Apache
1379    integration.  
1380
1381 <a name="etc"></a> 
1382 ** Miscellaneous Questions
1383
1384 Q: You say that the CLI allows multiple languages to execute on the
1385    same environment.  Isn't this the purpose of CORBA?
1386
1387 A: The key difference between CORBA (and COM) and the CLI is that the
1388    CLI allows "data-level interoperability" because every
1389    language/component uses the same data layout and memory management.
1390
1391    This means you can operate directly upon the data types that someone
1392    else provides, without having to go via their interfaces.  It also
1393    means you don't have to "marshal" (convert) parameters (data
1394    layouts are the same, so you can just pass components directly) and
1395    you don't have to worry about memory management, because all
1396    languages/components share the same garbage collector and address
1397    space.  This means much less copying and no need for reference
1398    counting.
1399
1400 Q: Will you support COM?
1401
1402 A: The runtime will support XPCOM on Unix systems and COM on Windows.
1403    Most of the code for dynamic trampolines exists already.
1404
1405 Q: Will Ximian offer certifications on Mono or related technologies?. 
1406
1407 A: It's possible. But there is no plan about this. So the short answer is no.
1408
1409 Q: Are there any Boehm's GC binaries?
1410
1411 A: Yes. You can find RPMs <a href="http://java.thn.htu.se/~toor/">here</a>, though
1412    if your distribution provides the correct packages, you should use those.
1413    The suggested version of the Boehm GC is 6.1.
1414
1415 Q: How can I report a bug?
1416
1417 A: The best thing is to track down the bug and provide a simple test to
1418    reproduce the bug. You can then add the bug to the 
1419    <a href="http://bugzilla.ximian.com/enter_bug.cgi">bugtracking system</a>.
1420
1421    Please provide information about what version of mono you're using
1422    and any relevant details to be able to reproduce the bug. Note that
1423    bugs reported on the mailing-list may be easily forgotten, so it's
1424    better to file them in the <a href="http://bugzilla.ximian.com/enter_bug.cgi">bug tracking system</a>.
1425
1426 Q: Does mcs support the same command line options as the MS C# 
1427    compiler?
1428
1429 A: The Mono C# compiler now supports the same command line
1430    arguments as the Microsoft C# compiler does.
1431
1432 Q: How about getting searchable archives on lists.ximian.com? 
1433
1434 A: You can perform a search on the mono-related mailing lists 
1435    <a href="http://www.go-mono.com/mailing-lists.html">here</a>.
1436
1437 Q: When using mono from cvs or from a snapshot, I get an error messaage
1438    saying that Mono and the runtime are out of sync. How do I fix that?
1439
1440 A: If you use mono from cvs, you need to be prepared for changes in the
1441    runtime internals. This means that you should keep a working setup 
1442    before blindling updating (a working setup may just be the last released
1443    tarball or a recent binary snapshot).
1444    Usually, compiling corlib with mcs before recompiling the C runtime does
1445    the right thing (but occasionally you may need to do it the other 
1446    way around).
1447
1448 Q: Why are you going for a GtkHtml implementation?
1449
1450 A: GtkHTML is just a lightweight HTML rendering engine that does not
1451    support CSS, so we need it to look decent for those of us that will 
1452    be using the documentation in our day-to-day work on Linux. The 
1453    Web-based interfaces lack the agility that you get from a native GUI
1454    tool to browse your documentation. Probably later on, we will write 
1455    scripts and generate a full documentation set that is web-browsable, 
1456    but we need a command-line and GUI tools that we can use natively on 
1457    Linux when disconnected from the Web (and that has better 
1458    interactions than a web page).
1459
1460 Q: Is there a command-line tool that allows me to access .NET interactively?
1461
1462 A: There are several but one that is free software and uses MCS is the one
1463    Dennis Lu from Rice University is working on; a REPL C# interpreter.
1464
1465 Q: Is it possible to use Visual C++ with Mono?.
1466
1467 A: It's possible to run VC++ generated apps under Mono, but we do not
1468    provide a Manager C++ compiler ourselves.
1469
1470 <a name="problems"></a>
1471 ** Mono Common Problems
1472
1473    If you are having problems compiling or running Mono software
1474    or if you think that you found a bug, etc. Please visit the
1475    <a href="http://geneura.ugr.es/~jaime/deploy/mono-common-problems.html">Mono Common Problems</a> document and try there. 
1476
1477 ** Credits
1478
1479    The FAQ contains material contributed by Miguel de Icaza, Jaime Anguiano, Lluis Sánchez.