Build doc directory
[mono.git] / doc / faq
1 ** Basics
2
3 Q: Is Mono the same as Microsoft's .NET initiative?
4
5 A: It is not. 
6
7    .NET is a company-wide initiative at Microsoft that
8    encompasses many different areas. The .NET development framework,
9    Passport, Biztalk, new server products, and anything that is
10    remotely connected to .NET gets the ".NET-stamping" treatment.
11    Some components of Microsoft's .NET initiative have been announced
12    and some others are in the works.
13
14   Mono is a project to implement several technologies developed by
15    Microsoft that have now been submitted to the ECMA Standards Body.   
16
17 Q: What technologies are included in Mono?
18
19 A: Mono contains a number of components useful for building new
20    software:
21
22         <ul>
23                 * A Common Language Infrastructure (CLI) virtual
24                   machine that contains a class loader, Just-in-time
25                   compiler, and a garbage collecting runtime.
26
27                 * A class library that can work with any language
28                   which works on the CLR.
29
30                 * A compiler for the C# language.  In the future we
31                   might work on other compilers that target the Common
32                   Language Runtime.
33
34                   Windows has compilers that target the
35                   virtual machine from
36                   <a href="http://msdn.microsoft.com/net/thirdparty/default.asp#lang">a
37                   number of languages:</a> Managed C++, Java Script,
38                   Eiffel, Component Pascal, APL, Cobol, Oberon, Perl,
39                   Python, Scheme, Smalltalk, Standard ML, Haskell,
40                   Mercury and Oberon.
41         </ul>
42
43    The CLR and the Common Type System (CTS) enables applications and
44    libraries to be written in a number of languages.  Classes and
45    methods created in one language can be used from a different
46    language. 
47
48    This means for example that if you define a class to do algebraic
49    manipulation in C#, that class can be reused from any other
50    language that supports the CLI.  You could create a class in C#,
51    subclass it in C++ and instantiate it in an Eiffel program. 
52
53    A single object system, threading system, class libraries, and
54    garbage collection system can be shared across all these languages.
55    
56 Q: Where can I find the specification for these technologies?
57
58 A: You can find the work-in-progress documentation from the T3G ECMA
59    group here:
60  
61    <a href="http://www.dotnetexperts.com">http://www.dotnetexperts.com</a>
62
63 Q: Will you implement the .NET Framework SDK class libraries?
64
65 A: Yes, we will be implementing the APIs of the .NET Framework SDK
66    class libraries. 
67
68 Q: What does Mono stand for?
69
70 A: Mono is the word for `Monkey' in Spanish. We like monkeys.
71
72 Q: When will you ship it?
73
74 A: We do not know when the code will be shipped.  The more
75    contributions we get to the project, the sooner it will ship.
76
77    A rough estimate is that we might be able to run our C# compiler on
78    Linux by the end of the year.  That means running the Windows
79    Executable generated by a Microsoft .NET compiler on the Linux
80    platform.
81
82    We expect that doing GUI applications will require more work on the
83    class libraries. That could take another six months.
84
85 Q: How can I contribute?
86
87 A: Check the <a href="contributing.html">contributing</a> section. 
88
89 Q: You guys should innovate instead of copying.
90
91 A: In this particular case, we see a clear advantage in the platform
92    and we are interested in using the features of the CLI on open source systems.
93
94    We have decided that we should spend our limited resources towards
95    implementing an existing specification instead of designing and
96    implementing our own.
97
98    Designing and implementing our own would be possible, but it doesn't make
99    sense to do that just because the specification comes from a
100    proprietary vendor.  
101
102 ** Ximian
103
104 Q: Why is Ximian working on .NET?
105
106 A: We are interested in providing the best tools for programmers to
107    develop applications for Free Operating Systems.  
108
109    For more information, read the project <a
110    href="rationale.html">rationale</a> page.
111
112 Q: Will Ximian be able to take on a project of this size?  
113
114 A: Ximian will not be able to taken on the whole project on its own.
115    Mono will be a free software/open source community project, that is
116    the only way we can hope to implement something of this size.  You
117    can <a href="contributing.html">contribute</a> to this effort.
118
119 Q: What pieces will Ximian be working on?
120
121 A: We will focus on building a development and execution
122    environment.  
123
124    The idea is to get Mono to a state of that would allow
125    third parties to actually be able to use it real-world development.
126
127 Q: Why does Ximian even care?
128
129 A: We like the features that the CLI and its related technologies
130    bring to the table.  An exciting addition to the developer toolkit.
131    The goal of Mono is to bring this technology to non-Windows
132    platforms (although we hope Mono will also run on Windows, for
133    debugging and comparative purposes).
134
135
136 ** Licensing
137
138 Q: Will I be able to write proprietary applications that run with
139    Mono?
140
141 A: Yes.  We will make sure that the licensing will allow developers to
142    create proprietary applications.  
143    
144 Q: What license is Mono on?
145
146 A: The C# Compiler is released under the terms of the GPL.  The class
147    libraries will be under the LGPL or the GPL with a special
148    exception.  The runtime libraries are under the LGPL.
149
150    Here is the exception for the class libraries:
151
152    The library is distributed under the terms of the GNU General
153    Public License with the following exception:
154
155    If you link this library against your own program, then you do not
156    need to release the source code for that program. However, any
157    changes that you make to the library itself, or to any native
158    methods upon which the library relies, must be re-distributed in
159    accordance with the terms of the GPL.
160
161    This is similar in spirit to <a
162    href="http://www.gnu.org/software/classpath/classpath.html">GNU
163    Classpath.</a>
164
165 Q: Will you accept code under the XXX License?
166
167 A: If the XXX License is compatible with the license we use in that
168    specific piece of code, then yes.  If you want to use the BSD license, make
169    sure you use the BSD license without the advertisement clause (The
170    `Ousterhout License').
171
172 ** Mono and .NET
173
174 Q: If applications use Mono, does that mean that I have to pay a service fee?
175
176 A: No.  Mono is not related to Microsoft's initiative of
177    software-as-a-service. 
178
179 Q: If you implement .NET, will I depend on Microsoft Passport to run my software?
180
181 A: No.  The .NET Framework is a runtime infrastructure and collection
182    of class libraries.  Passport may be required to access certain web
183    services written for that framework, but only if the programmer
184    chooses Passport as the authentication mechanism.
185
186 Q: Is .NET just a bunch of marketing slogans?
187
188 A: Although the `.NET initiative' is still quite nebulous, The .NET Framework
189    has been available for some time.  Mono is not an implementation of the .NET
190    initiative, just the development framework.
191
192 Q: What is a 100% .NET application?
193
194 A: A `100% .NET application' is one that only uses the APIs defined
195    under the System namespace and does not use PInvoke.  These
196    applications would in theory run unmodified on Windows, Linux,
197    HP-UX, Solaris, MacOS X and others. 
198
199 Q: But Microsoft will release a port of the real thing under the
200    `Shared Source' license, why bother with anything else?
201
202 A: The Shared Source implementation will not be usable for commercial
203    purposes.  We are working towards an implementation that will grant
204    a number of rights to recipients: use for any purpose,
205    redistribution, modification, and redistribution of modifications.
206
207    This is what we call <a
208    href="http://www.gnu.org/philosophy/free-sw.html">Free Software</a>
209
210 ** Passport
211
212 Q: Is this a free implementation of Passport?
213
214 A: No.  Passport is part of Microsoft's Hailstorm initiative.  Mono
215    is just a runtime, a compiler and a set of class libraries. 
216
217 Q: Will the System.Web.Security.PassportIdentity class, mean
218    that my software will depend on Passport?
219    
220 A: No.  That just means that applications might use that API to
221    contact a Passport site.  
222
223    As long as your application does not use Passport, you will not
224    need Passport.  
225
226    It might even be possible to implement that class with
227    a set of dummy functions, or use an alternate Passport implementation.
228
229    We do not know at this time whether the Passport protocol is
230    documented and whether we will be able to talk to
231    passport.com 
232
233 Q: What is your opinion?
234
235 A: You can read my personal <a href="passport.html">opinion on
236    passport</a>.
237
238 ** Mono and Windows
239
240 Q: Will Mono allow me to run Microsoft Office on Linux?
241
242 A: No, it will not.  Microsoft Office is a Windows application.  To
243    run Windows applications on Intel Unix systems refer to <a
244    href="http://www.winehq.com">the Wine Project</a>
245
246 ** GNOME
247
248 Q: How is this related to GNOME?
249
250 A: In a number of ways:
251
252         * Mono will use existing
253           components that have been developed for GNOME when it makes
254           sense.  For example on X systems, we will use Gtk+ and
255           Libart to implement Winforms and the Drawing2D API.  
256
257           For database access, we will use LibGDA (not really
258           depending on GNOME, but related to).
259
260         * This project was born out of the need of providing improved
261           tools for the GNOME community. 
262
263         * We would like to add support to our CLR implementation to
264           deal with GObjects (in GNOME 1.x, they are called
265           GtkObjects), and allow Mono developers to provide GObjects
266           or use and extend existing GObjects.
267
268 Q: Has the GNOME Foundation or the GNOME team adopted Mono?
269
270 A: Mono is too new to be adopted by those groups. We hope that the
271    tools that we will provide will be adopted by free software
272    programmers including the GNOME Foundation members and the GNOME
273    project generally.
274
275 Q: Should GNOME programmers switch over to Mono?
276
277 A: Mono will not be ready even within the next six months, and a
278    complete implementation is probably one year away.  
279
280    We encourage GNOME developers to continue using the existing tools,
281    libraries and components.  Improvements made to GNOME will have an
282    impact on Mono, as they will provide the "backend" for various
283    classes. 
284
285 Q: Will Mono include compatibility with Bonobo components?
286
287 A: Yes, we will provide a set of classes for implementing and using
288    Bonobo components from within Mono. 
289
290 ** Mono and the Web
291
292 Q: Is Mono a way of running Java applets?
293
294 A: No.
295
296 ** Web Services
297
298 Q: Is Mono just a new way of writing Web Services?
299
300 A: No.
301
302 Q: If this implements the SDK classes, will I be able to write and
303    execute .NET Web Services with this?
304    
305 A: Yes, you will.
306
307    When the project is finished, you will be able to use the same
308    technologies that are available through the .NET Framework SDK on
309    Windows to write Web Services.
310
311 Q: What about Soup?
312
313 A: Soup is a library for GNOME applications to create SOAP server and
314    SOAP clients.   You can browse the source code for soup using <a
315    href="http://cvs.gnome.org/bonsai">GNOME's Bonsai</a>
316
317 Q: Can I use CORBA?
318
319 A: Yes. The CLI contains enough information about a class that
320    exposing it to other RPC systems (like CORBA) is really simple, and
321    does not even require support from an object.  
322
323    We will be implementing CORBA interoperation as an extension to the
324    Mono classes so that we can integrate with Bonobo, just like
325    Microsoft provides COM interoperation classes and support
326    mechanisms. 
327
328 Q: Can I serialize my objects to other things other than XML?
329
330 A: Yes, although the serializing tools have not yet been planned, and
331 you would probably have to implement them yourself.
332
333 ** Development Tools 
334
335 Q: Will it be possible to use the CLI features without using bytecodes
336    or the JIT?
337
338 A: Yes. The CLI engine will be made available as a shared library.
339    The garbage collection engine, the threading abstraction, the
340    object system, the dynamic type code system and the JIT will be
341    available for C developers to integreate with their applications if
342    they wish to do so. 
343
344 Q: Will you have new development tools?
345
346 A: Hopefully Free Software enthusiasts will contribute tools to
347    improve the developer environment.  These tools could be developed
348    initially using Microsoft implementation of the CLI and then
349    executed later with Mono.
350
351 ** Mono and Java
352    
353 Q: What about using Java?  After all there are many languages that
354    target the Java VM.
355
356 A: You can get very good tools for doing Java development on free
357    systems right now.  <a href="http://www.redhat.com">Red Hat</a> has
358    contributed a <a href="http://gcc.gnu.org">GCC</a> <a
359    href="http://gcc.gnu.org/java">frontend for Java</a> that can take
360    Java sources or Java byte codes and generate native executables; <a
361    href="http://www.transvirtual.com">Transvirtual</a> has implemented
362    <a href="http://www.kaffe.org">Kaffe</a> a JIT engine for Java;
363    Intel also has a Java VM called <a
364    href="http://www.intel.com/research/mrl/orp">ORP</a>.
365
366    The JVM is not designed to be a general purpose virtual machine.
367    The Common Intermediate Language (CIL), on the other hand, is
368    designed to be a target for a
369    wide variety of programming languages, and has a set of rules
370    designed to be optimal for JITers.
371
372
373 Q: What kind of rules make the Common Intermediate Language useful for
374    JITers?
375
376 A: The main rule is that the stack in the CLI is not a general purpose
377    stack.   You are not allowed to use it for other purposes than
378    computing values and passing arguments to functions or return
379    values.  
380
381    At any given call or return instruction, the types on the stack
382    have to be the same independently of the flow of execution of your
383    code. 
384
385 Q: I heard that the CIL is ideal for JITing and not efficient for
386    interpreters, is this the case?
387
388 A: The CIL is better suited to be JITed than JVM byte codes, but you
389    can interpret them as trivially as you can interpret JVM byte
390    codes. 
391
392 ** Extending Mono
393
394 Q: Would you allow other classes other than those in the
395    specification?
396
397 A: Yes.  The Microsoft class collection is very big, but it is by no
398    means complete.  It would be nice to have a port of `Camel' (the
399    Mail API used by Evolution inspired by Java Mail) for Mono
400    applications.  
401
402    You might also want to look into implementing CORBA for Mono.  Not
403    only because it would be useful, but because it sounds like a fun
404    thing to do, given the fact that the CLI is such a type rich
405    system. 
406
407    For more information on extending Mono, see our <a
408    href="ideas.html">ideas</a> page.
409
410 ** Mono and portability
411
412 Q: Will Mono only work on Linux?
413
414 A: Currently, we are doing our work on Linux-based systems and
415    Windows.  We do not expect many Linux-isms in the code, so it
416    should be easy to port Mono to other UNIX variants.   
417
418 Q: What about Mono on non X-based systems?
419
420 A: Our main intention at Ximian is to be able to develop GNOME
421    applications with Mono, but if you are interested in providing a
422    port of the Winform classes to other platforms (frame buffer or
423    MacOS X for example), we would gladly integrate them, as long
424    they are under a Free Software License. 
425
426 ** Reusing existing Code
427
428 Q: What projects will you reuse or build upon?
429
430 A: We want to get Mono in the hands of programmers soon.  We are
431    interested in reusing existing open source software.
432
433 Q: What about Intel's research JIT framework, ORP?
434
435 A: At this time, we are investigating whether we can use elements of
436    ORP for Mono.   ORP is a research JIT engine that has a clear
437    defined API that splits the JIT from the GC system and the actual
438    byte code implementation.   It is a research product.
439
440 Q: What about using GNU Lightning?
441
442 A: We are also researching <a
443    href="http://www.gnu.org/software/lightning/lightning.html">GNU
444    Lightning</a>.
445
446 ** Ximian and Microsoft
447
448 Q: Didn't Miguel de Icaza say that `Unix Sucks'?
449
450 A: Yes, he did, as a catch phrase in his opening remark on the Ottawa
451    Linux Symposium.  His talk focused on various ways to improve Unix.
452
453    There is a paper describing some ways to improve Unix at:
454
455         <a href="http://primates.ximian.com/~miguel/bongo-bong.html">
456         http://primates.ximian.com/~miguel/bongo-bong.html</a>
457
458 Q: Didn't Ximian's Miguel work for Microsoft?
459
460 A: Actually, Nat Friedman (Ximian's co-founder) did work as an
461    intern for Microsoft for one summer but Miguel did not.
462
463 Q: Did Nat and Miguel meet at Microsoft?
464
465 A: They met online on the Linux IRC network;  They met in person for
466    the first time in 1997.
467
468 ** Mono and Microsoft
469    
470 Q: How can you expect Mono to compete with Microsoft, wont this
471    require an effort too large?
472
473 A: You are right.  Mono will never become a reality without the help
474    of other contributors.  Ximian is a small company that can not
475    finish Mono alone.  We will be working with members of the
476    community to deliver the product.
477
478 Q: Is Microsoft and Corel involved in the Mono implementation?
479
480 A: No, they are not.
481
482 Q: Are you writing Mono from the ECMA specs?
483
484 A: yes, we are writing them from the ECMA specs and the published
485    materials in print about .NET
486
487 ** Acronyms
488
489 Q: What is the difference between CLR (Common Language Runtime) and
490    CLI (Common Language Infrastructure)?
491
492 A: CLI is the specification of an execution system.  The Microsoft
493    implementation of this specification is named CLR. 
494
495    Unless we come up with our own acronym, we could just call ours
496    also CLR, just because it would do exactly the same thing the
497    Microsoft implementation does.
498
499 <a name="gcc">
500 ** Mono and GCC
501
502 Q: Should someone work on a GCC front-end to C#?
503
504 A: I would love if someone does, and we would love to help anyone that
505    takes on that task, but we do not have the time or expertise to
506    build a C# compiler with the GCC engine.  I find it a lot more fun
507    personally to work on C# on a C# compiler, which has an intrinsic
508    beauty.
509
510 Q: Should someone make a GCC backend that will generate CIL images?
511
512 A: I would love to see a backend to GCC that generates CIL images.  It
513    would provide a ton of free compilers that would generate CIL
514    code.  This is something that people would want to look into
515    anyways for Windows interoperation in the future.
516
517 Q: What about making a front-end to GCC that takes CIL images and
518    generates native code?
519
520 A: I would love to see this, specially since GCC supports this same
521    feature for Java Byte Codes.  You could use the metadata library
522    from Mono to read the byte codes (ie, this would be your
523    "front-end") and generate the trees that get passed to the
524    optimizer.
525
526    Ideally our implementation of the CLI will be available as a shared
527    library that could be linked with your application as its runtime
528    support. 
529
530 Q: But would this work around the GPL in the GCC compiler and allow
531    people to work on non-free front-ends?
532
533 A: People can already do this by targeting the JVM byte codes (there
534    are about 130 compilers for various languages that target the JVM).
535
536 Q: Why are you writing a JIT engine instead of a front-end to GCC?
537
538 A: The JIT engine and runtime engine will be able to execute CIL
539    executables generated on Windows.
540
541 ** Mono and GNU
542
543 Q: Is Mono part of the GNU project?
544
545 A: Mono is a Ximian project, that is also part of the GNU project.
546
547 ** Mono and Portability
548
549 Q: Will Mono work on other variants of Unix?
550
551 A: Yes.  We do not expect to add any gratuitous incompatibilities.
552
553 Q: Will Mono run on Windows?
554
555 A: Hopefully yes.  Currently some parts of Mono only run on Windows
556    (the C# compiler is a .NET executable) and other parts have only
557    been compiled on Linux, but work on Windows with Cygwin.
558
559 Q: Will Mono depend on GNOME?
560
561 A: It will depend only if you are using a particular assembly (for
562    example, for doing GUI applications).  If you are just interested
563    in Mono for implementing a `Hello World Enterprise P2P Web
564    Service', you will not need any GNOME component.
565
566 ** Performance
567
568 Q: How fast will be Mono?
569
570 A: We can not predict the future, but a conservative estimate is that
571    it would be at least `as fast as other JIT engines'.
572
573    Now, wishfully thinking I hope that we will ship various JITs with
574    Mono just like Microsoft has done.  A fast JITer when maximum
575    performance is not needed, but fast load times are important;  And
576    an optimizing JITer that would be slower at generating code but
577    produce more optimal output.
578
579    The CIL has some advantages over the Java byte code:  it is really
580    an intermediate representation and there are a number of
581    restrictions on how you can emit CIL code that simplify creating
582    better JIT engines.
583
584    For example, on the CIL the stack is not really an abstraction
585    available for the code generator to use at will: it is just a way
586    of creating a postfix representation of the parsed tree.  At any
587    given call point or return point, the contents of the stack are
588    expected to contain the same object types independently of how the
589    instructions was reached.
590
591 ** Assorted questions
592
593 Q: You say that the CLI allows multiple languages to execute on the
594    same environment.  Isn't this the purpose of CORBA?
595
596 A: CORBA can be used for this purpose, but think of CORBA mostly as a
597    inter-process (local machine or remote machine) communication
598    system.  
599
600    Think of the CLI to be targeted to interoperation of languages in
601    the same process, and CORBA as being a nifty addition for
602    out-of-process.  
603
604    Sure, we have used CORBA for in-proc components, but the lack of an
605    ABI for in-proc components does not translate into a good framework
606    for in-proc systems
607
608    
609