This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: incorrect place for LTO options description


On Wed, Apr 7, 2010 at 7:23 AM, Ralf Wildenhues <Ralf.Wildenhues@gmx.de> wrote:
> * Denis Onischenko wrote on Mon, Nov 02, 2009 on the gcc list:
>> description of the LTO specific options (--enable-lto, --with-libelf
>> and --enable gold) should be placed in "Options specification" section
>> instead of "Java-Specific Options" section on
>> http://gcc.gnu.org/install/configure.html
>
> Indeed.
>
> Tested 'make info pdf html'. ?OK for trunk? ?OK for the 4.5 branch once
> unfrozen?

It's ok for the branch now.

Thanks.
Richard.

> Thanks,
> Ralf
>
> Move LTO build option description to correct subheading.
>
> gcc/ChangeLog:
> 2010-04-07 ?Ralf Wildenhues ?<Ralf.Wildenhues@gmx.de>
>
> ? ? ? ?* doc/install.texi (Configuration): Move description of
> ? ? ? ?--enable-lto, --with-libelf*, --enable-gold from Java section to
> ? ? ? ?general section.
>
> diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
> index 0db368b..a0fadd8 100644
> --- a/gcc/doc/install.texi
> +++ b/gcc/doc/install.texi
> @@ -1633,6 +1633,29 @@ static data members and inline function local statics. ?Enabled by
> ?default for a native toolchain with an assembler that accepts it and
> ?GLIBC 2.11 or above, otherwise disabled.
>
> +@item --enable-lto
> +Enable support for link-time optimization (LTO). ?This is enabled by
> +default if a working libelf implementation is found (see
> +@option{--with-libelf}).
> +
> +@item --with-libelf=@var{pathname}
> +@itemx --with-libelf-include=@var{pathname}
> +@itemx --with-libelf-lib=@var{pathname}
> +If you do not have libelf installed in a standard location and you
> +want to enable support for link-time optimization (LTO), you can
> +explicitly specify the directory where libelf is installed
> +(@samp{--with-libelf=@var{libelfinstalldir}}). ?The
> +@option{--with-libelf=@var{libelfinstalldir}} option is shorthand for
> +@option{--with-libelf-include=@var{libelfinstalldir}/include}
> +@option{--with-libelf-lib=@var{libelfinstalldir}/lib}.
> +
> +@item --enable-gold
> +Enable support for using @command{gold} as the linker. ?If gold support is
> +enabled together with @option{--enable-lto}, an additional directory
> +@file{lto-plugin} will be built. ?The code in this directory is a
> +plugin for gold that allows the link-time optimizer to extract object
> +files with LTO information out of library archives. ?See
> +@option{-flto} and @option{-fwhopr} for details.
> ?@end table
>
> ?@subheading Cross-Compiler-Specific Options
> @@ -1914,30 +1937,6 @@ Use the @code{WCHAR} and Win32 W functions natively. ?Does @emph{not}
> ?add @code{-lunicows} to @file{libgcj.spec}. ?The built executables will
> ?only run on Microsoft Windows NT and above.
> ?@end table
> -
> -@item --enable-lto
> -Enable support for link-time optimization (LTO). ?This is enabled by
> -default if a working libelf implementation is found (see
> -@option{--with-libelf}).
> -
> -@item --with-libelf=@var{pathname}
> -@itemx --with-libelf-include=@var{pathname}
> -@itemx --with-libelf-lib=@var{pathname}
> -If you do not have libelf installed in a standard location and you
> -want to enable support for link-time optimization (LTO), you can
> -explicitly specify the directory where libelf is installed
> -(@samp{--with-libelf=@var{libelfinstalldir}}). ?The
> -@option{--with-libelf=@var{libelfinstalldir}} option is shorthand for
> -@option{--with-libelf-include=@var{libelfinstalldir}/include}
> -@option{--with-libelf-lib=@var{libelfinstalldir}/lib}.
> -
> -@item --enable-gold
> -Enable support for using @command{gold} as the linker. ?If gold support is
> -enabled together with @option{--enable-lto}, an additional directory
> -@file{lto-plugin} will be built. ?The code in this directory is a
> -plugin for gold that allows the link-time optimizer to extract object
> -files with LTO information out of library archives. ?See
> -@option{-flto} and @option{-fwhopr} for details.
> ?@end table
>
> ?@subsubheading AWT-Specific Options
>


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]