From: Martin Liska <mliska@suse.cz>
Date: Thu, 29 Mar 2018 13:02:23 +0000 (+0200)
Subject: Documentation tweaks.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=c7cb6c178884b04ab1befcf643d4e63f6b48a511;p=gcc.git

Documentation tweaks.

2018-03-29  Martin Liska  <mliska@suse.cz>

        PR lto/84995.
        * doc/invoke.texi: Document how LTO works with debug info.
        Describe auto-load support of binutils.  Mention 'x86-64'
        as valid option value of -march option.

From-SVN: r258953
---

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 45542ecf9be..2c044f7bc1b 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,10 @@
+2018-03-29  Martin Liska  <mliska@suse.cz>
+
+        PR lto/84995.
+        * doc/invoke.texi: Document how LTO works with debug info.
+        Describe auto-load support of binutils.  Mention 'x86-64'
+        as valid option value of -march option.
+
 2018-03-29  Jakub Jelinek  <jakub@redhat.com>
 
 	* config/i386/sse.md (<avx512>_blendm<mode>): Use <sseintprefix>.
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index feacd569ef3..4dc935d98c0 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -9483,9 +9483,8 @@ strict version check, so bytecode files generated in one version of
 GCC do not work with an older or newer version of GCC.
 
 Link-time optimization does not work well with generation of debugging
-information.  Combining @option{-flto} with
-@option{-g} is currently experimental and expected to produce unexpected
-results.
+information on systems other than those using a combination of ELF and
+DWARF.
 
 If you specify the optional @var{n}, the optimization and code
 generation done at link time is executed in parallel using @var{n}
@@ -9565,6 +9564,11 @@ need to support linker plugins to allow a full-featured build environment
 @command{gcc-nm}, @command{gcc-ranlib} wrappers to pass the right options
 to these tools. With non fat LTO makefiles need to be modified to use them.
 
+Note that modern binutils provide plugin auto-load mechanism.
+Installing the linker plugin into @file{$libdir/bfd-plugins} has the same
+effect as usage of the command wrappers (@command{gcc-ar}, @command{gcc-nm} and
+@command{gcc-ranlib}).
+
 The default is @option{-fno-fat-lto-objects} on targets with linker plugin
 support.
 
@@ -26440,6 +26444,9 @@ the result might not run on different machines).  Using @option{-mtune=native}
 produces code optimized for the local machine under the constraints
 of the selected instruction set.  
 
+@item x86-64
+A generic CPU with 64-bit extensions.
+
 @item i386
 Original Intel i386 CPU@.