flush
[mono.git] / web / faq
diff --git a/web/faq b/web/faq
index ac4780023a80109f6a81034e47da18879293d726..5024fa67fdb7275a925b59af292ee4a15fc082e8 100644 (file)
--- a/web/faq
+++ b/web/faq
@@ -1,9 +1,10 @@
 <a href="#basics">Basics</a><br>
-<a href="#ximian">The Ximian Role in the Mono project</a><br>
+<a href="#novell">The Novell Role in the Mono project</a><br>
 <a href="#gnome">Mono and GNOME</a><br>
 <a href="#gui">Building GUI applications with Mono</a><br>
 <a href="#msft">Mono and Microsoft</a><br>
 <a href="#platforms">Mono platforms</a><br>
+<a href="#compatibility">Compatibility</a></br>
 <a href="#pnpproject">Mono and the Portable.NET Project</a><br>
 <a href="#webservices">Web Services</a><br>
 <a href="#asp">Mono and ASP.NET</a><br>
@@ -38,14 +39,55 @@ A: The Mono Project is an open development initiative sponsored by
    implement various technologies developed by Microsoft that have now
    been submitted to the ECMA for standardization.
 
+   The Mono project has also sparked a lot of interest in developing
+   C#-based components, libraries and frameworks.  Today Mono is not
+   limited to implement the .NET Framework, but also contains other
+   components.  Some of the components of the Mono platform were
+   developed by the Mono team, and some others we have incorporated
+   from other open source efforts, the most important ones:
+
+   <ul>
+       <li><a
+       href="http://remoting-corba.sourceforge.net/">Remoting.CORBA</a>: A
+       CORBA implementation for Mono.
+
+       <li>Ginzu: An implementation on top of Remoting for the <a
+       href="http://www.zeroc.com">ICE</a> stack
+
+       <li><a href="http://gtk-sharp.sf.net">Gtk#</a>: Bindings for
+       the popular Gtk+ GUI toolkit for Unix and Windows systems.
+       Other bindings are available: Diacanvas-Sharp and MrProject.
+
+       <li><a
+       href="http://www.icsharpcode.net/OpenSource/SharpZipLib/Default.aspx">#ZipLib</a>:
+       A library to manipulate various kinds of compressed files and
+       archives (Zip and tar).
+
+       <li>GlGen (available from the Mono CVS): Bindings for OpenGL.
+
+       <li>Mono.LDAP: LDAP access for .NET apps.
+
+       <li>Mono.Data: We ship support for Postgress, MySql, Sybase,
+       DB2, SqlLite, Tds (SQL server protocol) and Oracle databases. 
+
+       <li>Mono.Cairo: Bindings for the <a
+       href="http://www.cairographics.org">Cairo</a> rendering
+       engine (Our System.Drawing is implemented on top of this).
+
+       <li>Mono.Posix: Bindings for building POSIX applications using
+       C#. 
+
+       <li>Mono.Http: Support for creating custom, embedded HTTP
+       servers and common HTTP handlers for your applications.
+   </ul>
+
 Q: What is the difference between Mono and the .NET Initiative?
 
 A: The ".NET Initiative" is a somewhat nebulous company-wide effort by
    Microsoft, one part of which is a cross-platform development
    framework.  Mono is an implementation of the development framework,
    but not an implementation of anything else related to the .NET
-   Initiative, such as Passport, software-as-a-service, or
-   corporate re-branding.
+   Initiative, such as Passport or software-as-a-service.
 
 Q: What technologies are included in Mono?
 
@@ -58,7 +100,9 @@ A: Mono contains a number of components useful for building new
                  compiler, and a garbage collecting runtime.
 
                * A class library that can work with any language
-                 which works on the CLR.
+                 which works on the CLR.  Both .NET compatible class
+                 libraries as well as Mono-provided class libraries
+                 are included.
 
                * A compiler for the C# language.  In the future we
                  might work on other compilers that target the Common
@@ -102,38 +146,26 @@ Q: Will you offer an ECMA-compliant set of class libraries?
 
 A: Eventually we will.  Our current focus is on inter-operating
    with the Microsoft SDK, but we will also offer an ECMA compliant
-   set of libraries. 
+   subset of the libraries. 
 
 Q: What does the name "Mono" mean?
 
-A: Mono is the word for `monkey' in Spanish. We like monkeys.
+A: Mono is the word for `monkey' in Spanish. We like monkeys.  
 
-Q: Is Mono usable?
+Q: Does Mono work today?
 
-A: The JIT engine is usable on Intel x86 machines.  An interpreter
-   can be used on other non-Intel x86 machines.  
+A: The execution engine works on various platforms, we support
+   Just-in-Time and Ahead-of-Time compilations on Intel x86 machines
+   (and soon PowerPC).
 
-   The class libraries are mature enough to run some real applications
-   (the compiler for instance, and every day more and more applications
-   are natively developed with Mono).
+   The class libraries are mature enough to run various real
+   applications: our C# compiler, ASP.NET, and Gtk#-based
+   applications.
 
-Q: When will you ship it?
+Q: When will you ship Mono?
 
-A: Different parts of Mono will achieve usability at different stages,
-   once we are comfortable with the compiler, we will release "Mono Core",
-   which contains everything needed to develop applications with the base
-   class libraries, this will happen soon and in the meantime you can 
-   download daily snapshots of our work. Also the full ASP.NET support is 
-   close to completion. 
-
-   Other higher level class libraries (ASP.NET, ADO.NET, WinForms) will
-   be released when they become stable. 
-
-Q: What major components will you include in Mono?
-
-A: Hopefully everything that Microsoft ships on their Framework
-   (ADO.NET, ASP.NET, WinForms), and we encourage third party developers to 
-   create reusable components that work on both Mono and Windows.
+A: Please see the <a href="mono-roadmap.html">Mono Roadmap</a> for
+   more details on the release plans.  
 
 Q: How can I contribute?
 
@@ -155,26 +187,26 @@ Q: Miguel said once that Mono was being implemented in COBOL. Is that true?.
 A: No. It was a joke.
 
 
-<a name="ximian"></a> 
+<a name="novell"></a> 
 
-** The Ximian Role in the Mono Project
+** The Novell Role in the Mono Project
 
-Q: Why is Ximian working on .NET?
+Q: Why is Novell working on .NET?
 
-A: Ximian is interested in providing the best tools for programmers to
-   develop applications for Free Operating Systems.  
+A: Novell is interested in providing the best tools for programmers to
+   develop applications for Free Operating Systems.
 
    For more information, read the project <a
    href="rationale.html">rationale</a> page.
 
-Q: Will Ximian be able to take on a project of this size?  
+Q: Will Novell be able to take on a project of this size?  
 
-A: Of course not. Ximian a supporter of the Mono project, but the only way
+A: Of course not.  Novell is a supporter of the Mono project, but the only way
    to implement something of this size is for the entire free software
    community to get involved. Visit the <a href="contributing.html">contributing</a> 
    page if you'd like to help out.
 
-Q: What pieces will Ximian be working on?
+Q: What pieces Novell be working on?
 
 A: We will devote most of our resources to work on the pieces which are
    on the critical path to release a development and execution
@@ -182,25 +214,30 @@ A: We will devote most of our resources to work on the pieces which are
    the real world, it will achieve a critical mass of developers to
    improve it further.
 
-Q: Will Ximian offer Mono commercially?
+Q: Will Novell offer Mono commercially?
 
 A: When Mono is ready to be shipped Ximian will offer a commercial
-   support and services for Mono. 
+   support and services for Mono. Mono components are also
+   available to be licensed commercially. For licensing details,
+   contact <a
+   href="mailto:mono-licensing@ximian.com">mono-licensing@ximian.com</a>
 
-Q: Does Ximian provide consulting services around Mono?
+Q: Does Novell provide consulting services around Mono?
 
-A: Yes, Ximian does provide consulting services around Mono to
+A: Yes, Novell does provide consulting services around Mono to
    make it suitable to your needs.  Porting the runtime engine,
    customizing it, working on specific classes or tuning the code
    for your particular needs. 
 
+   Please contact <a
+   href="mailto:mono-licensing@ximian.com">mono-licensing@ximian.com</a>
+   for consulting services information.
+
 Q: Will you wait until Mono is finished?
 
 A: Mono will ship on various stages as they mature.  Some people
-   require only a subset of the technologies, those will ship first.
-
-   More advanced features will take more time to develop.  A support
-   time line will be available in June 2002.
+   require only a subset of the technologies, those will ship first,
+   see the <a href="mono-roadmap.html">Mono Roadmap</a> for details
 
 <a name="gnome"></a> 
 ** Mono and GNOME
@@ -214,6 +251,10 @@ A: In a number of ways.  This project was born out of the need of
    implement Winforms and the Drawing2D API and are considering
    GObject support.
 
+   Mono team members work actively on the <a
+   href="http://gtk-sharp.sf.net">Gtk#</a> project: a binding of the
+   GNOME class libraries for .NET and Mono.
+
 Q: Has the GNOME Foundation or the GNOME team adopted Mono?
 
 A: Mono is too new to be adopted by those groups. We hope that the
@@ -242,7 +283,8 @@ A: Yes, we will provide a set of classes for implementing and using
 Q: Does Mono depend on GNOME?
 
 A: No, Mono does not depend on GNOME.  We use a few packages produced by
-   the GNOME team like the `glib' library.  
+   the GNOME team like the `glib' library, we also use other
+   third-party open source libraries like Cairo and ICU.
 
 Q: But will I be able to build GNOME applications?
 
@@ -250,26 +292,58 @@ A: Yes, we will enable people to write GNOME applications using Mono.
 
 Q: Do you have C# bindings for GNOME?.
 
-A: Yes, we currently bind libgnome, libgnomecanvas, and libgnomeui --
-   although I dare say I have no idea how functional the bindings are
-   outside of what I tested in the sample app. I imagine other libraries 
-   under the GNOME framework will be added on an as-needed (and as-requested) 
-   basis...although a truly good bonobo binding will have to wait on the CORBA 
-   remoting support which has been started recently.
+A: Yes, the <a href="http://gtk-sharp.sf.net">Gtk# project</a>
+   provides bindings for Gtk+, Gdk, Atk, libgnome, libgnomecanvas, and
+   libgnomeui.  Other libraries under the GNOME framework will be
+   added on an as-needed (and as-requested) basis.
 
 <a name="gui"></a>
 ** GUI applications
 
 Q: Will Mono enable GUI applications to be authored?
 
-A: Yes, you will be able to build GUI applications.  Indeed, that is our
-   main focus.  We will provide both the Windows.Forms API and the Gtk# API.
+A: Yes, you will be able to build GUI applications.  Indeed, that is
+   our main focus.  Today you can use Gtk# or #WT to develop GUI
+   applications, and support for Windows.Forms is underway.
 
 Q: What is the difference between Gtk# and System.Windows.Forms?
 
 A: Gtk# is a set of bindings for the Gtk+ toolkit for C# (and other
-   CIL-enabled languages).  System.Windows.Forms is an API defined
-   by Microsoft to build GUI applications.
+   CIL-enabled languages), it integrates natively with the Gnome
+   desktop.  System.Windows.Forms is an API defined by Microsoft to
+   build GUI applications.
+
+   Windows.Forms is currently being implemented on top of a modified
+   version of Wine that can be used as a library: WineLib.
+
+Q: Why not implement System.Windows.Forms on top of Gtk# or Qt#?
+
+A: Compatibility.
+
+   Although it is possible to run simple Windows.Forms applications
+   with the Gtk#-based backend of Windows.Forms, it is very unlikely
+   that the implementation will ever implement everything needed for
+   full compatibility with Windows.Forms.
+
+   The reason is that Windows.Forms is not a complete toolkit, and to
+   work around this problem some of the underlying Win32 foundation is
+   exposed to the programmer in the form of exposing the Windows
+   message handler (WndProc).  Any control can override this method.
+   Also developers often P/Invoke into Win32 to get to functionality
+   that was not wrapped. 
+
+   To achieve full compatibility, we would have to emulate this, and
+   it would take too long.
+
+   For more details see the <a href="winforms.html">winforms page</a>
+
+Q: Wine applications do not look like native applications, what are
+   you going to do about this?  
+
+A: We have already a few patches into our version of Windows.Forms
+   that makes Wine use the colors and font settings from your desktop,
+   improving the integration a lot.   In the future, we will continue
+   to improve this interoperability scenario.
 
 Q: Will I be able to run my smart clients on systems powered by Mono?
 
@@ -289,9 +363,7 @@ A: Gtk# is becoming very usable and you can create applications and
 
 Q: How can I compile my HelloWorld.cs which uses Gtk#?.
 
-A: Try: mcs --unsafe -o HelloWorld.exe -r glib-sharp -r pango-sharp -r
-        atk-sharp -r gdk-sharp -r gtk-sharp -r gdk-imaging-sharp
-        HelloWorld.cs
+A: Try: mcs -r:gtk-sharp HelloWorld.cs
 
 Q: Is there any way how to connect DataAdapter to some GTK# controls?
 
@@ -306,9 +378,14 @@ A: There is a sample file called `DbClient' in gtk-sharp/samples that you
 
 Q: Do you have an estimate for when Windows.Forms will be released?
 
-A: We do not know, volunteers are working on this, but there is no set
-   date yet.  The current approach is using the Wine Library to implement
-   it.
+A: The plan currently is aimed at Q3/2004.
+
+
+Q: Do you have a comparission chart about the various toolkit
+   offerings?
+
+A: A document explaining this is available at: <a
+   href="http://primates.ximian.com/~miguel/toolkits.html">http://primates.ximian.com/~miguel/toolkits.html</a>.
 
 <a name="msft"></a>
 ** Mono and Microsoft
@@ -326,7 +403,7 @@ A: There is no high level communication between Ximian and Microsoft
    Ximian was also invited to participate in the ECMA committee
    meetings for C# and the CLI.
 
-Q: Is Microsoft or Corel paying Ximian to do this?
+Q: Are Microsoft or Corel paying Ximian to do this?
 
 A: No.
 
@@ -365,13 +442,6 @@ A: No. MS Passport is unrelated to running .NET compatible applications
    produced with the Mono tools.  The only thing you will need is a
    just-in-time compiler (JIT).
 
-Q: What is a 100% .NET application?
-
-A: A `100% .NET application' is one that only uses the APIs defined
-   under the System namespace and does not use PInvoke.  These
-   applications would in theory run unmodified on Windows, Linux,
-   HP-UX, Solaris, MacOS X and others. 
-
 Q: If Microsoft will release a port of their .NET platform under the
    `Shared Source' license, why should I bother with anything else?
 
@@ -409,12 +479,6 @@ A: No, it will not.  Microsoft Office is a Windows application.  To
    learn more about running Windows applications on Intel Unix systems
    refer to <a href="http://www.winehq.com">the Wine Project</a>.
 
-Q: Will I be able to compile a Microsoft VB.NET application and execute 
-   the resultant MSIL file under MONO on Linux without converting to C# 
-   and recompiling?
-
-A: Once we have a complete VisualBasic runtime, yes.
-
 Q: Can mono run the WebMatrix?
 
 A: No. That requires System.Windows.Forms support which is not
@@ -465,6 +529,130 @@ A: Mono requires Unicode versions of Win32 APIs to run,
    Win32 libs. This is achieved by inserting -lunimono before
    -lkerner32/user32 in the linker's specs file.
 
+Q: Why support Windows, when you can run the real thing?
+
+A: There are various reasons:
+
+   <ul>
+      <li> About half the contributors to Mono are Windows developers.
+           They have many different for contributing to the effort, and
+           we find it very important to let those developers run the runtime on Windows without forcing
+           them to use a new operating system. 
+          
+      <li> Supporting Windows helps us identify the portable portions
+           of Mono from the non-portable versions of it, helping Mono
+           become more portable in the future.
+
+      <li> Mono does not heavily modify the windows registry, update system DLLs,
+          install DLLs to the Windows/System32 path.  Another words, I knew Mono would
+          not cause any legacy enterprise applications to stop working - and it
+          hasn't.  However, our CIO er is againt it because of the changes that would
+          be made to Windows 2000, such as, affecting security.
+   </ul>
+
+<a name="compatibility"></a>
+** Compatibility
+
+Q: Can Mono run applications developed with the Microsoft.NET framework?
+
+A: Yes, Mono can run applications developed with the Microsoft .NET Framework
+   on Unix.  There are a few caveats to keep in mind: Mono has not
+   been completed yet, so a few API calls might be missing; And in
+   some cases the Mono behavior *might* be incorrect.
+
+Q: Will missing API entry points be implemented?
+
+A: Yes, the goal of Mono is to implement precisely the .NET Framework
+   API (as well as compile-time selectable subsets, for those
+   interested in a lighter version of Mono).
+
+Q: If the behavior of an API call is different, will you fix it?
+
+A: Yes, we will.  But we will need your assistance for this.  If you find a bug
+   in the Mono implementation, please fill a bug report in <a
+   href="http://bugzilla.ximian.com">http://bugzilla.ximian.com</a>.
+   Do not assume we know about the problem, we might not, and using the bug tracking
+   system helps us organize the development process.
+
+Q: Can I develop my applications on Windows, and deploy on a supported
+   Mono platform (like Linux)?
+
+A: Yes, you can.  
+
+   As of today, Mono is not 100% finished, so it is sometimes useful
+   to compile the code with Mono, to find out if your application
+   depends on unimplemented functionality. 
+
+Q: Will applications run out the box with Mono?
+
+A: Sometimes they will.  But sometimes a .NET application might invoke
+   Win32 API calls, or assume certain patterns that are not correct
+   for cross-platform applications.
+
+Q: What is a 100% .NET application?
+
+A: A `100% .NET application' is one that only uses the APIs defined
+   under the System namespace and does not use P/Invoke.  These
+   applications would in theory run unmodified on Windows, Linux,
+   HP-UX, Solaris, MacOS X and others. 
+
+   Note that this requirement also holds for all assemblies used by the
+   application.  If one of them is Windows-specific, then the entire program
+   is not a 100% .NET application.
+
+   Furthermore, a 100% .NET application must not contain non-standard data
+   streams in the assembly.  For example, Visual Studio .NET will insert a 
+   <tt>#-</tt> stream into assemblies built under the "Debug" target.  
+   This stream contains debugging information for use by Visual Studio .NET; 
+   however, this stream can not be interpreted by Mono (unless you're willing 
+   to donate support).
+
+   Thus, it is recommended that all Visual Studio .NET-compiled code be
+   compiled under the Release target before it is executed under Mono.
+
+Q: Can I execute my Visual Studio .NET program (Visual Basic .NET, Visual C#,
+   Managed Extensions for C++, etc.) under Mono?
+
+A: Yes, with some reservations.
+
+   The .NET program must either be a 100% .NET application, or (somehow) have
+   all dependent assemblies available on all desired platforms.  (How to do so
+   is outside the bounds of this FAQ.)
+
+   Mono must also have an implementation for the .NET assemblies used.  For
+   example the System.EnterpriseServices namespace is part of .NET, but it
+   has not been implemented in Mono.  Thus, any applications using this
+   namespace will not run under Mono.
+
+   With regards to languages, C# applications tend to be most portable.
+
+   Visual Basic .NET applications are portable, but Mono's 
+   Microsoft.VisualBasic.dll implementation is incomplete.  It is recommended 
+   to either avoid using this assembly in your own code, only use the 
+   portions that Mono has implemented, or to help implement the missing
+   features.  Additionally, you can set 'Option Strict On', which
+   eliminates the implicit calls to the unimplemented
+   Microsoft.VisualBasic.CompilerServices.ObjectType class.  
+   (Thanks to Jörg Rosenkranz.)
+
+   Managed Extensions for C++ is least likely to operate under Mono.  Mono
+   does not support mixed mode assemblies (that is, assemblies containing both
+   managed and unmanaged code, which Managed C++ can produce).  You need a
+   fully-managed assembly to run under Mono, and getting the Visual C++ .NET
+   compiler to generate such an executable can be difficult.  You need to use
+   only the .NET-framework assemblies, not the C libraries (you can't use
+   <b>printf</b>(3) for example.), and you need to use
+   the linker options <tt>/nodefaultlib /entry:main mscoree.lib</tt> in
+   addition to the <tt>/clr</tt> compiler flag.  You can still use certain
+   compiler intrinsic functions (such as <b>memcpy</b>(3)) and the STL.
+   You should also see <a 
+   href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vcmex/html/vcgrfconvertingmanagedextensionsforcprojectsfrommixed-modetopureil.asp"
+   >Converting Managed Extensions for C++ Projects from Mixed Mode to Pure
+   Intermediate Language</a> at MSDN.
+   Finally, you can use PEVERIFY.EXE from the .NET SDK to determine if the 
+   assembly is fully managed.
+
+   Thanks to Serge Chaban for the linker flags to use.
 
 <a name="pnpproject"></a>
 ** Mono and Portable.NET
@@ -477,8 +665,22 @@ A: Most of Mono is being written using C#, with only
 
    It is easier to describe what is unique about Mono:
    <ul>
-     <li> A Just-in-Time compiler engine.  This is important for
-         making your applications fast.
+     <li> An advanced native-code compilation engine: Both
+         just-in-time compilation (JIT) and pre-compilation of CIL
+         bytecodes into native code are supported.
+
+     <li> A foundation for code optimization: The new code generator in
+         Mono builds on the experience of our first JIT engine, and enables
+         us to implement various advanced compiler optimization
+         tricks.  With an SSA-framework, plenty of new optimizations are possible. 
+
+          The current list of optimizations are: Peephole postpass,
+         Branch optimizations, Inline method calls, Constant folding, Constant
+         propagation, Copy propagation, Dead code elimination, Linear scan
+         global reg allocation, Conditional moves, Emit per-domain code,
+         Instruction scheduling, Intrinsic method implementations, Tail
+         recursion and tail calls, Loop related optimizations, Fast x86 FP
+         compares, Leaf procedures optimizations
 
      <li> A self-hosting C# compiler written in C#, which is clean, easy
           to maintain.
@@ -492,38 +694,43 @@ A: Most of Mono is being written using C#, with only
           systems, while the interpreter works on SPARC, StrongARM,
          s390 and PowerPC systems.  
 
-     <li> Supports Linux, Windows and Solaris at this point.
+         Our new compilation engine is being ported to the PowerPC.
+
+     <li> Supports Linux, BSD, Windows and Solaris at this point.
 
      <li> The JIT engine is written using a portable instruction
-          selector which not only generates good code (we are told
-          that we are faster than Rotor, but it is hard to tell) but
+          selector which not only generates good code but
           is also the foundation to re-target the JIT engine to other
           systems.  
 
-          The system employed is described in various compiler
-          books and it is very similar to what is described in the 
-          book that covers LCC, the ANSI C retargetable C compiler.
-
-     <li> The JIT engine supports in-lining, constant folding and propagation,
-
-     <li> Full support for remoting in the runtime, but the class 
-          libraries are still behind.
+     <li> Full support for remoting in the runtime.
 
      <li> The C# compiler, the JIT engine and the class libraries are
-          mature enough that the whole system is self-hosting.  This means that
-         we develop Mono completely with itself at this point.
+          mature enough that the whole system has been self-hosting
+         since April 2002.  This means that we develop Mono
+         completely with itself at this point.
 
-     <li> We are not yet done, and there is a lot of work left to be
-          done
+          By forcing ourselves to use our own code to develop our
+         tools, we bug fix problems rapidly, and the system is
+         overall more robust and tested than if we did not.
 
      <li> We have a great community of developers, without which Mono
           would not be possible.
-
-     <li> We are working on an ahead of time compilation mode to
-         pre-compile code for the target architecture (this is part
-         of our new code generation effort).
    </ul>
 
+   In general, Mono is more mature and complete since it has been used
+   to develop itself, which is a big motivator for stability and
+   correctness, while Portable.NET remains pretty much an untested
+   platform.
+
+Q: I hear Mono keeps changing the P/Invoke API, why?
+
+A: We are just fixing our implementation to be compatible with the
+   Microsoft implementation.  In other words, the Mono P/Invoke API is
+   more complete when compared to the Portable.NET version, hence
+   various pieces of software that depend on this extended
+   functionality fail to work properly with Portable.NET.
+
 <a name="webservices"></a>
 ** Web Services
 
@@ -561,10 +768,11 @@ A: Yes. The CLI contains enough information about a class that
    exposing it to other RPC systems (like CORBA) is really simple, and
    does not even require support from an object.  
 
-   We will be implementing CORBA inter-operation as an extension to the
-   Mono classes so that we can integrate with Bonobo, just like
-   Microsoft provides COM inter-operation classes and support
-   mechanisms. 
+   <a href="http://remoting-corba.sourceforge.net/">Remoting.CORBA</a> is
+   a CORBA implementation that is gaining momentum.
+
+   Building an implementation of the Bonobo interfaces once this is ready
+   should be relatively simple. 
 
 Q: Can I serialize my objects to other things other than XML?
 
@@ -573,21 +781,59 @@ A: Yes, although the serializing tools have not yet been planned, and
 
 Q: Will Mono use ORBit?
 
-A: No. Mono will be using a new implementation of CORBA that isn't still started. 
+A: There are a few advantages in using ORBit, like reusing existing code
+   and leveraging all the work done on it.  Michael Meeks has posted
+   a few <a href="http://lists.ximian.com/archives/public/mono-list/2002-September/008592.html">reasons</a>,
+   as well as some <a href="http://lists.ximian.com/archives/public/mono-list/2002-September/008657.html">ideas</a>
+   that could be used to reuse ORBit.
+
+   Most users are likely to choose a native .NET solution, like <a href="http://cvs.gnome.org/bonsai">Remoting.CORBA</a>
+
 
 <a name="monodoc"></a>
 ** MonoDoc
 
 Q: What is MonoDoc?
 
-A: MonoDoc is a graphical documentation editor and viewer. Currently, MonoDoc 
-   consists of a Gtk# application and is in heavy development. There is also a 
-   Qt# version of it.
-
+A: MonoDoc is a graphical documentation browser for the Mono class
+   libraries. Currently, monodoc consists of a Gtk# application and is
+   in heavy development.
 
 <a name="devel"></a>
 ** Development Tools and Issues
 
+Q: I am having trouble compiling a new version of Mono from CVS, it 
+   complains about my runtime being out of sync.
+
+A: To upgrade your class libraries and compiler, see the 
+   INSTALL.txt in the MCS directory.
+
+   The single biggest source of confusion seems to be the "Your
+   runtime is out of sync" messages.  Realize that this is *normal*
+   while BUILDING.  Think about it: you're building a new class
+   library with the old runtime.  If the new class library references
+   a function that the old runtime knows nothing about, the runtime
+   system issues this warning.
+
+   Basically what needs to happen is for a new mono runtime to be
+   compiled, then the corlib class library be compiled, and once this
+   is done, install the new runtime, followed by corlib.
+
+   Once this is done, you can continue building your entire
+   environment.
+
+   For instance you just need to:
+   1.- Upgrade your Mono runtime (you might better do it with the 
+   mono-build.sh script available in the <a 
+   href="http://www.go-mono.com">download</a> page.
+   2.- Get the latest mono-lite tarball from the daily snapshots 
+   <a href="http://www.go-mono.com/daily/">page</a>, unzip and 
+   untar and copy all the dll files to your install path lib 
+   directory (typically pointed by the $MONO_PATH variable).
+   Copy all the exe files to the install path bin directory.
+   3.- Then checkout or update your mcs CVS copy. Then follow 
+   the steps described in mcs/INSTALL.txt.
+
 Q: Will it be possible to use the CLI features without using byte codes
    or the JIT?
 
@@ -604,6 +850,9 @@ A: With any luck, Free Software enthusiasts will contribute tools to
    initially using the Microsoft implementation of the CLI and then
    executed later with Mono.
 
+   We are recommending people to use and contribute to existing
+   projects like SharpDevelop, Anjuta and Eclipse.
+
 Q: What kind of rules make the Common Intermediate Language useful for
    JITers?
 
@@ -631,32 +880,14 @@ A: In Mono, xsp is just the name of the C# code generator for ASP.NET
    Pages" technology so as they are very different things, they don't 
    conflict.
 
-Q: What about using something like Jabber instead of the System.Messaging 
-   namespace?.
-
-A: In short, MSMQ is not something like Jabber, but asynchronous messaging 
-   through queues. Useful queues do more than serialize messages, they are 
-   also platform bridges.
-
-Q: Are you supporting XMLDocument and relatives?.
-
-A: Currently, we aren't implementing them yet. It would require updates to 
-   most of the XmlNode derivatives so it's not a trivial task. We are 
-   currently focusing on getting XPath support working. 
-
 Q: Is there any plan to develop an aspx server for Mono?.
 
-A: The web server turned out to be very simple compared to the rest of the 
-   work. Gonzalo has got the page generator mostly done (a module called 
-   xsp, who has nothing to do with the XSP term used in the Apache Project).
-   Patrik has done a lot of the work to get the ProcessRequest to work.
-   You can try to help in the final touches to the System.Web classes and
-   writing regression tests for the widgets we have.
+A: The XSP reference server is available and you can also use mod_mono
+   with Apache.
 
 Q: Is there any way I can develop the class libraries using Linux yet?
 
-A: Yes. Some class libraries can be developed on Linux. Search for
-   Paolo's post (he lists which classes can be compiled fine now).
+A: Yes.  Mono has been self hosting since May 2002.
 
 Q: Is there any way I can install a known working copy of mono in /usr, 
    and an experimental copy somewhere else, and have both copies use 
@@ -676,37 +907,27 @@ Q: Would it be too terrible to have another corlib signed as mscorlib?
 A: We rename corlib to mscorlib also when saving the PE files, in fact, 
    the runtime can execute program created by mono just fine.  
 
-Q: Is there a relatively straightforward way to repeat the steps taken 
-   by Paolo to get Mono completely self-hosted on Linux?
-
-A: To build the compiler and class libraries in Linux, run:
-   <ul><li>make -f makefile.gnu. To install them, run: </li>
-       <li>make -f makefile.gnu install prefix=/opt/mono</li>
-   </ul>
-
-   If you want to produce and distribute a monocharge tarball, run:
-   make -f makefile.gnu dist
-   Of course you have to run these in the top level mcs directory.
-
 Q: Is it possible to build a C# file to some sort of intermediate format which 
    can linked into a final module, like the traditional .c -> .o -> .so path? 
    
-A: You could do: mcs /target:module file1.cs, mcs /target:module file2.cs, 
-   mcs /target:exe file1.dll file2.dll /out:mybin.exe
+A: You can use: 
+
+       mcs /target:library file1.cs, mcs /target:library file2.cs, 
+       mcs /target:exe file1.dll file2.dll /out:mybin.exe
 
-Q: Is there any plans for implementing remoting in the near future?, When will 
-   work in System.Runtime.Remoting.dll start?
+Q: Is there any plans for implementing remoting in the near future?
 
-A: The remoting infrastructure is in place. Some of the channels and 
-   formatters are not.
+A: The remoting infrastructure is in place.  We have implementations
+   of the TcpChannel, HttpChannel and the Soap and Binary Formatters.
+   They are compatible with .NET.
 
-Q: I'm wondering if there are any plans to start using nant to build the
-   class lib + test lib. i think that every project need/should use an
-   automated build process and nant + a couple of tools enables this. is
-   the problem that the compiler can't run nant yet?
+   However, some classes from the library may have a different binary
+   representation, because they may have a different internal data
+   structure, so for example you won't be able to exchange a Hastable
+   object between Mono and MS.NET. It should not be a problem if you
+   are using primitive types, arrays or your own classes. In any case,
+   could you post a test case?
 
-A: Maybe well be doing some sort of automated build process + testing when
-   the summer finish.
 
 Q: My C code uses the __stdcall which is not availble on Linux, how can I
    make the code portable Windows/Unix across platforms?
@@ -718,6 +939,42 @@ A: Replace the __stdcall attribute with the STDCALL macro, and include this
        #define STDCALL __attribute__((stdcall))
        #endif
 
+Q: I want to be able to execute Mono binaries, without having to use the "mono"
+   command.  How can I do this?
+
+A: From Carlos Perelló:
+
+   <i>I think that the best solution is the binfmt feature with the
+   wrapper that exists with Debian packages at:
+
+   <a href="http://www.debianplanet.org/mono/dists/unstable/main/source/admin/">http://www.debianplanet.org/mono/dists/unstable/main/source/admin/</a>
+
+   If you want use it with Big endian machines, you should apply a patch
+   (<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>)
+
+   It works really good and lets you use wine also, it reads the .exe file
+   headers and check if it's a .net executable.
+
+   This way you just execute: ./my-cool-mono-application.exe and it works
+   without the need of any wrapper.</i>
+
+Q: I see funny characters when I run programs, what is the problem?
+
+A: (From Peter Williams and Gonzalo Paniagua):
+
+   This is Red Hat 9 (probably) using UTF8 on its console; the bytes are
+   the UTF8 endianness markers.   You can do:
+        LC_ALL=C mono myexe.exe
+
+   And they wont show up.
+
+   Alternatively, you can do:
+
+        $ echo -e "\033%G"
+
+   to enable UTF-8 on the console.
+
 <a name="asp">
 ** Mono and ASP.NET
 
@@ -754,7 +1011,7 @@ A: Modules developed for Apache 2 are not compatible with Apache 1.3
 
 Q: Can I run Apache 1 and Apache 2 on the same machine?
 
-   You can always keep a copy of Apache 2 running in paralell with your Apache
+   You can always keep a copy of Apache 2 running in parallel with your Apache
    1.3 (either different port or using a reverse proxy).
 
    You can also bind the two servers to different IP addresses on the
@@ -811,50 +1068,25 @@ A: You can get very good tools for doing Java development on free
 
 Q: Could Java target the CLI?
 
-A: Yes, Java could target the CLI.  We have details on a <a
-   href="ideas.html#guavac">project</a> that someone could take on to
-   make this happen.  
+A: Yes, Java could target the CLI, Microsoft's J# compiler does that.
 
-   Microsoft has an implementation of the Java language called J# that
-   can target the CIL execution engine. 
+   The <a href="http://weblog.ikvm.net/">IKVM</a> project builds a
+   Java runtime that works on top of .NET and on top of Mono.  IKVM is
+   essentially a JIT compiler that translates from JVM bytecodes into
+   CIL instructions, and then lets the native JIT engine take over. 
 
 Q: Is it possible to write a JVM byte code to CIL converter?
 
-A: Yes, it is possible.  Here are a few starting point:
-
-       <ul>
-               * A byte code representation is really a flattened forest of
-                 trees.  Look at the Mono JIT engine to see how we compute
-                 the basic blocks (this is used to figure out the "trees").
-
-                 The forest is just an array of trees.
-
-                 Indeed, run the JIT engine with -d (mono -d prog.exe) and
-                 you will see how these trees look like.
-
-                 You will have to do something similar for Java.
-
-               * Each "forest of trees" has a meaning.  This meaning can now
-                 be translated into the equivalent "meaning" in CLR-land.
-       </ul>
+A: Yes, this is what <a href="http://weblog.ikvm.net">IKVM</a> does.
 
 Q: Could mono become a hybrid CIL/java platform?
 
-A: No. It is quite far from the philosophy of the project. The idea of Mono 
-   is, to have only _one_ VM, on which all can run. And if there existing a 
-   binary-converter from Java-.class to IL and if there existing something 
-   like J-Sharp on Mono, you can write programs in Java, which than can run 
-   on Mono. You do not need two bindings (like your example: GTK-Sharp _and_ 
-   Java-Gnome). You need only _one_ of it (GTK-Sharp). Thats the idea of Mono.
-   An other point is, that there are no people, who use Open Source-JVMs. They 
-   all prefer Suns original. But for Unix there don't exist a .NET-Framework. 
-   So it is possible, that in the future Mono is the standard .NET for Unixes.
+A: This can be obtained easily with IKVM.
 
 Q: Do you plan to implement a Javascript compiler?
 
-A: Yes. Eto Demerzal has started a Rhino port to C#.
-   After this is completed, we will begin developing
-   the JavaScript compiler.
+A: Yes.  The beginnings of the JScript compiler can be found on CVS.
+   Cesar coordinates this effort.
 
 Q: Can Mono or .NET share system classes (loaded from mscore.dll and other 
    libs) or will it behave like Sun's Java VM?
@@ -890,16 +1122,24 @@ Q: Do you plan to Embrace and Extend .NET?
 
 A: Embracing a good technology is good.  Extending technologies in
    incompatible ways is bad for the users, so we do not plan on 
-   extending the technologies.
+   making incompatible changes to the technologies.
 
    If you have innovative ideas, and want to create new classes, we 
    encourage you to make those classes operate correctly well in both
    Mono and .NET.
 
+   Today Mono ships with a number of extra libraries that were
+   developed either by members of the Mono community, or other
+   groups.  
+
+   In some cases, we have found the bits from Microsoft to be
+   incomplete, but we avoid breaking the API, instead we expose the
+   missing functionality in new assemblies (See Mono.Security and
+   System.Security).
+
 Q: Is there any way I can develop the class libraries using Linux yet?
 
-A: Yes. Some class libraries can be developed on Linux. Search for
-   Paolo's post (he lists which classes can be compiled fine now).
+A: Yes.  Mono has been selfhosting since March 2002. 
 
 Q: Is there any way I can install a known working copy of mono in /usr, 
    and an experimental copy somewhere else, and have both copies use 
@@ -928,11 +1168,14 @@ A: Our main intention at Ximian is to be able to develop GNOME
 
 Q: What operating systems/CPUs do you support
 
-A: Mono currently runs on Linux, Windows, Solaris and FreeBSD.
+A: Mono currently runs on Linux, Windows, Solaris, FreeBSD, HP-UX and
+   MacOS X.
+
    There is a JIT engine available for x86 processors that can
    generate code and optimizations tailored for a particular CPU.
 
-   Interpreters exist for the SPARC, PowerPC and StrongARM CPUs.
+   Interpreters exist for the SPARC v8, SPARC v9, Itanium, HP-PA,
+   PowerPC and StrongARM CPUs.
 
 Q: Does Mono run on Windows?
 
@@ -955,17 +1198,6 @@ A: It will depend only if you are using a particular assembly (for
    in Mono for implementing a `Hello World Enterprise P2P Web
    Service', you will not need any GNOME components.
 
-Q: Is anyone working on porting Mono to IA-64?
-
-A: Nobody is working on such port.
-
-Q: If I were about to start a Mono port to IA-64,would the same lburg code 
-   generator work for IA-64 also? or anything else need to be used for code 
-   generation(as the processor architecture is totally different from IA32)
-
-A: The lburg approach can be use for any processor architecture. But you might
-   think in another better approach.
-
 Q: Do you plan to port Rhino to C#?.
 
 A: Eto Demerzal has started a Rhino port to C#.
@@ -985,34 +1217,17 @@ Q: What projects will you reuse or build upon?
 A: We want to get Mono in the hands of programmers soon.  We are
    interested in reusing existing open source software.
 
-Q: What about Intel's research JIT framework, ORP?
-
-A: At this time, we are investigating whether we can use elements of
-   ORP for Mono.   ORP is a research JIT engine that has a clearly
-   defined API that splits the JIT from the GC system and the actual
-   byte code implementation.
-
-   We are using some pieces of ORP (Their code generation interface)
-   and we use it as a source of inspiration for optimizations.  Paolo
-   and Dietmar consider ORP as being one of the best JIT engines out
-   there (and their research work and papers are very useful if you are
-   interested in JIT technology).
-
-Q: What about using GNU Lightning?
-
-A: We are not using GNU Lightning.  Our JIT is using an instruction
-   selector based on tree-pattern matching, and a code generation
-   interface that is very tied to the current architecture.
-
 Q: Will I be able to use Microsoft SQL Server 2000 or will I need to switch
    to a specific Open Source Database. Will I need to recode?
 
-A: There should not be any need to recode.
+A: There is no need to rewrite your code as long as you keep using
+   Microsoft SQL Server.  If you want to use an open source database,
+   you might need to make changes to your code.
 
 Q: What do I need to watch out for when programming in VB.NET so that I'm
    sure to be able to run those apps on Linux?
 
-A: Not making any PInvoke or DLL calls should and not using anything in
+A: Not making any P/Invoke or DLL calls should and not using anything in
    the Microsoft.* namespaces should suffice. Also do not use any 
    Methods/Classes marked as "This type/method supports the .NET Framework 
    infrastructure and is not intended to be used directly from your code." 
@@ -1021,7 +1236,7 @@ A: Not making any PInvoke or DLL calls should and not using anything in
 Q: Will built-in reporting be supported for crystal reports? This is a
    heavily used part of our system.
 
-A: Probably not. Crystal Reports are propriety. Someone may try to emulate
+A: . Crystal Reports are propriety. Someone may try to emulate
    the behavior, but no-one has yet volunteered.
 
 Q: Who about writing to the registry? As I understand it, Linux does not have
@@ -1037,19 +1252,22 @@ A: Try to avoid it. Although there would be a emulation for registry in
 Q: System.Data.SqlClient with FreeTDS, will you port parts of these to C# and 
    use them?
 
-A: if their license is compatible with mono's, yes, we'd think about porting 
-   them. If not, we'll continue with the plan of using FreeTDS.
+A: This has been done.
 
 <a name="gcc"></a>
 ** Mono and GCC
 
 Q: Are you working on a GCC front-end to C#? A GCC back-end that will
-   generate CIL images? What about making a front-end to GCC that
-   takes CIL images and generates native code?
+   generate CIL images? 
+
+A: We would love to see a GCC modification that would generate CIL
+   images, but there is nothing at this point.
 
-A: We are currently seeking volunteers for those projects.
-   Visit the <a href="contributing.html">contributing</a> section if
-   you are interested.
+Q: What about making a front-end to GCC that takes CIL images and
+   generates native code?
+
+A: There is no active work on this area, but Mono already provides
+   pre-compilation services (Ahead-of-Time compilation).
 
 Q: But would this work around the GPL in the GCC compiler and allow
    people to work on non-free front-ends?
@@ -1057,12 +1275,6 @@ Q: But would this work around the GPL in the GCC compiler and allow
 A: People can already do this by targeting the JVM byte codes (there
    are about 130 compilers for various languages that target the JVM).
 
-Q: Why are you writing a JIT engine instead of a front-end to GCC?
-
-A: We want the JIT engine and runtime engine because they will be able
-   to execute CIL executables generated on Windows, and so no recompilation 
-   will be necessary.
-
 <a name="performance"></a>
 ** Performance
 
@@ -1071,11 +1283,9 @@ Q: How fast will Mono be?
 A: We can not predict the future, but a conservative estimate is that
    it would be at least `as fast as other JIT engines'.
 
-   We would like to ship various JIT engines with Mono, just like
-   Microsoft has done with their .NET development platform. We could
-   provide a faster, JIT for fast load times but lower performance,
-   and an and an optimizing JIT that would be slower at generating
-   code but produce more optimal output.
+   Mono's JIT engine has been recently re-architected, and it provides
+   many new features, and layers suitable for optimization.  It is
+   relatively easy to add new optimizations to Mono. 
 
    The CIL has some advantages over the Java byte code:  it is really
    an intermediate representation and there are a number of
@@ -1131,32 +1341,71 @@ Q: Could patents be used to completely disable Mono (either submarine
    patents filed now, or changes made by Microsoft specifically to
    create patent problems)?
 
-A: No.  First, its basic functional capabilities have pre-existed too
-   long to be held up by patents.  The basic components of Mono are
-   technologically equivalent to Sun's Java technology, which has been
-   around for years.  
-
-   Mono will also implement multi-language and
-   multi-architecture support, but there are previous technologies
-   such as UCSD p-code and ANDF that also support multiple languages
-   using a common intermediate language.  The libraries are similar
-   to other language's libraries, so again, they're too similar to
-   be patentable in large measure.
-
-   However, if Microsoft does patent some technology, then our plan is
-   to either (1) work around it, (2) chop out patented pieces, (3) 
-   find prior art that would render the patent useless.
+A: First some background information.
+
+   The .NET Framework is divided in two parts: the ECMA/ISO covered
+   technologies and the other technologies developed on top of it like
+   ADO.NET, ASP.NET and Windows.Forms.
+
+   Mono implements the ECMA/ISO covered parts, as well as being a
+   project that aims to implement the higher level blocks like
+   ASP.NET, ADO.NET and Windows.Forms.  
+
+   The Mono project has gone beyond both of those components and has
+   developed and integrated third party class libraries, the most
+   important being: Debugging APIs, integration with the Gnome
+   platform (Accessibility, Pango rendering, Gdk/Gtk, Glade, GnomeUI),
+   Mozilla, OpenGL, extensive database support (Microsoft only
+   supports a couple of providers out of the box, while Mono has
+   support for 11 different providers), our POSIX integration
+   libraries and finally the embedded API (used to add scripting to
+   applications and host the CLI, or for example as an embedded
+   runtime in Apache). 
+
+   The core of the .NET Framework, and what has been patented by
+   Microsoft falls under the ECMA/ISO submission.  Jim Miller at
+   Microsoft has made a statement on the patents covering ISO/ECMA,
+   (he is one of the inventors listed in the patent): <a
+   href="https://mailserver.di.unipi.it/pipermail/dotnet-sscli/msg00218.html">here</a>.
+
+   Basically a grant is given to anyone who want to implement those
+   components for free and for any purpose.
+
+   The controversial elements are the ASP.NET, ADO.NET and
+   Windows.Forms subsets.  Those are convenient for people who need
+   full compatibility with the Windows platform, but are not required
+   for the open source Mono platform, nor integration with today's
+   Mono's rich support of Linux. 
+
+   The Mono strategy for dealing with these technologies is as
+   follows: (1) work around the patent by using a different
+   implementation technique that retains the API, but changes the
+   mechanism; if that is not possible, we would (2) remove the pieces
+   of code that were covered by those patents, and also (3) find prior
+   art that would render the patent useless.
  
    Not providing a patented capability would weaken the
    interoperability, but it would still provide the free software /
    open source software community with good development tools, which
    is the primary reason for developing Mono.  
 
-   There is also a statement from Jim Miller at Microsoft, one of the
-   inventors listed in the patent: <a href="https://mailserver.di.unipi.it/pipermail/dotnet-sscli/msg00218.html">here</a>.
+   The patents do not apply in countries where software patents are
+   not allowed.
+
+   For Linux server and desktop development, we only need the ECMA
+   components, and things that we have developed (like Gtk#) or Apache
+   integration.  
 
-   For Linux desktop use, we only need the ECMA components, and things that
-   we have developed (like Gtk#).  
+Q: Is Mono only an implementation of the .NET Framework?
+
+A: Mono implements both the .NET Framework, as well as plenty of class
+   libraries that are either Unix specific, <a
+   href="http://www.gnome.org">Gnome</a> specific, or that are not
+   part of the .NET Framework but people find useful. 
+
+   The following map shows the relationship between the components:
+
+   <img src="http://primates.ximian.com/~miguel/tmp/map.png">
 
 <a name="etc"></a> 
 ** Miscellaneous Questions
@@ -1186,17 +1435,12 @@ Q: Will Ximian offer certifications on Mono or related technologies?.
 
 A: It's possible. But there is no plan about this. So the short answer is no.
 
-Q: Are there any Boehm's GC binaries?
-
-A: Yes. You can find RPMs <a href="http://java.thn.htu.se/~toor/">here</a>, though
-   if your distribution provides the correct packages, you should use those.
-   The suggested version of the Boehm GC is 6.1.
-
 Q: How can I report a bug?
 
-A: The best thing is to track down the bug and provide a simple test to
-   reproduce the bug. You can then add the bug to the 
-   <a href="http://bugzilla.ximian.com/enter_bug.cgi">bugtracking system</a>.
+A: The best thing is to track down the bug and provide a simple test
+   to reproduce the bug.  You can then add the bug to our bug tracking
+   system.  You can use our <a href="bugs.html">Bug Form</a> to enter
+   bugs for the appropriate component.
 
    Please provide information about what version of mono you're using
    and any relevant details to be able to reproduce the bug. Note that
@@ -1244,12 +1488,21 @@ A: There are several but one that is free software and uses MCS is the one
 
 Q: Is it possible to use Visual C++ with Mono?.
 
-A: Well, It's possible to run VC++ generated apps under Mono though.
+A: It's possible to run VC++ generated apps under Mono, but we do not
+   provide a Manager C++ compiler ourselves.
+
+Q: Does Mono support generics?.
+
+A: Mono doesn't support generics currently but a lot of work is being 
+   done towards it.
 
 <a name="problems"></a>
 ** Mono Common Problems
 
    If you are having problems compiling or running Mono software
    or if you think that you found a bug, etc. Please visit the
-   <a href="http://geneura.ugr.es/~jaime/deploy/mono-common-problems.html">Mono Common Problems</a> document and try there. 
+   <a href="http://monoevo.sf.net/mono-common-problems.html">Mono Common Problems</a> document and try there. 
+
+** Credits
 
+   The FAQ contains material contributed by Miguel de Icaza, Jaime Anguiano, Lluis Sánchez.