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 791f3c169ce0bc6fe64f77538e09574385710e55..a2bc674790679b3cc6224aa3b8751fc8ed7bc8ef 100644 (file)
--- 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 f950c3ca3941a21466d42e11bc049f672576e557..0d2121b08675182f97143e260eab86b1c1ea3f42 100644 (file)
--- 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