r305743 - [docs] Coverage: document issue with the BFD linker

[Vedant Kumar via cfe-commits]

Author: vedantk
Date: Mon Jun 19 16:22:05 2017
New Revision: 305743

URL: http://llvm.org/viewvc/llvm-project?rev=305743&view=rev
Log:
[docs] Coverage: document issue with the BFD linker

Modified:
    cfe/trunk/docs/SourceBasedCodeCoverage.rst

Modified: cfe/trunk/docs/SourceBasedCodeCoverage.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/SourceBasedCodeCoverage.rst?rev=305743&r1=305742&r2=305743&view=diff
==============================================================================
--- cfe/trunk/docs/SourceBasedCodeCoverage.rst (original)
+++ cfe/trunk/docs/SourceBasedCodeCoverage.rst Mon Jun 19 16:22:05 2017
@@ -274,6 +274,11 @@ To specify an alternate directory for ra
 Drawbacks and limitations
 =========================
 
+* Prior to version 2.26, the GNU binutils BFD linker is not able link programs
+  with coverage enabled when the ``--gc-sections`` is enabled. The suggested
+  workaround is to either upgrade to a newer version of BFD, or to use the Gold
+  linker.
+
 * Code coverage does not handle unpredictable changes in control flow or stack
   unwinding in the presence of exceptions precisely. Consider the following
   function: