maxmustermann/dotnet-core
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Fix link to portable pdb spec (#4569)

Browse source 
* Fix link to portable pdb spec

* Update Documentation/diagnostics/portable_pdb.md

Co-Authored-By: Maira Wenzel <mairaw@microsoft.com>

Co-authored-by: Maira Wenzel <mairaw@microsoft.com>
This commit is contained in:
Bruno Garcia 2020-04-20 15:59:19 -03:00 committed by GitHub
parent dc05cc993e
commit 941bae17b9
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 1 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

3
Documentation/diagnostics/portable_pdb.md
View file

@ -9,7 +9,7 @@ The Windows PDB format has been around a long time now (~25 years), and it evolv
## Why a new format? ##
While the Windows PDB format has worked okay over the years, with .NET Core the [Roslyn](https://github.com/dotnet/roslyn/wiki/Roslyn%20Overview) team decided it was time to go back to the drawing board and come up with a new format. A few of the reasons:
* The Windows PDB format is complex, and not well documented. This complexity is important for some of the native code scenarios that the format was designed for, but it is unnecessary for the .NET scenarios. The portable format is [open source](https://github.com/dotnet/symreader-portable) and [documented](https://github.com/dotnet/corefx/blob/master/src/System.Reflection.Metadata/specs/PortablePdb-Metadata.md).
* The Windows PDB format is complex, and not well documented. This complexity is important for some of the native code scenarios that the format was designed for, but it is unnecessary for the .NET scenarios. The portable format is [open source](https://github.com/dotnet/symreader-portable) and [documented](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md).
* At the time the effort was begun there wasn't a cross-platform library that could read or write the original windows PDB format.
* The Windows PDB format is not a compact representation for managed code. Significant size reductions can be obtained with a new format without losing any information.
@ -32,4 +32,3 @@ Over time we plan to shrink this list of non-supported scenarios so that portabl
<sup id="fn1">1. When running on .NET Framework 4.7.2 with an app that targets earlier .NET Framework versions we anticipate having an opt-in configuration switch as an additional mechanism to enable support for older applications<a href="#ref1" title="Jump back to footnote 1 in the text.">↩</a></sup>