**** Merged from MCS ****

[mono.git] / man / mcs.1

diff --git a/man/mcs.1 b/man/mcs.1
index e135642da1207385554c6629d7d4b4d7b6404e56..c3f9484b17a582f56d65dc454eb2065f551e1172 100755 (executable)
--- a/man/mcs.1
+++ b/man/mcs.1
@@ -70,6 +70,21 @@ resource.
 .I \-debug-
 Do not generate debugging information.
 .TP
+.I \-delaysign+
+Only embed the strongname public key into the assembly. The actual 
+signing must be done in a later stage using the SN tool. This is useful
+to protect the private key during development. Note that delay signing
+can only be done using a strongname key file (not a key container). The
+option is equivalent to including [assembly: AssemblyDelaySign (true)] 
+in your source code. Compiler option takes precedence over the 
+attributes.
+.TP
+.I \-delaysign-
+Default. Strongname (sign) the assembly using the strong name key file
+(or container). The option is equivalent to including [assembly: 
+AssemblyDelaySign (false)] in your source code. Compiler option takes
+precedence over the attributes.
+.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.
@@ -78,9 +93,34 @@ named `X' in line `L'.  This is only used by the test suite.
 This is used for debugging the compiler.  This makes the error emission
 generate an exception that can be caught by a debugger.
 .TP
-.I \-\-stacktrace
-Generates a stack trace at the time the error is reported, useful for
-debugging the compiler.
+.I \-keyfile:KEYFILE
+Strongname (sign) the output assembly using the key pair present in 
+the specified strong name key file (snk). A full key pair is required
+by default (or when using delaysign-). A file containing only the
+public key can be used with delaysign+. The option is equivalent to 
+including [assembly: AssemblyKeyFile ("KEYFILE")] in your source code.
+Compiler option takes precedence over the attributes.
+.TP
+.I \-keycontainer:CONTAINER
+Strongname (sign) the output assembly using the key pair present in 
+the specified container. Note that delaysign+ is ignored when using 
+key containers. The option is equivalent to including [assembly: 
+AssemblyKeyName ("CONTAINER")] in your source code. Compiler option 
+takes precedence over the attributes.
+.TP
+.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
@@ -90,6 +130,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.
@@ -108,6 +152,16 @@ Names the output file to be generated.
 .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
@@ -131,9 +185,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
@@ -220,7 +278,7 @@ Please read the accompanying `COPYING' file for details.  Alternative
 licenses are available from Ximian.
 .PP
 .SH SEE ALSO
-mono(1), mint(1)
+mono(1), mint(1), sn(1)
 .PP
 .SH BUGS
 To report bugs in the compiler, you can use `bug-buddy', or you can