Configure: add note about nvsize sometimes lying master
authorH.Merijn Brand - Tux <h.m.brand@xs4all.nl>
Fri, 6 Mar 2015 12:40:14 +0000 (13:40 +0100)
committerH.Merijn Brand - Tux <h.m.brand@xs4all.nl>
Fri, 6 Mar 2015 12:40:14 +0000 (13:40 +0100)
Lying in case you expect that many bytes being used for NV.

Backport of 0cd93aca4e274765289e9e01d34c4a5dcf06df1c
Author: Jarkko Hietaniemi <jhi@iki.fi>  2015-03-02 13:00:33

U/modified/d_longdbl.U
U/perl/perlxv.U

index 6cd9f5f..56afbba 100644 (file)
@@ -21,7 +21,8 @@
 ?S:longdblsize:
 ?S:    This variable contains the value of the LONG_DOUBLESIZE symbol, which
 ?S:    indicates to the C program how many bytes there are in a long double,
-?S:    if this system supports long doubles.
+?S:    if this system supports long doubles.  Note that this is
+?S:    sizeof(long double), which may include unused bytes.
 ?S:.
 ?S:longdblkind:
 ?S:    This variable, if defined, encodes the type of a long double:
@@ -37,7 +38,8 @@
 ?C:LONG_DOUBLESIZE:
 ?C:    This symbol contains the size of a long double, so that the
 ?C:    C preprocessor can make decisions based on it.  It is only
-?C:    defined if the system supports long doubles.
+?C:    defined if the system supports long doubles.  Note that this
+?C:    is sizeof(long double), which may include unused bytes.
 ?C:.
 ?C:HAS_LDEXPL:
 ?C:    This symbol, if defined, indicates that the ldexpl routine is
index 01c4d29..b5e0be0 100644 (file)
@@ -79,7 +79,8 @@
 ?S:    This variable is the size of an U64 in bytes.
 ?S:.
 ?S:nvsize:
-?S:    This variable is the size of an NV in bytes.
+?S:    This variable is the size of a Perl NV in bytes.
+?S:    Note that some floating point formats have unused bytes.
 ?S:.
 ?S:d_nv_preserves_uv:
 ?S:    This variable indicates whether a variable of type nvtype
 ?C:.
 ?C:NVSIZE:
 ?C:    This symbol contains the sizeof(NV).
+?C:    Note that some floating point formats have unused bytes.
+?C:    The most notable example is the x86* 80-bit extended precision
+?C:    which comes in byte sizes of 12 and 16 (for 32 and 64 bit
+?C:    platforms, respectively), but which only uses 10 bytes.
+?C:    Perl compiled with -Duselongdouble on x86* is like this.
 ?C:.
 ?C:NV_PRESERVES_UV:
 ?C:    This symbol, if defined, indicates that a variable of type NVTYPE