From c7cb6c178884b04ab1befcf643d4e63f6b48a511 Mon Sep 17 00:00:00 2001 From: Martin Liska Date: Thu, 29 Mar 2018 15:02:23 +0200 Subject: [PATCH] Documentation tweaks. 2018-03-29 Martin Liska 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 --- gcc/ChangeLog | 7 +++++++ gcc/doc/invoke.texi | 13 ++++++++++--- 2 files changed, 17 insertions(+), 3 deletions(-) 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 + + 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 * config/i386/sse.md (_blendm): Use . 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@. -- 2.30.2