2005-06-03 Jordi Mas i Hernandez <jordi@ximian.com>

[mono.git] / man / mcs.1

diff --git a/man/mcs.1 b/man/mcs.1
index e65608a2b43004b644529531fa937ba16fcd5c43..96b6f3f62a4bc70dad65a2d0fb7e90b85a4ab63f 100755 (executable)
--- a/man/mcs.1
+++ b/man/mcs.1
@@ -85,6 +85,10 @@ Default. Strongname (sign) the assembly using the strong name key file
 AssemblyDelaySign (false)] in your source code. Compiler option takes
 precedence over the attributes.
 .TP
+.I \-doc:FILE
+Extracts the C#/XML documentation from the source code and stores in in
+the given FILE.
+.TP
 .I \-\-expect-error X L
 The compiler will expect the code to generate an error 
 named `X' in line `L'.  This is only used by the test suite.
@@ -108,9 +112,19 @@ key containers. The option is equivalent to including [assembly:
 AssemblyKeyName ("CONTAINER")] in your source code. Compiler option 
 takes precedence over the attributes.
 .TP
-.I \-\-stacktrace
-Generates a stack trace at the time the error is reported, useful for
-debugging the compiler.
+.I \-langversion:TEXT
+The option specifies the version of the language to use. The feature
+set is different in each C# version. This switch can be used to force
+the compiler to allow only a subset of the features.
+The possible values are:
+.nf
+
+Default - Instruct compiler to use the latest version. Equivalent
+is to omit the switch.
+
+ISO-1   - Restrict compiler to use only ISO standardized features.
+The usage of features such as generics, static classes, anonymous
+methods will lead to error.
 .TP
 .I -lib:PATHLIST
 Each path specified in the comma-separated list will direct the
@@ -120,6 +134,10 @@ compiler to look for libraries in that specified path.
 Directs the compiler to look for libraries in the specified path.
 Multiple paths can be provided by using the option multiple times.
 .TP
+.I \-main:CLASS
+Tells the compiler which CLASS contains the entry point. Useful when
+you are compiling several classes with a Main method.
+.TP
 .I \-nostdlib, -nostdlib+
 Use this flag if you want to compile the core library.  This makes the
 compiler load its internal types from the assembly being compiled.
@@ -132,12 +150,27 @@ compiler by default has references to the system assemblies.
 Makes the compiler ignore warnings specified in the comma-separeted
 list WARNLIST>
 .TP
+.I -optimize, -optimize+, -optimize-
+Controls whether to perform optimizations on the code.   -optimize and
+-optimize+ will turn on optimizations, -optimize- will turn it off.
+The default in mcs is to optimize+.
+.TP
 .I -out:FNAME, -o FNAME
 Names the output file to be generated.
 .TP
 .I \-\-parse
 Used for benchmarking.  The compiler will only parse its input files.
 .TP
+.I \-pkg:package1[,packageN]
+The compiler will invoke pkg-config --libs on the set of packages
+specified on the command line to obtain libraries and directories to
+compile the code.
+.PP
+This is typically used with third party components, like this:
+.nf
+               $ mcs -pkg:gtk-sharp demo.cs
+.fi
+.TP
 .I -resource:RESOURCE[,ID]
 Embeds to the given resource file.  The optional ID can be used to
 give a different name to the resource.  If not specified, the resource
@@ -161,9 +194,13 @@ Does recursive compilation using the specified pattern.  In Unix the
 shell will perform globbing, so you migth want to use it like this:
 .PP
 .nf
-               bash$ mcs -recurse:'*.cs' 
+               $ mcs -recurse:'*.cs' 
 .fi
 .TP
+.I \-\-stacktrace
+Generates a stack trace at the time the error is reported, useful for
+debugging the compiler.
+.TP
 .I \-target:KIND, \-t:KIND
 Used to specify the desired target.  The possible values are: exe
 (plain executable), winexe (Windows.Forms executable), library