re-implement the entire compiler options section

[BillWagner]

This section is too granular, out of date for modern tooling, and not easy for readers to navigate. Do the following:

• Provide an overview that shows how to set compiler options in all the following ways:
  • Modern project file (*.csproj)
  • Visual Studio UI
  • csc .NET Framework command line compiler.
• Combine all options into pages, modeled after the category organization:
  • Optimization
  • Output files
  • .NET assemblies
  • Debugging / error checking
  • Preprocessor
  • Resources
  • Miscellaneous (see if there is a better organization for these)
  • Obsolete options
• Check outstanding issues:
  • Check that we have documented recent compiler messages #5410, Missing C# compiler option #20061: Ensure we've documented the most recent messages.
  • Review/update documentation of the 'debug' C# compiler option #6773, Need to update documentation around "-debug" switch #22460: Review and update debug messages
  • Not said about that .NET Core can't build AnyCPU EXEs #18371: AnyCPU Exes on Core
  • Remove "compiler-option" suffix from file names #20162: remove compiler-option suffix from file names
• Examine closed "won't fix" issues for the correct modern fix:
  • C# compiler options specifies web.config as the only place where compiler options are set #4192 How to specify options for web pages
  • Missing compiler option: -shared #9119 shared option
  • Is csc -baseaddress useful with ASLR? #14040 base address and ASLR
  • "Compile with" comments #16748 compile with comments
  • Example please! #17370 request for samples

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 1e1ea586-7719-df69-7d8a-8a04cddb5543
• Version Independent ID: 691a6e9e-00ea-6210-c64a-659ba7930bec
• Content: C# Compiler Options
• Content Source: docs/csharp/language-reference/compiler-options/index.md
• Product: dotnet-csharp
• Technology: csharp-language-reference
• GitHub Login: @BillWagner
• Microsoft Alias: wiwagn