From 1cf6c17b6dbd361ed7c74414cc753e4037d0d0e8 Mon Sep 17 00:00:00 2001 From: James E Wilson Date: Thu, 26 Oct 2017 13:41:20 -0700 Subject: [PATCH] Add some usage info -fdebug-prefix-map= docs. gcc/ * doc/invoke.texi (-fdebug-prefix-map): Expand documentation. From-SVN: r254121 --- gcc/ChangeLog | 4 ++++ gcc/doc/invoke.texi | 7 ++++++- 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 791f3c169ce0..a2bc67479067 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,7 @@ +2017-10-26 Jim Wilson + + * doc/invoke.texi (-fdebug-prefix-map): Expand documentation. + 2017-10-26 Tom de Vries PR tree-optimization/82707 diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index f950c3ca3941..0d2121b08675 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 -- 2.39.2