From b2841889930742b078313a758033449bb1a20799 Mon Sep 17 00:00:00 2001
From: Chris Sienkiewicz <chsienki@microsoft.com>
Date: Tue, 10 Apr 2018 15:54:58 -0700
Subject: [PATCH] Add Stack Trace portable PDB re-targeting guidance (#706)

* Add Stack Trace portable PDB re-targeting guidance

* Address PR comments
---
 ...-file-and-line-information-if-requested.md | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 Documentation/compatibility/Stack-traces-obtained-when-using-portable-PDBs-now-include-source-file-and-line-information-if-requested.md

diff --git a/Documentation/compatibility/Stack-traces-obtained-when-using-portable-PDBs-now-include-source-file-and-line-information-if-requested.md b/Documentation/compatibility/Stack-traces-obtained-when-using-portable-PDBs-now-include-source-file-and-line-information-if-requested.md
new file mode 100644
index 0000000..8959a50
--- /dev/null
+++ b/Documentation/compatibility/Stack-traces-obtained-when-using-portable-PDBs-now-include-source-file-and-line-information-if-requested.md
@@ -0,0 +1,51 @@
+## Stack traces obtained when using portable PDBs now include source file and line information if requested
+   
+### Scope
+Edge
+
+### Version Introduced
+4.7.2
+
+### Source Analyzer Status
+NotPlanned
+
+### Change Description
+Starting with .NET Framework 4.7.2, stack traces obtained when using portable PDBs include source file and line information when requested. In versions prior to .NET Framework 4.7.2, source file and line information would be unavailable when using portable PDBs even if explicitly requested.
+
+- [x] Quirked
+- [ ] Build-time break
+
+### Recommended Action
+For applications that target the .NET Framework 4.7.2, you can opt out of the source file and line information when using portable PDBs if it is not desirable by adding the following to the `<runtime>` section of your `app.config` file:
+
+```xml
+ <runtime>
+   <AppContextSwitchOverrides value="Switch.System.Diagnostics.IgnorePortablePDBsInStackTraces=true" />
+</runtime>
+```
+
+For applications that target earlier versions of the .NET Framework but run on the .NET Framework 4.7.2 or later, you can opt in to the source file and line information when using portable PDBs by adding the following to the `<runtime>` section of your `app.config` file:
+
+```xml
+<runtime>
+   <AppContextSwitchOverrides value="Switch.System.Diagnostics.IgnorePortablePDBsInStackTraces=false" />
+</runtime>
+```
+
+
+### Affected APIs
+* `M:System.Diagnostics.StrackTrace.#ctor(System.Boolean)`
+* `M:System.Diagnostics.StrackTrace.#ctor(System.Exception,System.Boolean)`
+* `M:System.Diagnostics.StrackTrace.#ctor(System.Exception,System.Int32,System.Boolean)`
+
+
+### Category
+Core
+
+[More information]([https://github.com/dotnet/core/blob/master/Documentation/diagnostics/portable_pdb.md])
+
+<!--
+Bug #534785
+-->
+
+