mcs/README

   1 This contains the C# components of the Mono project.
   2
   3         * Compilers written in C#
   4
   5         * Class Libraries.
   6
   7         * Regression Test Suites
   8
   9 To install this source code, look at the INSTALL file in the `mono'
  10 package module which drives the compilation of this directory.
  11
  12 * Layout
  13 ========
  14
  15         build/
  16                 Rules, configuration and makefile components to build
  17                 this module.
  18
  19         class/
  20                 The class libraries.
  21
  22         docs/
  23                 Some notes on the compiler and the class libraries.
  24
  25         errors/
  26                 Sample programs that should generate errors by the C# compiler.
  27
  28         ilasm/
  29                 The IL assembler.
  30
  31         jay/
  32                 Yacc-based parser generator.
  33
  34         mcs/
  35                 The Mono C# compiler
  36
  37         packages/
  38                 Integrates some packages from NuGet (like Roslyn) into the build system.
  39
  40         tests/
  41                 Regression test suite for the C# compiler
  42
  43         tools/
  44                 Various small development tools: CorCompare used to compare
  45                 two assemblies for differences in the API; csharp is a C# REPL;
  46                 cil-strip trims IL from assemblies.
  47
  48 * Building Individual Directories
  49 =================================
  50
  51 You can build individual components in the hierarchy by running the command
  52 "make", and to install it use "make install".
  53
  54 By default, the 4.x profile is built, if you want to build other profiles,
  55 use the following command:
  56
  57         make PROFILE=<profilename>
  58
  59 And to install:
  60
  61         make PROFILE=<profilename> install
  62
  63 To turn on verbose mode in the build (for example to diagnose a
  64 problem), you can use the V=1 flag, like this:
  65
  66         make V=1
  67
  68 * Running Unit tests
  69 ====================
  70
  71 You can run unit tests in individual components by running the command:
  72
  73         make run-test
  74
  75 If you want to only run the tests in a single fixture (say
  76 'MonoTests.System.TypeTest'), you can use
  77
  78         make run-test TEST_FIXTURE=System.TypeTest
  79
  80 * Acknowledgements
  81 ==================
  82
  83 Thanks a lot to Sergey Chaban for his help during the development of
  84 the C# compiler.
  85