diff mbox series

, Document the PowerPC --with-long-double-format={ibm,ieee} configuration options

Message ID 20180207224826.GA15076@ibm-tiger.the-meissners.org
State New
Headers show
Series , Document the PowerPC --with-long-double-format={ibm,ieee} configuration options | expand

Commit Message

Michael Meissner Feb. 7, 2018, 10:48 p.m. UTC
This patch udpates the GCC installation documentation to document the
configuration options to set the long double type on the PowerPC: I verified
that the documentation builds.  Can I install this on to the trunk?

2018-02-07  Michael Meissner  <meissner@linux.vnet.ibm.com>

	* doc/install.texi (Configuration): Document the
	--with-long-double-format={ibm,eee} PowerPC configuration
	options.

Comments

Segher Boessenkool Feb. 7, 2018, 11:26 p.m. UTC | #1
On Wed, Feb 07, 2018 at 05:48:26PM -0500, Michael Meissner wrote:
> This patch udpates the GCC installation documentation to document the
> configuration options to set the long double type on the PowerPC: I verified
> that the documentation builds.  Can I install this on to the trunk?

Yes please, thanks!  A few minor issues:

> 2018-02-07  Michael Meissner  <meissner@linux.vnet.ibm.com>
> 
> 	* doc/install.texi (Configuration): Document the
> 	--with-long-double-format={ibm,eee} PowerPC configuration
> 	options.

Typo ("ieee").

> +@item --with-long-double-format=ibm
> +@itemx --with-long-double-format-ieee

Typo ("=ieee").

> +systems.  If you are building multilibs, you will need to configure
> +the compiler using the @option{--with-system-zlib} option.

Why is that?  Is that a bug?  On BE we build multilibs all the time,
and we do not need that flag.


Segher
Michael Meissner Feb. 8, 2018, 12:01 a.m. UTC | #2
On Wed, Feb 07, 2018 at 05:26:49PM -0600, Segher Boessenkool wrote:
> On Wed, Feb 07, 2018 at 05:48:26PM -0500, Michael Meissner wrote:
> > This patch udpates the GCC installation documentation to document the
> > configuration options to set the long double type on the PowerPC: I verified
> > that the documentation builds.  Can I install this on to the trunk?
> 
> Yes please, thanks!  A few minor issues:
> 
> > 2018-02-07  Michael Meissner  <meissner@linux.vnet.ibm.com>
> > 
> > 	* doc/install.texi (Configuration): Document the
> > 	--with-long-double-format={ibm,eee} PowerPC configuration
> > 	options.
> 
> Typo ("ieee").
> 
> > +@item --with-long-double-format=ibm
> > +@itemx --with-long-double-format-ieee
> 
> Typo ("=ieee").
> 
> > +systems.  If you are building multilibs, you will need to configure
> > +the compiler using the @option{--with-system-zlib} option.

Thanks.

> Why is that?  Is that a bug?  On BE we build multilibs all the time,
> and we do not need that flag.

No idea.  I imagine we will probably see the issue if/when we add IEEE
multilibs to big endian.
diff mbox series

Patch

Index: gcc/doc/install.texi
===================================================================
--- gcc/doc/install.texi	(revision 257455)
+++ gcc/doc/install.texi	(working copy)
@@ -1877,6 +1877,35 @@  When neither of these configure options 
 128-bit @code{long double} when built against GNU C Library 2.4 and later,
 64-bit @code{long double} otherwise.
 
+@item --with-long-double-format=ibm
+@itemx --with-long-double-format-ieee
+Specify whether @code{long double} uses the IBM extended double format
+or the IEEE 128-bit floating point format on PowerPC Linux systems.
+This configuration switch will only work on little endian PowerPC
+Linux systems and on big endian 64-bit systems where the default cpu
+is at least power7 (i.e. @option{--with-cpu=power7},
+@option{--with-cpu=power8}, or @option{--with-cpu=power9} is used).
+
+If you use the @option{--with-long-double-64} configuration option,
+the @option{--with-long-double-format=ibm} and
+@option{--with-long-double-format=ieee} options are ignored.
+
+The default @code{long double} format is to use IBM extended double.
+Until all of the libraries are converted to use IEEE 128-bit floating
+point, it is not recommended to use
+@option{--with-long-double-format=ieee}.
+
+On little endian PowerPC Linux systems, if you explicitly set the
+@code{long double} type, it will build multilibs to allow you to
+select either @code{long double} format, unless you disable multilibs
+with the @code{--disable-multilib} option.  At present,
+@code{long double} multilibs are not built on big endian PowerPC Linux
+systems.  If you are building multilibs, you will need to configure
+the compiler using the @option{--with-system-zlib} option.
+
+If you do not set the @code{long double} type explicitly, no multilibs
+will be generated.
+
 @item --enable-fdpic
 On SH Linux systems, generate ELF FDPIC code.