re-implement the entire compiler options section #22659
Description
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.
- Modern project file (
- 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