You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Review/update documentation of the 'debug' C# compiler option #6773
Could you please review this page and make sure that it is actually correct? Because there are a few posts that claim that parts of that documentation is wrong or outdated.
A good starting point is this question on StackOverflow. The two highest voted answers both say that this documentation is outdated and they also provide links to further information.
Document Details
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
ID: 3029908f-c2ff-3620-7d51-b9f6a3b768dc
Version Independent ID: 0f310c2a-3dc6-54a4-5014-264d7f727f2f
Also /debug:pdbonly is exactly the same as /debug:full. It's not really a Windows-only switch.
It will produce Portable PDB on Linux and Windows PDB on Windows.
@BillWagner The markdown to tag the team is @dotnet/docs, but only members of the org can use it. Users outside the org can mention people, but cannot mention groups.
Activity
rpetrusha commentedon Aug 6, 2018
Thanks, @cremor, for your feedback. We'll have to investigate before we can revise the documentation.
tmat commentedon Aug 9, 2018
https://github.com/dotnet/roslyn/blob/master/docs/compilers/CSharp/CommandLine.md has up to date documentation of the switch.
BillWagner commentedon Aug 10, 2018
The current doc is missing
/debug:portableand/debug:embeddeddescriptions.The other key change i that
/debug:pdbonlyshould be called out as a Windows only debug format. The/debug:portablewould be preferred.tmat commentedon Aug 10, 2018
Also
/debug:pdbonlyis exactly the same as/debug:full. It's not really a Windows-only switch.It will produce Portable PDB on Linux and Windows PDB on Windows.
tmat commentedon Aug 10, 2018
You can link https://github.com/dotnet/designs/blob/master/accepted/diagnostics/debugging-with-symbols-and-sources.md#pdb-formats that discusses the PDB formats.
22 remaining items
BillWagner commentedon Jan 25, 2021
@dotnet/docs should be sufficient to tag the team.
It looks like the markdown to add is the following:
sharwell commentedon Jan 25, 2021
@BillWagner The markdown to tag the team is
@dotnet/docs, but only members of the org can use it. Users outside the org can mention people, but cannot mention groups.ericsampson commentedon Jan 25, 2021
yeah unfortunately I already tried to tag the group. Really unfortunate that externals like regular devs can't tag as described in the bot note.
BillWagner commentedon Jan 25, 2021
@ericsampson
Yeah, that's annoying. I've sent email to my team and we're watching closely for comments.
akoeplinger commentedon Mar 22, 2021
#22797 didn't fully fix the original issue since https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/compiler-options/code-generation#debugtype still only mentions
pdbonly/fulland misses theportableandembeddedoptions, even thoughportableis the default and recommended option for new .NET projects now.Reopening, @BillWagner not sure if this will put it in the correct GitHub tracking state so please fix if it's wrong :)