X-Git-Url: http://wien.tomnetworks.com/gitweb/?a=blobdiff_plain;f=man%2Fmcs.1;h=644b85a6e4f123c8987dae19825eeb2f34778196;hb=9cba093c6301a327c49d570f34c46a6311445518;hp=ce82ecbaafdbaca249dd0ccee2d9a1c5116c4304;hpb=c160422cd3fee6df957da88ba07ed3f01be22237;p=mono.git diff --git a/man/mcs.1 b/man/mcs.1 index ce82ecbaafd..644b85a6e4f 100644 --- a/man/mcs.1 +++ b/man/mcs.1 @@ -18,7 +18,8 @@ prepending the @ symbol to the response file name. The .I mcs compiler is used to compile against the latest Mono Base Class Library -version and fully implements C# 1.0, 2.0, 3.0 and 4.0 specifications. +version and fully implements C# 1.0, 2.0, 3.0, 4.0, 5.0 and 6.0 +specifications. .PP See the section on packages for more information. .PP @@ -94,10 +95,10 @@ or can be used by methods that have been tagged with the Conditional attribute. .TP .I \-debug, \-debug+ -Generate debugging information. To obtain stack traces with debugging +Generate debugging information. To obtain stack traces with debugging information, you need to invoke the mono runtime with the `--debug' -flag. This debugging information is stored inside the assembly as a -resource. +flag. The debugging information is stored in a MDB file located in +same output folder as produced assembly. .TP .I \-debug- Do not generate debugging information. @@ -163,7 +164,7 @@ The possible values are: .TP .I "Default" Instruct compiler to use the latest version. Equivalent is to omit the -switch (this currently defaults to the C# 4.0 language specification). +switch (this currently defaults to the C# 6.0 language specification). .TP .I "ISO-1" Restrict compiler to use only first ISO standardized features. @@ -183,11 +184,19 @@ Restrict the compiler to use only the features available in C# 3.0 Restrict the compiler to use only the features available in C# 4.0 specification. .TP -.I "future" +.I "5" +Restrict the compiler to use only the features available in C# 5.0 +specification. +.TP +.I "6" +Restrict the compiler to use only the features available in C# 6.0 +specification. +.TP +.I "experimental" Enables unstable features from upcoming versions of the language. .PP Notice that this flag only restricts the language features available to -the programmer. A version of produced assemblies can be controled using +the programmer. A version of produced assemblies can be controlled using .I SDK option. .ne @@ -218,9 +227,10 @@ Makes the compiler ignore warnings specified in the comma-separated list WARNLIST> .TP .I -optimize, -optimize+, -optimize- -Controls whether to perform optimizations on the code. -optimize and +Controls compiler code generation optimizations on the code. Using -optimize or -optimize+ will turn on optimizations, -optimize- will turn it off. -The default in mcs is to optimize+. +The default in mcs is to optimize-. The option can be mixed with -debug +but for the best debugging experience it is recommended leave the options off. .TP .I -out:FNAME, -o FNAME Names the output file to be generated. @@ -228,6 +238,9 @@ Names the output file to be generated. .I \-\-parse Used for benchmarking. The compiler will only parse its input files. .TP +.I \-pathmap:K=V[,Kn=Vn] +Sets a mapping for source path names used in generated output. +.TP .I \-pkg:package1[,packageN] Reference assemblies for the given packages. .Sp @@ -248,36 +261,13 @@ This will instruct the compiler to reference the System.* libraries available on a typical dotnet framework installation, notice that this does not include all of the Mono libraries, only the System.* ones. This is a convenient shortcut for those porting code. -.TP -.I \-pkg:olive -Use this to reference the "Olive" libraries (the 3.0 and 3.5 extended -libraries). -.TP -.I \-pkg:silver -References the assemblies for creating Moonlight/Silverlight -applications. -.TP -.I \-pkg:silverdesktop -Use this option to create Moonlight/Silverlight applications that -target the desktop. This option allows developers to consume the -Silverlight APIs with the full 2.0 profile API available to them, -unlike -.I smcs -it gives full access to all the APIs that are part of Mono. The only -downside is that applications created with silverdesktop will not run -on the browser. Typically these applications will be launched -with the -.I mopen -command line tool. -.TP -For more details see the PACKAGE section in this document .ne .RE .TP .I \-platform:ARCH Used to specify the target platform. The possible values are: anycpu, -x86, x64 or itanium. As of June 2009, the Mono runtime only have support -to emit anycpu and x86 assemblies. +anycpu32bitpreferred, arm, x86, x64 or itanium. The default option is +anycpu. .TP .I -resource:RESOURCE[,ID] Embeds to the given resource file. The optional ID can be used to @@ -529,21 +519,21 @@ funded by Ximian, Novell and Marek Safar. .SH LICENSE The Mono Compiler Suite is released under the terms of the GNU GPL or the MIT X11. Please read the accompanying `COPYING' file for details. -Alternative licensing for the compiler is available from Novell. +Alternative licensing for the compiler is available from Xamarin. .PP .SH SEE ALSO -csharp(1), mdb(1), mono(1), mopen(1), pkg-config(1), sn(1) +csharp(1), mono(1), pkg-config(1), sn(1) .PP .SH BUGS To report bugs in the compiler, you must file them on our bug tracking system, at: -http://www.mono-project.com/Bugs +http://www.mono-project.com/community/bugs/ .SH MAILING LIST -The Mono Mailing lists are listed at http://www.mono-project.com/Mailing_Lists +The Mono Mailing lists are listed at http://www.mono-project.com/community/help/mailing-lists/ .SH MORE INFORMATION The Mono C# compiler was developed by Novell, Inc -(http://www.novell.com, http) and is based on the +(http://www.novell.com) and Xamarin Inc (http://www.xamarin.com) is based on the ECMA C# language standard available here: http://www.ecma.ch/ecma1/STAND/ecma-334.htm .PP -The home page for the Mono C# compiler is at http://www.mono-project.com/CSharp_Compiler +The home page for the Mono C# compiler is at http://www.mono-project.com/docs/about-mono/languages/csharp/