Merge pull request #10577 from ghogen/msbuild-csc

Csc task: add some undocumented parameters

Author: prmerger-automator[bot]

docs/msbuild/csc-task.md

@@ -38,6 +38,8 @@ The following table describes the parameters of the `Csc` task.
 | `ApplicationConfiguration` | Optional `String` parameter.<br /><br /> Specifies the application configuration file containing the assembly binding settings. |
 | `BaseAddress` | Optional `String` parameter.<br /><br /> Specifies the preferred base address at which to load a DLL. The default base address for a DLL is set by the .NET Framework common language runtime. For more information, see [-baseaddress (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/baseaddress-compiler-option). |
 | `CheckForOverflowUnderflow` | Optional `Boolean` parameter.<br /><br /> Specifies whether integer arithmetic that overflows the bounds of the data type causes an exception at run time. For more information, see [-checked (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/checked-compiler-option). |
+| `ChecksumAlgorithm` | Optional `String` parameter.<br /><br /> Specifies the algorithm for calculating the source file checksum stored in the PDB file. The algorithm must be either SHA1 (default) or SHA256. See [ChecksumAlgorithm](/dotnet/csharp/language-reference/compiler-options/advanced#checksumalgorithm). |
+| `CodeAnalysisRuleset` | Optional `String` parameter. <br/><br/> Specifies a ruleset file that disables specific diagnostics. See [CodeAnalysisRuleset](/dotnet/csharp/language-reference/compiler-options/errors-warnings#codeanalysisruleset). |
 | `CodePage` | Optional `Int32` parameter.<br /><br /> Specifies the code page to use for all source code files in the compilation. For more information, see [-codepage (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/codepage-compiler-option). |
 | `DebugType` | Optional `String` parameter.<br /><br /> Specifies the debug type. `DebugType` can be `full` or `pdbonly`. The default is `full`, which enables a debugger to be attached to a running program. Specifying `pdbonly` enables source code debugging when the program is started in the debugger, but only displays assembler when the running program is attached to the debugger.<br /><br /> This parameter overrides the `EmitDebugInformation` parameter.<br /><br /> For more information, see [-debug (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/debug-compiler-option). |
 | `DefineConstants` | Optional `String` parameter.<br /><br /> Defines preprocessor symbols. For more information, see [-define (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/define-compiler-option). |
@@ -47,9 +49,11 @@ The following table describes the parameters of the `Csc` task.
 | `DocumentationFile` | Optional `String` parameter.<br /><br /> Processes documentation comments to an XML file. For more information, see [-doc (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/doc-compiler-option). |
 | `EmbedAllSources` | Optional `Boolean` parameter.<br /><br /> Embed all source files in the PDB. For more information, see [-embed (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/listed-alphabetically) |
 | `EmitDebugInformation` | Optional `Boolean` parameter.<br /><br /> If `true`, the task generates debugging information and places it in a program database (.pdb) file. If `false`, the task emits no debug information. Default is `false`. For more information, see [-debug (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/debug-compiler-option). |
+| `ErrorLog` | Optional `String` parameter.<br /><br/> Specifies a file to log all compiler and analyzer diagnostics. See [ErrorLog](/dotnet/csharp/language-reference/compiler-options/errors-warnings#errorlog). |
 | `ErrorReport` | Optional `String` parameter.<br /><br /> Provides a convenient way to report a C# internal error to Microsoft. This parameter can have a value of `prompt`, `send`, or `none`. If the parameter is set to `prompt`, you will receive a prompt when an internal compiler error occurs. The prompt lets you send a bug report electronically to Microsoft. If the parameter is set to `send`, a bug report is sent automatically. If the parameter is set to `none`, the error is reported only in the text output of the compiler. Default is `none`. For more information, see [-errorreport (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/errorreport-compiler-option). |
 | `FileAlignment` | Optional `Int32` parameter.<br /><br /> Specifies the size of sections in the output file. For more information, see [-filealign (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/filealign-compiler-option). |
 | `GenerateFullPaths` | Optional `Boolean` parameter.<br /><br /> If `true`, specifies the absolute path to the file in the compiler output. If `false`, specifies the name of the file. Default is `false`. For more information, see [-fullpaths (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/fullpaths-compiler-option). |
+| `HighEntropyVA` | Optional `Boolean` parameter<br/><br/> Enable high-entropy Address Space Layout Randomization (ASLR). See [HighEntropyVA](/dotnet/csharp/language-reference/compiler-options/security#highentropyva). |
 | `KeyContainer` | Optional `String` parameter.<br /><br /> Specifies the name of the cryptographic key container. For more information, see [-keycontainer (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/keycontainer-compiler-option). |
 | `KeyFile` | Optional `String` parameter.<br /><br /> Specifies the file name containing the cryptographic key. For more information, see [-keyfile (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/keyfile-compiler-option). |
 | `LangVersion` | Optional `String` parameter.<br /><br /> Specifies the version of the language to use. For more information, see [-langversion (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/langversion-compiler-option). |
@@ -60,12 +64,18 @@ The following table describes the parameters of the `Csc` task.
 | `NoLogo` | Optional `Boolean` parameter.<br /><br /> If `true`, suppresses display of compiler banner information. For more information, see [-nologo (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/miscellaneous#nologo). |
 | `NoStandardLib` | Optional `Boolean` parameter.<br /><br /> If `true`, prevents the import of *mscorlib.dll*, which defines the entire System namespace. Use this parameter if you want to define or create your own System namespace and objects. For more information, see [-nostdlib (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/nostdlib-compiler-option). |
 | `NoWin32Manifest` | Optional `Boolean` parameter.<br /><br /> If `true`, do not include the default Win32 manifest. |
+| `Nullable` | Optional `String` parameter.<br/><br/> Specifies the nullable context. The argument must be one of `enable`, `disable`, `warnings`, or `annotations`. See [Nullable](/dotnet/csharp/language-reference/compiler-options/language#nullable). |
 | `Optimize` | Optional `Boolean` parameter.<br /><br /> If `true`, enables optimizations. If `false`, disables optimizations. For more information, see [-optimize (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/optimize-compiler-option). |
 | `OutputAssembly` | Optional `String` output parameter.<br /><br /> Specifies the name of the output file. For more information, see [-out (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/out-compiler-option). |
 | `OutputRefAssembly` | Optional `String` parameter.<br /><br /> Specifies the name of the output reference assembly file. For more information, see [-refout (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/refout-compiler-option). |
+| `PathMap` | Optional `String` parameter.<br/><br/> Specifies how to map physical paths to source path names output by the compiler. See [PathMap](/dotnet/csharp/language-reference/compiler-options/advanced#pathmap). |
 | `PdbFile` | Optional `String` parameter.<br /><br /> Specifies the debug information file name. The default name is the output file name with a *.pdb* extension. |
 | `Platform` | Optional `String` parameter.<br /><br /> Specifies the processor platform to be targeted by the output file. This parameter can have a value of `x86`, `x64`, or `anycpu`. Default is `anycpu`. For more information, see [-platform (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/platform-compiler-option). |
+| `PreferredUILang` | Optional `String` parameter. <br/><br/> Specifies the language in which the C# compiler displays output, such as error messages. See [PreferredUILang](/dotnet/csharp/language-reference/compiler-options/advanced#preferreduilang). |
+| `PublicSign` | Optional `Boolean` parameter. <br/><br/> Publicly sign the output assembly. See [PublicSign](/dotnet/csharp/language-reference/compiler-options/security#publicsign). |
 | `References` | Optional <xref:Microsoft.Build.Framework.ITaskItem>`[]` parameter.<br /><br /> Causes the task to import public type information from the specified items into the current project. For more information, see [-reference (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/reference-compiler-option).<br /><br /> You can specify a C# reference alias in an MSBuild file by adding the metadata `Aliases` to the original "Reference" item. For example, to set the alias "LS1" in the following Csc command line:<br /><br /> `CSC /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs`<br /><br /> you would use:<br /><br /> `<Reference Include="MyCodeLibrary"> <Aliases>LS1</Aliases> </Reference>` |
+| `RefOnly` | Optional `Boolean` parameter.<br/><br/> Produce a reference assembly, instead of a full assembly, as the primary output. See [ProduceOnlyReferenceAssembly](/dotnet/csharp/language-reference/compiler-options/code-generation#produceonlyreferenceassembly). |
+| `ReportAnalyzer` | Optional `Boolean` parameter.<br/><br/> Report additional analyzer information, such as execution time. See [ReportAnalyzer](/dotnet/csharp/language-reference/compiler-options/errors-warnings#reportanalyzer). |
 | `Resources` | Optional <xref:Microsoft.Build.Framework.ITaskItem>`[]` parameter.<br /><br /> Embeds a .NET Framework resource into the output file.<br /><br /> Items passed into this parameter can have optional metadata entries named `LogicalName` and `Access`. `LogicalName` corresponds to the `identifier` parameter of the `/resource` switch, and `Access` corresponds to `accessibility-modifier` parameter. For more information, see [-resource (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/resource-compiler-option). |
 | `ResponseFiles` | Optional `String` parameter.<br /><br /> Specifies the response file that contains commands for this task. For more information, see [@ (Specify response file)](/dotnet/csharp/language-reference/compiler-options/response-file-compiler-option). |
 | `Sources` | Optional <xref:Microsoft.Build.Framework.ITaskItem>`[]` parameter.<br /><br /> Specifies one or more C# source files. |