From: James E Wilson <wilson@tuliptree.org>
Date: Thu, 26 Oct 2017 20:41:20 +0000 (-0700)
Subject: Add some usage info -fdebug-prefix-map= docs.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=1cf6c17b6dbd361ed7c74414cc753e4037d0d0e8;p=gcc.git

Add some usage info -fdebug-prefix-map= docs.

	gcc/
	* doc/invoke.texi (-fdebug-prefix-map): Expand documentation.

From-SVN: r254121
---

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 791f3c169ce..a2bc6747906 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,7 @@
+2017-10-26  Jim Wilson  <wilson@tuliptree.org>
+
+	* doc/invoke.texi (-fdebug-prefix-map): Expand documentation.
+
 2017-10-26  Tom de Vries  <tom@codesourcery.com>
 
 	PR tree-optimization/82707
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index f950c3ca394..0d2121b0867 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -6982,7 +6982,12 @@ link processing time.  Merging is enabled by default.
 @item -fdebug-prefix-map=@var{old}=@var{new}
 @opindex fdebug-prefix-map
 When compiling files in directory @file{@var{old}}, record debugging
-information describing them as in @file{@var{new}} instead.
+information describing them as in @file{@var{new}} instead.  This can be
+used to replace a build time path with an install time path in the debug info.
+It can also be used to change an absolute path to a relative path by using
+@file{.} for @var{new}.  This can give more reproducible builds, which are
+location independent, but may require an extra command to tell GDB where to
+find the source files.
 
 @item -fvar-tracking
 @opindex fvar-tracking