Wed Mar 5 11:35:54 CET 2003 Paolo Molaro <lupus@ximian.com>
[mono.git] / doc / 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="#pnpproject">Mono and the Portable.NET Project</a><br>
8 <a href="#webservices">Web Services</a><br>
9 <a href="#asp">Mono and ASP.NET</a><br>
10 <a href="#ado">Mono and ADO.NET</a><br>
11 <a href="#monodoc">MonoDoc</a><br>
12 <a href="#devel">Development Tools and Issues</a><br>
13 <a href="#java">Mono and Java</a><br>
14 <a href="#extending">Extending Mono</a><br>
15 <a href="#portability">Portability</a><br>
16 <a href="#reuse">Reusing Existing Code</a><br>
17 <a href="#gcc">Mono and GCC</a><br>
18 <a href="#performance">Performance</a><br>
19 <a href="#licensing">Licensing</a><br>
20 <a href="#patents">Patents</a><br>
21 <a href="#etc">Miscellaneous Questions</a><br>
22 <a href="#problems">Mono Common Problems</a><br>
23
24 A <a
25 href="http://www.es.gnome.org/documentacion/articulos/mono-puf/mono-puf/">Spanish
26 translation</a> is also available
27
28 <a name="basics"></a>
29 ** Basics
30
31 Q: What is Mono exactly?
32
33 A: The Mono Project is an open development initiative sponsored by
34    Ximian that is working to develop an open source, Unix
35    version of the Microsoft .NET development platform.  Its objective
36    is to enable Unix developers to build and
37    deploy cross-platform .NET Applications.  The project will
38    implement various technologies developed by Microsoft that have now
39    been submitted to the ECMA for standardization.
40
41 Q: What is the difference between Mono and the .NET Initiative?
42
43 A: The ".NET Initiative" is a somewhat nebulous company-wide effort by
44    Microsoft, one part of which is a cross-platform development
45    framework.  Mono is an implementation of the development framework,
46    but not an implementation of anything else related to the .NET
47    Initiative, such as Passport, software-as-a-service, or
48    corporate re-branding.
49
50 Q: What technologies are included in Mono?
51
52 A: Mono contains a number of components useful for building new
53    software:
54
55         <ul>
56                 * A Common Language Infrastructure (CLI) virtual
57                   machine that contains a class loader, Just-in-time
58                   compiler, and a garbage collecting runtime.
59
60                 * A class library that can work with any language
61                   which works on the CLR.
62
63                 * A compiler for the C# language.  In the future we
64                   might work on other compilers that target the Common
65                   Language Runtime.
66         </ul>
67
68
69    Windows has compilers that target the virtual machine from <a
70    href="http://msdn.microsoft.com/net/thirdparty/default.asp#lang">a
71    number of languages:</a> Managed C++, Java Script, Eiffel,
72    Component Pascal, APL, Cobol, Perl, Python, Scheme,
73    Smalltalk, Standard ML, Haskell, Mercury and Oberon.
74
75    The CLR and the Common Type System (CTS) enables applications and
76    libraries to be written in a collection of different languages that
77    target the byte code
78
79    This means for example that if you define a class to do algebraic
80    manipulation in C#, that class can be reused from any other
81    language that supports the CLI.  You could create a class in C#,
82    subclass it in C++ and instantiate it in an Eiffel program. 
83
84    A single object system, threading system, class libraries, and
85    garbage collection system can be shared across all these languages.
86    
87 Q: Where can I find the specification for these technologies?
88
89 A: You can find the information here:
90  
91
92    C# <a href="http://www.ecma.ch/ecma1/STAND/ecma-334.htm">http://www.ecma.ch/ecma1/STAND/ecma-334.htm</a>
93
94    CLI <a href="http://www.ecma.ch/ecma1/STAND/ecma-335.htm">http://www.ecma.ch/ecma1/STAND/ecma-335.htm</a>
95
96 Q: Will you implement the .NET Framework SDK class libraries?
97
98 A: Yes, we will be implementing the APIs of the .NET Framework SDK
99    class libraries. 
100
101 Q: Will you offer an ECMA-compliant set of class libraries?
102
103 A: Eventually we will.  Our current focus is on inter-operating
104    with the Microsoft SDK, but we will also offer an ECMA compliant
105    set of libraries. 
106
107 Q: What does the name "Mono" mean?
108
109 A: Mono is the word for `monkey' in Spanish. We like monkeys.
110
111 Q: Is Mono usable?
112
113 A: The JIT engine is usable on Intel x86 machines.  An interpreter
114    can be used on other non-Intel x86 machines.  
115
116    The class libraries are mature enough to run some real applications
117    (the compiler for instance, and every day more and more applications
118    are natively developed with Mono).
119
120 Q: When will you ship it?
121
122 A: Different parts of Mono will achieve usability at different stages,
123    once we are comfortable with the compiler, we will release "Mono Core",
124    which contains everything needed to develop applications with the base
125    class libraries, this will happen soon and in the meantime you can 
126    download daily snapshots of our work. Also the full ASP.NET support is 
127    close to completion. 
128
129    Other higher level class libraries (ASP.NET, ADO.NET, WinForms) will
130    be released when they become stable. 
131
132 Q: What major components will you include in Mono?
133
134 A: Hopefully everything that Microsoft ships on their Framework
135    (ADO.NET, ASP.NET, WinForms), and we encourage third party developers to 
136    create reusable components that work on both Mono and Windows.
137
138 Q: How can I contribute?
139
140 A: Check the <a href="contributing.html">contributing</a> section. 
141
142 Q: Aren't you just copying someone else's work?
143
144 A: We are interested in providing the best tools for programmers to
145    develop applications for Free Operating Systems.  We also want to help
146    provide the interoperability that will allow those systems to fit in
147    with other standards.
148
149    For more background, read the <a href="http://www.go-mono.com/rationale.html">Mono
150    Project white paper</a>.
151    the project.
152
153 Q: Miguel said once that Mono was being implemented in COBOL. Is that true?.
154
155 A: No. It was a joke.
156
157
158 <a name="ximian"></a> 
159
160 ** The Ximian Role in the Mono Project
161
162 Q: Why is Ximian working on .NET?
163
164 A: Ximian is interested in providing the best tools for programmers to
165    develop applications for Free Operating Systems.  
166
167    For more information, read the project <a
168    href="rationale.html">rationale</a> page.
169
170 Q: Will Ximian be able to take on a project of this size?  
171
172 A: Of course not. Ximian a supporter of the Mono project, but the only way
173    to implement something of this size is for the entire free software
174    community to get involved. Visit the <a href="contributing.html">contributing</a> 
175    page if you'd like to help out.
176
177 Q: What pieces will Ximian be working on?
178
179 A: We will devote most of our resources to work on the pieces which are
180    on the critical path to release a development and execution
181    environment. Once the project is at a stage where it is useful in
182    the real world, it will achieve a critical mass of developers to
183    improve it further.
184
185 Q: Will Ximian offer Mono commercially?
186
187 A: When Mono is ready to be shipped Ximian will offer a commercial
188    support and services for Mono. 
189
190 Q: Does Ximian provide consulting services around Mono?
191
192 A: Yes, Ximian does provide consulting services around Mono to
193    make it suitable to your needs.  Porting the runtime engine,
194    customizing it, working on specific classes or tuning the code
195    for your particular needs. 
196
197 Q: Will you wait until Mono is finished?
198
199 A: Mono will ship on various stages as they mature.  Some people
200    require only a subset of the technologies, those will ship first.
201
202    More advanced features will take more time to develop.  A support
203    time line will be available in June 2002.
204
205 <a name="gnome"></a> 
206 ** Mono and GNOME
207
208 Q: How is Mono related to GNOME?
209
210 A: In a number of ways.  This project was born out of the need of
211    providing improved tools for the GNOME community, and will use
212    existing components that have been developed for GNOME when they
213    are available.  For example, we plan to use Gtk+ and Libart to
214    implement Winforms and the Drawing2D API and are considering
215    GObject support.
216
217 Q: Has the GNOME Foundation or the GNOME team adopted Mono?
218
219 A: Mono is too new to be adopted by those groups. We hope that the
220    tools that we will provide will be adopted by free software
221    programmers including the GNOME Foundation members and the GNOME
222    project generally.
223
224 Q: Should GNOME programmers switch over to Mono now?
225
226 A: It is still far to early for discussions of "switching over."  No
227    pieces of Mono will be ready within the next six months, and a
228    complete implementation is roughly one year away.
229
230    We encourage GNOME developers to continue using the existing tools,
231    libraries and components.  Improvements made to GNOME will have an
232    impact on Mono, as they would be the "back-end" for various classes.
233
234 Q: Will Mono include compatibility with Bonobo components? What is the
235    relationship between Mono and Bonobo?
236
237 A: Yes, we will provide a set of classes for implementing and using
238    Bonobo components from within Mono.  Mono should allow you to write
239    Bonobo components more easily, just like .NET on Windows allows you
240    to export .NET components to COM.
241
242 Q: Does Mono depend on GNOME?
243
244 A: No, Mono does not depend on GNOME.  We use a few packages produced by
245    the GNOME team like the `glib' library.  
246
247 Q: But will I be able to build GNOME applications?
248
249 A: Yes, we will enable people to write GNOME applications using Mono.
250
251 Q: Do you have C# bindings for GNOME?.
252
253 A: Yes, we currently bind libgnome, libgnomecanvas, and libgnomeui --
254    although I dare say I have no idea how functional the bindings are
255    outside of what I tested in the sample app. I imagine other libraries 
256    under the GNOME framework will be added on an as-needed (and as-requested) 
257    basis...although a truly good bonobo binding will have to wait on the CORBA 
258    remoting support which has been started recently.
259
260 <a name="gui"></a>
261 ** GUI applications
262
263 Q: Will Mono enable GUI applications to be authored?
264
265 A: Yes, you will be able to build GUI applications.  Indeed, that is our
266    main focus.  We will provide both the Windows.Forms API and the Gtk# API.
267
268 Q: What is the difference between Gtk# and System.Windows.Forms?
269
270 A: Gtk# is a set of bindings for the Gtk+ toolkit for C# (and other
271    CIL-enabled languages).  System.Windows.Forms is an API defined
272    by Microsoft to build GUI applications.
273
274 Q: Will I be able to run my smart clients on systems powered by Mono?
275
276 A: As long as your applications are 100% .NET and do not make use
277    of P/Invoke to call Win32 functions, your smart client applications
278    will run on Mono platforms.
279
280 Q: Where can I learn more about Gtk#?
281
282 A: The following <a href="http://gtk-sharp.sourceforge.net>link</a> sends you to the page of the project.
283
284 Q: What can I do with Gtk#?. 
285
286 A: Gtk# is becoming very usable and you can create applications and
287    applets like those you see in a GNOME desktop environment. It's 
288    easy to install so it's worth a try. 
289
290 Q: How can I compile my HelloWorld.cs which uses Gtk#?.
291
292 A: Try: mcs --unsafe -o HelloWorld.exe -r glib-sharp -r pango-sharp -r
293         atk-sharp -r gdk-sharp -r gtk-sharp -r gdk-imaging-sharp
294         HelloWorld.cs
295
296 Q: Is there any way how to connect DataAdapter to some GTK# controls?
297
298 A: There is a sample file called `DbClient' in gtk-sharp/samples that you
299    might to look at.  It is a sample program in Gtk# that adds/updates/deletes 
300    information on a Postgress database. When we have the new table/tree widgets, 
301    I am sure someone would write an adapter for System.Data (in Gtk2 the 
302    tree/list widgets are written using a view/model, so you only need to write 
303    a model that maps to the database). You can have a look at 
304    gtk-sharp/sample/DbClient, where there is a GTK# application that uses 
305    System.Data. It does not use DataAdapter, but DataReader though.
306
307 Q: Do you have an estimate for when Windows.Forms will be released?
308
309 A: We do not know, volunteers are working on this, but there is no set
310    date yet.  The current approach is using the Wine Library to implement
311    it.
312
313 <a name="msft"></a>
314 ** Mono and Microsoft
315
316 Q: Is Microsoft helping Ximian with this project?
317
318 A: There is no high level communication between Ximian and Microsoft
319    at this point, but engineers who work on .NET or the ECMA groups
320    have been very friendly, and very nice to answer our questions, or
321    clarify part of the specification for us. 
322
323    Microsoft is interested in other implementations of .NET and are
324    willing to help make the ECMA spec more accurate for this purpose.
325
326    Ximian was also invited to participate in the ECMA committee
327    meetings for C# and the CLI.
328
329 Q: Is Microsoft or Corel paying Ximian to do this?
330
331 A: No.
332
333 Q: Do you fear that Microsoft will change the spec and render Mono
334    useless?
335
336 A: No.  Microsoft proved with the CLI and the C# language that it was
337    possible to create a powerful foundation for many languages to
338    inter-operate.  We will always have that.  
339
340    Even if changes happened in the platform which were undocumented,
341    the existing platform would a value on its own.
342
343 Q: Are you writing Mono from the ECMA specs?
344
345 A: Yes, we are writing them from the ECMA specs and the published
346    materials in print about .NET.
347
348 Q: If my applications use Mono, will I have to pay a service fee?
349
350 A: No.  Mono is not related to Microsoft's initiative of
351    software-as-a-service.
352
353 Q: Is the Mono Project is related to the Microsoft Hailstorm effort?  Is
354    Ximian endorsing Hailstorm?  
355
356 A: No.  The Mono Project is focused on providing a compatible set of
357    tools for the Microsoft .NET development platform.  It does not
358    address, require, or otherwise endorse the MS Passport-based
359    Hailstorm single sign-on system that is part of Windows XP and
360    other services.
361
362 Q: Will Mono or .NET applications depend on Microsoft Passport?
363
364 A: No. MS Passport is unrelated to running .NET compatible applications
365    produced with the Mono tools.  The only thing you will need is a
366    just-in-time compiler (JIT).
367
368 Q: What is a 100% .NET application?
369
370 A: A `100% .NET application' is one that only uses the APIs defined
371    under the System namespace and does not use PInvoke.  These
372    applications would in theory run unmodified on Windows, Linux,
373    HP-UX, Solaris, MacOS X and others. 
374
375 Q: If Microsoft will release a port of their .NET platform under the
376    `Shared Source' license, why should I bother with anything else?
377
378 A: The Shared Source implementation will be expensive and its uses
379    will be tightly restricted, especially for commercial use. We are
380    working towards an implementation that will grant a number of
381    important rights to recipients: use for any purpose,
382    redistribution, modification, and redistribution of modifications.
383
384    This is what we call <a
385    href="http://www.gnu.org/philosophy/free-sw.html">Free Software</a>
386
387 Q: Is Mono a free implementation of Passport?
388
389 A: No. Mono is just a runtime, a compiler and a set of class
390    libraries.
391
392 Q: Will the System.Web.Security.PassportIdentity class mean
393    that my software will depend on Passport?
394    
395 A: No.  Applications may use that API to contact a Passport site, but
396    are not required to do so.
397
398    As long as your application does not use Passport, you will not
399    need Passport.  
400
401 Q: Will Mono running on Linux make Passport available for Linux?
402
403 A: No.  However, the Passport toolkit for Linux-based web servers is
404    available from Microsoft.
405
406 Q: Will Mono allow me to run Microsoft Office on Linux?
407
408 A: No, it will not.  Microsoft Office is a Windows application.  To
409    learn more about running Windows applications on Intel Unix systems
410    refer to <a href="http://www.winehq.com">the Wine Project</a>.
411
412 Q: Will I be able to compile a Microsoft VB.NET application and execute 
413    the resultant MSIL file under MONO on Linux without converting to C# 
414    and recompiling?
415
416 A: Once we have a complete VisualBasic runtime, yes.
417
418 Q: Can mono run the WebMatrix?
419
420 A: No. That requires System.Windows.Forms support which is not
421    currently implemented.
422
423 Q: Does mono have something like Passport? 
424    Will mono have a server side Passport/Similar framework for XSP as well as client classes?
425
426 A: Not yet, but the client side API for authentication is not the problem. 
427    We will likely have a lot of other authentication APIs, like the Liberty
428    Alliance APIs. The problem is people on the web provider end that might use 
429    this for authentication.
430
431 <a name="platforms"></a>
432 ** Mono Platforms 
433
434 Q: What operating systems does Mono run on?
435
436 A: Mono is known to run on Linux, Unix and Windows systems.   
437
438 Q: What architectures does Mono support?
439
440 A: Mono today ships with a Just-in-Time compiler for x86-based
441    systems.  It is tested regularly on Linux, FreeBSD and Windows
442    (with the XP/NT core).
443
444    There is also an interpreter, which is slower that runs on the
445    s390, SPARC and PowerPC architectures.
446
447 Q: Can Mono run on Windows 9x, or ME editions?
448
449 A: Mono requires Unicode versions of Win32 APIs to run,
450    and only a handful of *W functions is supported under Win9x.
451
452    There is Microsoft Layer for Unicode that provides implementation
453    of these APIs on 9x systems.
454
455    Unfortunately it uses linker trick for delayed load that is not
456    supported by ld, so some sort of adapter is necessary.
457    
458    You will need MSLU and one of the following libs to link Mono to
459    unicows.dll <a
460    href="http://mono.eurosoft.od.ua/files/unimono.zip">http://mono.eurosoft.od.ua/files/unimono.zip</a>
461    or alternatively search the net for "libunicows".
462
463    No changes to Mono source code required, the only thing is to make
464    sure that linker will resolve imports to adapter library instead of
465    Win32 libs. This is achieved by inserting -lunimono before
466    -lkerner32/user32 in the linker's specs file.
467
468
469 <a name="pnpproject"></a>
470 ** Mono and Portable.NET
471
472 Q: What are the differences between Mono and Portable.NET?
473
474 A: Most of Mono is being written using C#, with only
475    a few parts written in C (The JIT engine, the runtime, the
476    interfaces to the garbage collection system).  
477
478    It is easier to describe what is unique about Mono:
479    <ul>
480      <li> A Just-in-Time compiler engine.  This is important for
481           making your applications fast.
482
483      <li> A self-hosting C# compiler written in C#, which is clean, easy
484           to maintain.
485
486      <li> Focus on the .NET Framework: we are tracking down the .NET
487           Framework API definition, as we believe it is the API people
488           will be most familiar with.
489
490      <li> A multi-platform runtime engine: both a JIT engine and an
491           interpreter exist.  The JIT engine runs currently on x86
492           systems, while the interpreter works on SPARC, StrongARM,
493           s390 and PowerPC systems.  
494
495      <li> Supports Linux, Windows and Solaris at this point.
496
497      <li> The JIT engine is written using a portable instruction
498           selector which not only generates good code (we are told
499           that we are faster than Rotor, but it is hard to tell) but
500           is also the foundation to re-target the JIT engine to other
501           systems.  
502
503           The system employed is described in various compiler
504           books and it is very similar to what is described in the 
505           book that covers LCC, the ANSI C retargetable C compiler.
506
507      <li> The JIT engine supports in-lining, constant folding and propagation,
508
509      <li> Full support for remoting in the runtime, but the class 
510           libraries are still behind.
511
512      <li> The C# compiler, the JIT engine and the class libraries are
513           mature enough that the whole system is self-hosting.  This means that
514           we develop Mono completely with itself at this point.
515
516      <li> We are not yet done, and there is a lot of work left to be
517           done
518
519      <li> We have a great community of developers, without which Mono
520           would not be possible.
521
522      <li> We are working on an ahead of time compilation mode to
523           pre-compile code for the target architecture (this is part
524           of our new code generation effort).
525    </ul>
526
527 <a name="webservices"></a>
528 ** Web Services
529
530 Q: How is Mono related to Web Services?
531
532 A: Mono is only related to Web Services in that it will implement the
533    same set of classes that have been authored in the .NET Framework
534    to simplify and streamline the process of building Web Services.
535
536    But most importantly, Mono is an Open Source implementation of the
537    .NET Framework.
538
539 Q: Can I author Web Services with Mono?
540
541 A: You will be able to write Web Services on .NET that run on Mono and
542    vice-versa. 
543
544 Q: If Mono implements the SDK classes, will I be able to write and
545    execute .NET Web Services with it?
546    
547 A: Yes.  When the project is finished, you will be able to use the
548    same technologies that are available through the .NET Framework SDK
549    on Windows to write Web Services.
550
551 Q: What about Soup?  Can I use Soup without Mono?
552
553 A: Soup is a library for GNOME applications to create SOAP servers and
554    SOAP clients, and can be used without Mono.  You can browse the
555    source code for soup using <a
556    href="http://cvs.gnome.org/bonsai">GNOME's Bonsai</a>.
557
558 Q: Can I use CORBA?
559
560 A: Yes. The CLI contains enough information about a class that
561    exposing it to other RPC systems (like CORBA) is really simple, and
562    does not even require support from an object.  
563
564    We will be implementing CORBA inter-operation as an extension to the
565    Mono classes so that we can integrate with Bonobo, just like
566    Microsoft provides COM inter-operation classes and support
567    mechanisms. 
568
569 Q: Can I serialize my objects to other things other than XML?
570
571 A: Yes, although the serializing tools have not yet been planned, and
572    you would probably have to implement them yourself.
573
574 Q: Will Mono use ORBit?
575
576 A: No. Mono will be using a new implementation of CORBA that isn't still started. 
577
578 <a name="monodoc"></a>
579 ** MonoDoc
580
581 Q: What is MonoDoc?
582
583 A: MonoDoc is a graphical documentation editor and viewer. Currently, MonoDoc 
584    consists of a Gtk# application and is in heavy development. There is also a 
585    Qt# version of it.
586
587
588 <a name="devel"></a>
589 ** Development Tools and Issues
590
591 Q: Will it be possible to use the CLI features without using byte codes
592    or the JIT?
593
594 A: Yes. The CLI engine will be made available as a shared library.
595    The garbage collection engine, the threading abstraction, the
596    object system, the dynamic type code system and the JIT will be
597    available for C developers to integrate with their applications if
598    they wish to do so. 
599
600 Q: Will you have new development tools?
601
602 A: With any luck, Free Software enthusiasts will contribute tools to
603    improve the developer environment.  These tools could be developed
604    initially using the Microsoft implementation of the CLI and then
605    executed later with Mono.
606
607 Q: What kind of rules make the Common Intermediate Language useful for
608    JITers?
609
610 A: The main rule is that the stack in the CLI is not a general purpose
611    stack.   You are not allowed to use it for other purposes than
612    computing values and passing arguments to functions or return
613    values.  
614
615    At any given call or return instruction, the types on the stack
616    have to be the same independently of the flow of execution of your
617    code. 
618
619 Q: Is it true that the CIL is ideal for JITing and not efficient for
620    interpreters?
621
622 A: The CIL is better suited to be JITed than JVM byte codes, but you
623    can interpret them as trivially as you can interpret JVM byte
624    codes. 
625
626 Q: Isn't it a little bit confusing to have the name of "XSP" (the same 
627    as in the Apache Project) for the ASP.NET support in Mono?.
628
629 A: In Mono, xsp is just the name of the C# code generator for ASP.NET 
630    pages. In the Apache Project, it is a term for the "eXtensible Server 
631    Pages" technology so as they are very different things, they don't 
632    conflict.
633
634 Q: What about using something like Jabber instead of the System.Messaging 
635    namespace?.
636
637 A: In short, MSMQ is not something like Jabber, but asynchronous messaging 
638    through queues. Useful queues do more than serialize messages, they are 
639    also platform bridges.
640
641 Q: Are you supporting XMLDocument and relatives?.
642
643 A: Currently, we aren't implementing them yet. It would require updates to 
644    most of the XmlNode derivatives so it's not a trivial task. We are 
645    currently focusing on getting XPath support working. 
646
647 Q: Is there any plan to develop an aspx server for Mono?.
648
649 A: The web server turned out to be very simple compared to the rest of the 
650    work. Gonzalo has got the page generator mostly done (a module called 
651    xsp, who has nothing to do with the XSP term used in the Apache Project).
652    Patrik has done a lot of the work to get the ProcessRequest to work.
653    You can try to help in the final touches to the System.Web classes and
654    writing regression tests for the widgets we have.
655
656 Q: Is there any way I can develop the class libraries using Linux yet?
657
658 A: Yes. Some class libraries can be developed on Linux. Search for
659    Paolo's post (he lists which classes can be compiled fine now).
660
661 Q: Is there any way I can install a known working copy of mono in /usr, 
662    and an experimental copy somewhere else, and have both copies use 
663    their own libraries? (I'm still not very good at library paths in 
664    Linux)
665
666 A: Yes. Just use two installation prefixes.
667
668 Q: How should I write tests or a tests suite?
669
670 A: If you do a test suite for C#, you might want to keep it 
671    independent of the Mono C# compiler, so that other compiler 
672    implementations can later use it.  
673
674 Q: Would it be too terrible to have another corlib signed as mscorlib? 
675
676 A: We rename corlib to mscorlib also when saving the PE files, in fact, 
677    the runtime can execute program created by mono just fine.  
678
679 Q: Is there a relatively straightforward way to repeat the steps taken 
680    by Paolo to get Mono completely self-hosted on Linux?
681
682 A: To build the compiler and class libraries in Linux, run:
683    <ul><li>make -f makefile.gnu. To install them, run: </li>
684        <li>make -f makefile.gnu install prefix=/opt/mono</li>
685    </ul>
686
687    If you want to produce and distribute a monocharge tarball, run:
688    make -f makefile.gnu dist
689    Of course you have to run these in the top level mcs directory.
690
691 Q: Is it possible to build a C# file to some sort of intermediate format which 
692    can linked into a final module, like the traditional .c -> .o -> .so path? 
693    
694 A: You could do: mcs /target:module file1.cs, mcs /target:module file2.cs, 
695    mcs /target:exe file1.dll file2.dll /out:mybin.exe
696
697 Q: Is there any plans for implementing remoting in the near future?, When will 
698    work in System.Runtime.Remoting.dll start?
699
700 A: The remoting infrastructure is in place. Some of the channels and 
701    formatters are not.
702
703 Q: I'm wondering if there are any plans to start using nant to build the
704    class lib + test lib. i think that every project need/should use an
705    automated build process and nant + a couple of tools enables this. is
706    the problem that the compiler can't run nant yet?
707
708 A: Maybe well be doing some sort of automated build process + testing when
709    the summer finish.
710
711 Q: My C code uses the __stdcall which is not availble on Linux, how can I
712    make the code portable Windows/Unix across platforms?
713
714 A: Replace the __stdcall attribute with the STDCALL macro, and include this
715    in your C code for newer gcc versions:
716
717         #ifndef STDCALL
718         #define STDCALL __attribute__((stdcall))
719         #endif
720
721 <a name="asp">
722 ** Mono and ASP.NET
723
724 Q: Is Mono supporting ASP.NET?
725
726 A: Yes. The development of the support for ASP.NET comes in various stages, 
727    here is what Gonzalo has been working on: 1. The Parser. 2. Getting the 
728    parser to generate output compatible with ASP.NET. 3. Running the sample 
729    output with the real Microsoft runtime but using our generated page. 4. 
730    Running the sample with our classes with the .NET runtime. 5. Running 
731    our sample code with our classes with our runtime. This is the process 
732    we are following. Currently Gonzalo has reached point 5.
733
734 Q: Do I need install cygwin to work on ASP.NET in mono or Linux is enough since 
735    it is self host right now.
736
737 A: Linux is enough.
738
739 Q: Any plan to make ASP.NET in mono works with Apache in Linux?.
740
741 A: Yes, we have plans to do so, but we need to wait for Patrik's patches to
742    HttpRuntime. Once that is there, writing a mod_mono should be trivial 
743    (look at mono/samples/embed for a sample embedded application).
744
745 <a name="ado">
746 ** Mono and ADO.NET
747
748 Q: What is the status of ADO.NET support?. Could I start migrating 
749    applications from MS.NET to Mono?.
750
751 A: You could start right now using the ADO.NET support in mono, of course,
752    if you want to help filling the missing gaps while you develop your app
753    :-) Well, what I mean is that we're not that far to having full ADO.NET
754    support in Mono, and we've got a lot of working things, so if we could
755    get more help, we'd finish it really soon :-)
756
757 Q: In developing the data architecture for the application are there and
758    objects I should stay away from in order to insure the smoothest possible
759    transition (minimum code rewrite) to Mono's ADO.NET implementation?  (For
760    example, strongly typed datasets versus untyped datasets, etc...)
761
762 A: We are implementing all the classes in Microsoft .NET's System.Data, so
763    you can be sure that things will work the same in Mono as with the Microsoft
764    implementation. 
765
766 Q: Does Mono can to connect to Sybase by using Mono.Data.*?
767
768 A: Yes. use Mono.Data.SybaseClient. First of all you have to create a
769    SybaseConnection, and then, from it, use it as any other
770    IDbConnection-based class.
771
772 <a name="java">
773 ** Mono and Java
774    
775 Q: Why don't you use Java?  After all, there are many languages that
776    target the Java VM.
777
778 A: You can get very good tools for doing Java development on free
779    systems right now.  <a href="http://www.redhat.com">Red Hat</a> has
780    contributed a <a href="http://gcc.gnu.org">GCC</a> <a
781    href="http://gcc.gnu.org/java">front-end for Java</a> that can take
782    Java sources or Java byte codes and generate native executables; <a
783    href="http://www.transvirtual.com">Transvirtual</a> has implemented
784    <a href="http://www.kaffe.org">Kaffe</a> a JIT engine for Java;
785    Intel also has a Java VM called <a
786    href="http://www.intel.com/research/mrl/orp">ORP</a>.
787
788    The JVM is not designed to be a general purpose virtual machine.
789    The Common Intermediate Language (CIL), on the other hand, is
790    designed to be a target for a
791    wide variety of programming languages, and has a set of rules
792    designed to be optimal for JITers.
793
794 Q: Could Java target the CLI?
795
796 A: Yes, Java could target the CLI.  We have details on a <a
797    href="ideas.html#guavac">project</a> that someone could take on to
798    make this happen.  
799
800    Microsoft has an implementation of the Java language called J# that
801    can target the CIL execution engine. 
802
803 Q: Is it possible to write a JVM byte code to CIL converter?
804
805 A: Yes, it is possible.  Here are a few starting point:
806
807         <ul>
808                 * A byte code representation is really a flattened forest of
809                   trees.  Look at the Mono JIT engine to see how we compute
810                   the basic blocks (this is used to figure out the "trees").
811
812                   The forest is just an array of trees.
813
814                   Indeed, run the JIT engine with -d (mono -d prog.exe) and
815                   you will see how these trees look like.
816
817                   You will have to do something similar for Java.
818
819                 * Each "forest of trees" has a meaning.  This meaning can now
820                   be translated into the equivalent "meaning" in CLR-land.
821         </ul>
822
823 Q: Could mono become a hybrid CIL/java platform?
824
825 A: No. It is quite far from the philosophy of the project. The idea of Mono 
826    is, to have only _one_ VM, on which all can run. And if there existing a 
827    binary-converter from Java-.class to IL and if there existing something 
828    like J-Sharp on Mono, you can write programs in Java, which than can run 
829    on Mono. You do not need two bindings (like your example: GTK-Sharp _and_ 
830    Java-Gnome). You need only _one_ of it (GTK-Sharp). Thats the idea of Mono.
831    An other point is, that there are no people, who use Open Source-JVMs. They 
832    all prefer Suns original. But for Unix there don't exist a .NET-Framework. 
833    So it is possible, that in the future Mono is the standard .NET for Unixes.
834
835 Q: Do you plan to implement a Javascript compiler?
836
837 A: Yes. Eto Demerzal has started a Rhino port to C#.
838    After this is completed, we will begin developing
839    the JavaScript compiler.
840
841 Q: Can Mono or .NET share system classes (loaded from mscore.dll and other 
842    libs) or will it behave like Sun's Java VM?
843
844 A: What you can do with mono is to load different applications in their own
845    application domain: this is a feature of the CLR that allows sandboxing
846    applications inside a single process space. This is usualy exploited to
847    compartmentalize different parts of the same app, but it can also be
848    effectively used to reduce the startup and memory overhead.
849    Using different appdomains the runtime representation of types and
850    methods is shared across applications.
851
852 <a name="extending"></a>
853 ** Extending Mono
854
855 Q: Would you allow other classes other than those in the
856    specification?
857
858 A: Yes.  The Microsoft class collection is very big, but it is by no
859    means complete.  It would be nice to have a port of `Camel' (the
860    Mail API used by Evolution inspired by Java Mail) for Mono
861    applications.  
862
863    You might also want to look into implementing CORBA for Mono.  Not
864    only because it would be useful, but because it sounds like a fun
865    thing to do, given the fact that the CLI is such a type rich
866    system. 
867
868    For more information on extending Mono, see our <a
869    href="ideas.html">ideas</a> page.
870
871 Q: Do you plan to Embrace and Extend .NET?
872
873 A: Embracing a good technology is good.  Extending technologies in
874    incompatible ways is bad for the users, so we do not plan on 
875    extending the technologies.
876
877    If you have innovative ideas, and want to create new classes, we 
878    encourage you to make those classes operate correctly well in both
879    Mono and .NET.
880
881 Q: Is there any way I can develop the class libraries using Linux yet?
882
883 A: Yes. Some class libraries can be developed on Linux. Search for
884    Paolo's post (he lists which classes can be compiled fine now).
885
886 Q: Is there any way I can install a known working copy of mono in /usr, 
887    and an experimental copy somewhere else, and have both copies use 
888    their own libraries? (I'm still not very good at library paths in 
889    Linux)
890
891 A: Yes. Just use two installation prefixes.
892
893
894 <a name="portability"></a>
895 ** Portability
896
897 Q: Will Mono only work on Linux?
898
899 A: Currently, we are doing our work on Linux-based systems and
900    Windows.  We do not expect many Linux-isms in the code, so it
901    should be easy to port Mono to other UNIX variants.   
902
903 Q: What about Mono on non Linux-based systems?
904
905 A: Our main intention at Ximian is to be able to develop GNOME
906    applications with Mono, but if you are interested in providing a
907    port of the Winforms classes to other platforms (frame buffer or
908    MacOS X for example), we would gladly integrate them, as long
909    they are under an open source license.  
910
911 Q: What operating systems/CPUs do you support
912
913 A: Mono currently runs on Linux, Windows, Solaris and FreeBSD.
914    There is a JIT engine available for x86 processors that can
915    generate code and optimizations tailored for a particular CPU.
916
917    Interpreters exist for the SPARC, PowerPC and StrongARM CPUs.
918
919 Q: Does Mono run on Windows?
920
921 A: Yes.   You can get pre-compiled
922    binaries from <a href="http://www.go-mono.com/download.html">http://www.go-mono.com/download.html</a>
923
924 Q: Does Mono run on Linux?
925
926 A: Yes.  You can get pre-compiled
927    binaries from <a href="http://www.go-mono.com/download.html">http://www.go-mono.com/download.html</a>
928
929 Q: Will I require Cygwin to run mono?
930
931 A: No.  Cygwin is only required to build Mono.
932
933 Q: Will Mono depend on GNOME?
934
935 A: It will depend only if you are using a particular assembly (for
936    example, for doing GUI applications).  If you are just interested
937    in Mono for implementing a `Hello World Enterprise P2P Web
938    Service', you will not need any GNOME components.
939
940 Q: Is anyone working on porting Mono to IA-64?
941
942 A: Nobody is working on such port.
943
944 Q: If I were about to start a Mono port to IA-64,would the same lburg code 
945    generator work for IA-64 also? or anything else need to be used for code 
946    generation(as the processor architecture is totally different from IA32)
947
948 A: The lburg approach can be use for any processor architecture. But you might
949    think in another better approach.
950
951 Q: Do you plan to port Rhino to C#?.
952
953 A: Eto Demerzal has started a Rhino port to C#.
954
955 Q: Has anyone succeeded in building a Mac version of the C# environment. 
956    If so can you explain how?  
957
958 A: You could try to check with the Darwin people, or the Fink people.
959    Mono/C# is self hosting on Linux/PPC which is the hard part, so it
960    should be relatively simple to get it to work on MacOS
961
962 <a name="reuse"></a>
963 ** Reusing Existing Code
964
965 Q: What projects will you reuse or build upon?
966
967 A: We want to get Mono in the hands of programmers soon.  We are
968    interested in reusing existing open source software.
969
970 Q: What about Intel's research JIT framework, ORP?
971
972 A: At this time, we are investigating whether we can use elements of
973    ORP for Mono.   ORP is a research JIT engine that has a clearly
974    defined API that splits the JIT from the GC system and the actual
975    byte code implementation.
976
977    We are using some pieces of ORP (Their code generation interface)
978    and we use it as a source of inspiration for optimizations.  Paolo
979    and Dietmar consider ORP as being one of the best JIT engines out
980    there (and their research work and papers are very useful if you are
981    interested in JIT technology).
982
983 Q: What about using GNU Lightning?
984
985 A: We are not using GNU Lightning.  Our JIT is using an instruction
986    selector based on tree-pattern matching, and a code generation
987    interface that is very tied to the current architecture.
988
989 Q: Will I be able to use Microsoft SQL Server 2000 or will I need to switch
990    to a specific Open Source Database. Will I need to recode?
991
992 A: There should not be any need to recode.
993
994 Q: What do I need to watch out for when programming in VB.NET so that I'm
995    sure to be able to run those apps on Linux?
996
997 A: Not making any PInvoke or DLL calls should and not using anything in
998    the Microsoft.* namespaces should suffice. Also do not use any 
999    Methods/Classes marked as "This type/method supports the .NET Framework 
1000    infrastructure and is not intended to be used directly from your code." 
1001    even if you know what these classes/methods do.
1002
1003 Q: Will built-in reporting be supported for crystal reports? This is a
1004    heavily used part of our system.
1005
1006 A: Probably not. Crystal Reports are propriety. Someone may try to emulate
1007    the behavior, but no-one has yet volunteered.
1008
1009 Q: Who about writing to the registry? As I understand it, Linux does not have
1010    a counterpart to the registry. Should I avoid relying on that feature?
1011
1012 A: Try to avoid it. Although there would be a emulation for registry in
1013    Mono too. GNOME does have a registry like mechanism for configuration. But
1014    Even if gnome has a configuration system similar to the registry, the keys 
1015    will not be equal, so you will probably end up having to do some runtime 
1016    detection, and depending on this load an assembly that has your 
1017    platform-specific hacks.
1018
1019 Q: System.Data.SqlClient with FreeTDS, will you port parts of these to C# and 
1020    use them?
1021
1022 A: if their license is compatible with mono's, yes, we'd think about porting 
1023    them. If not, we'll continue with the plan of using FreeTDS.
1024
1025 <a name="gcc"></a>
1026 ** Mono and GCC
1027
1028 Q: Are you working on a GCC front-end to C#? A GCC back-end that will
1029    generate CIL images? What about making a front-end to GCC that
1030    takes CIL images and generates native code?
1031
1032 A: We are currently seeking volunteers for those projects.
1033    Visit the <a href="contributing.html">contributing</a> section if
1034    you are interested.
1035
1036 Q: But would this work around the GPL in the GCC compiler and allow
1037    people to work on non-free front-ends?
1038
1039 A: People can already do this by targeting the JVM byte codes (there
1040    are about 130 compilers for various languages that target the JVM).
1041
1042 Q: Why are you writing a JIT engine instead of a front-end to GCC?
1043
1044 A: We want the JIT engine and runtime engine because they will be able
1045    to execute CIL executables generated on Windows, and so no recompilation 
1046    will be necessary.
1047
1048 <a name="performance"></a>
1049 ** Performance
1050
1051 Q: How fast will Mono be?
1052
1053 A: We can not predict the future, but a conservative estimate is that
1054    it would be at least `as fast as other JIT engines'.
1055
1056    We would like to ship various JIT engines with Mono, just like
1057    Microsoft has done with their .NET development platform. We could
1058    provide a faster, JIT for fast load times but lower performance,
1059    and an and an optimizing JIT that would be slower at generating
1060    code but produce more optimal output.
1061
1062    The CIL has some advantages over the Java byte code:  it is really
1063    an intermediate representation and there are a number of
1064    restrictions on how you can emit CIL code that simplify creating
1065    better JIT engines.
1066
1067    For example, on the CIL, the stack is not really an abstraction
1068    available for the code generator to use at will.  Rather, it is a
1069    way of creating a postfix representation of the parsed tree.  At
1070    any given call point or return point, the contents of the stack are
1071    expected to contain the same object types independently of how the
1072    instruction was reached.
1073
1074 <a name="licensing"></a>
1075 ** Licensing
1076
1077 Q: Will I be able to write proprietary applications that run with
1078    Mono?
1079
1080 A: Yes.  The licensing scheme is planned to allow proprietary
1081    developers to write applications with Mono.
1082    
1083 Q: What license or licenses are you using for the Mono Project?
1084
1085 A: The C# Compiler is released under the terms of the <a 
1086    href="http://www.opensource.org/licenses/gpl-license.html">GNU GPL</a>.  The runtime
1087    libraries are under the <a
1088    href="http://www.opensource.org/licenses/lgpl-license.html">GNU
1089    Library GPL</a>.  And the class libraries are released
1090    under the terms of the <a
1091    href="http://www.opensource.org/licenses/mit-license.html">MIT X11</a>
1092    license.
1093
1094    The Mono runtime and the Mono C# Compiler are also available under
1095    a proprietary license for those who can not use the LGPL and the
1096    GPL in their code.  
1097
1098    For licensing details, contact <a
1099    href="mailto:mono-licensing@ximian.com">mono-licensing@ximian.com</a>
1100
1101
1102 Q: I would like to contribute code to Mono under a particular
1103    license. What licenses will you accept?
1104
1105 A: We will have to evaluate the licenses for compatibility first,
1106    but as a general rule, we will accept the code under the same
1107    terms of the "container" module. 
1108
1109 <a name="patents"></a>
1110 ** Patents
1111
1112 Q: Could patents be used to completely disable Mono (either submarine
1113    patents filed now, or changes made by Microsoft specifically to
1114    create patent problems)?
1115
1116 A: No.  First, its basic functional capabilities have pre-existed too
1117    long to be held up by patents.  The basic components of Mono are
1118    technologically equivalent to Sun's Java technology, which has been
1119    around for years.  
1120
1121    Mono will also implement multi-language and
1122    multi-architecture support, but there are previous technologies
1123    such as UCSD p-code and ANDF that also support multiple languages
1124    using a common intermediate language.  The libraries are similar
1125    to other language's libraries, so again, they're too similar to
1126    be patentable in large measure.
1127
1128    However, if Microsoft does patent some technology, then our plan is
1129    to either (1) work around it, (2) chop out patented pieces, (3) 
1130    find prior art that would render the patent useless.
1131  
1132    Not providing a patented capability would weaken the
1133    interoperability, but it would still provide the free software /
1134    open source software community with good development tools, which
1135    is the primary reason for developing Mono.  
1136
1137 <a name="etc"></a> 
1138 ** Miscellaneous Questions
1139
1140 Q: You say that the CLI allows multiple languages to execute on the
1141    same environment.  Isn't this the purpose of CORBA?
1142
1143 A: The key difference between CORBA (and COM) and the CLI is that the
1144    CLI allows "data-level interoperability" because every
1145    language/component uses the same data layout and memory management.
1146
1147    This means you can operate directly upon the data types that someone
1148    else provides, without having to go via their interfaces.  It also
1149    means you don't have to "marshal" (convert) parameters (data
1150    layouts are the same, so you can just pass components directly) and
1151    you don't have to worry about memory management, because all
1152    languages/components share the same garbage collector and address
1153    space.  This means much less copying and no need for reference
1154    counting.
1155
1156 Q: Will you support COM?
1157
1158 A: The runtime will support XPCOM on Unix systems and COM on Windows.
1159    Most of the code for dynamic trampolines exists already.
1160
1161 Q: Will Ximian offer certifications on Mono or related technologies?. 
1162
1163 A: It's possible. But there is no plan about this. So the short answer is no.
1164
1165 Q: Are there any Boehm's GC binaries?
1166
1167 A: Yes. You can find RPMs <a href="http://java.thn.htu.se/~toor/">here</a>, though
1168    if your distribution provides the correct packages, you should use those.
1169    The suggested version of the Boehm GC is 6.1.
1170
1171 Q: How can I report a bug?
1172
1173 A: The best thing is to track down the bug and provide a simple test to
1174    reproduce the bug. You can then add the bug to the 
1175    <a href="http://bugzilla.ximian.com/enter_bug.cgi">bugtracking system</a>.
1176
1177    Please provide information about what version of mono you're using
1178    and any relevant details to be able to reproduce the bug. Note that
1179    bugs reported on the mailing-list may be easily forgotten, so it's
1180    better to file them in the <a href="http://bugzilla.ximian.com/enter_bug.cgi">bug tracking system</a>.
1181
1182 Q: Does mcs support the same command line options as the MS C# 
1183    compiler?
1184
1185 A: The Mono C# compiler now supports the same command line
1186    arguments as the Microsoft C# compiler does.
1187
1188 Q: How about getting searchable archives on lists.ximian.com? 
1189
1190 A: You can perform a search on the mono-related mailing lists 
1191    <a href="http://www.go-mono.com/mailing-lists.html">here</a>.
1192
1193 Q: When using mono from cvs or from a snapshot, I get an error messaage
1194    saying that Mono and the runtime are out of sync. How do I fix that?
1195
1196 A: If you use mono from cvs, you need to be prepared for changes in the
1197    runtime internals. This means that you should keep a working setup 
1198    before blindling updating (a working setup may just be the last released
1199    tarball or a recent binary snapshot).
1200    Usually, compiling corlib with mcs before recompiling the C runtime does
1201    the right thing (but occasionally you may need to do it the other 
1202    way around).
1203
1204 Q: Why are you going for a GtkHtml implementation?
1205
1206 A: GtkHTML is just a lightweight HTML rendering engine that does not
1207    support CSS, so we need it to look decent for those of us that will 
1208    be using the documentation in our day-to-day work on Linux. The 
1209    Web-based interfaces lack the agility that you get from a native GUI
1210    tool to browse your documentation. Probably later on, we will write 
1211    scripts and generate a full documentation set that is web-browsable, 
1212    but we need a command-line and GUI tools that we can use natively on 
1213    Linux when disconnected from the Web (and that has better 
1214    interactions than a web page).
1215
1216 Q: Is there a command-line tool that allows me to access .NET interactively?
1217
1218 A: There are several but one that is free software and uses MCS is the one
1219    Dennis Lu from Rice University is working on; a REPL C# interpreter.
1220
1221 Q: Is it possible to use Visual C++ with Mono?.
1222
1223 A: Well, It's possible to run VC++ generated apps under Mono though.
1224
1225 <a name="problems"></a>
1226 ** Mono Common Problems
1227
1228    If you are having problems compiling or running Mono software
1229    or if you think that you found a bug, etc. Please visit the
1230    <a href="http://geneura.ugr.es/~jaime/deploy/mono-common-problems.html">Mono Common Problems</a> document and try there. 
1231