quadmath INSTALL.
authorJarkko Hietaniemi <jhi@iki.fi>
Wed, 27 Aug 2014 00:49:09 +0000 (20:49 -0400)
committerJarkko Hietaniemi <jhi@iki.fi>
Fri, 19 Sep 2014 13:26:50 +0000 (09:26 -0400)
INSTALL

diff --git a/INSTALL b/INSTALL
index 4c01ca9..9448a85 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -332,12 +332,28 @@ this support (if it is available).
 Note that the exact format and range of long doubles varies:
 the most common is the x86 80-bit (64 bits of mantissa) format,
 but there are others, with different mantissa and exponent ranges.
+In fact, the type may not be called "long double" at C level, and
+therefore the C<uselongdouble> means "using floating point larger
+than double".
 
 =head3 "more bits"
 
 You can "Configure -Dusemorebits" to turn on both the 64-bit support
 and the long double support.
 
+=head3 quadmath
+
+Another option for long doubles is that gcc 4.6 and later have library
+called quadmath, which implements the IEEE 754 quadruple precision
+(128-bit, 113 bits of mantissa) floating point numbers.  The library
+works at least on x86 and ia64 platforms.  It may be part of your gcc
+installation, or you may need to install it separately.
+
+With "Configure -Dusequadmath" you can enable its use, but note the
+compiler dependency, you may need to also add "-Dcc=..."  This option
+also turns on -Duselongdouble.  At C level the type is called C<__float128>,
+(note, not "long double") but Perl source knows it as NV.
+
 =head3 Algorithmic Complexity Attacks on Hashes
 
 Perl 5.18 reworked the measures used to secure its hash function