| 1 | Copyright 2000-2020 Free Software Foundation, Inc. | 
 
 
 
 
 | 2 | Contributed by the AriC and Caramba projects, INRIA. | 
 
 
 
 
 | 3 |  | 
 
 
 
 
 | 4 | This file is part of the GNU MPFR Library. | 
 
 
 
 
 | 5 |  | 
 
 
 
 
 | 6 | The GNU MPFR Library is free software; you can redistribute it and/or modify | 
 
 
 
 
 | 7 | it under the terms of the GNU Lesser General Public License as published by | 
 
 
 
 
 | 8 | the Free Software Foundation; either version 3 of the License, or (at your | 
 
 
 
 
 | 9 | option) any later version. | 
 
 
 
 
 | 10 |  | 
 
 
 
 
 | 11 | The GNU MPFR Library is distributed in the hope that it will be useful, but | 
 
 
 
 
 | 12 | WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY | 
 
 
 
 
 | 13 | or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public | 
 
 
 
 
 | 14 | License for more details. | 
 
 
 
 
 | 15 |  | 
 
 
 
 
 | 16 | You should have received a copy of the GNU Lesser General Public License | 
 
 
 
 
 | 17 | along with the GNU MPFR Library; see the file COPYING.LESSER.  If not, see | 
 
 
 
 
 | 18 | https://www.gnu.org/licenses/ or write to the Free Software Foundation, Inc., | 
 
 
 
 
 | 19 | 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. | 
 
 
 
 
 | 20 |  | 
 
 
 
 
 | 21 | ############################################################################## | 
 
 
 
 
 | 22 |  | 
 
 
 
 
 | 23 | Changes from versions 4.0.* to version 4.1.0: | 
 
 
 
 
 | 24 | - The "épinards à la crème" release. | 
 
 
 
 
 | 25 | - Binary compatible with MPFR 4.0.*, though some minor changes in the | 
 
 
 
 
 | 26 | behavior of the formatted output functions may be visible, regarded | 
 
 
 
 
 | 27 | as underspecified behavior or bug fixes (see below). | 
 
 
 
 
 | 28 | - New --enable-formally-proven-code configure option, to use (when available) | 
 
 
 
 
 | 29 | formally proven code. | 
 
 
 
 
 | 30 | - Improved __GMP_CC and __GMP_CFLAGS retrieval (in particular for MS Windows). | 
 
 
 
 
 | 31 | - Option -pedantic is now always removed from __GMP_CFLAGS (see INSTALL). | 
 
 
 
 
 | 32 | - Changed __float128 to the type _Float128 specified in ISO/IEC TS 18661. | 
 
 
 
 
 | 33 | __float128 is used as a fallback if _Float128 is not supported. | 
 
 
 
 
 | 34 | - New function mpfr_get_str_ndigits about conversion to a string of digits. | 
 
 
 
 
 | 35 | - New function mpfr_dot for the dot product (incomplete, experimental). | 
 
 
 
 
 | 36 | - New functions mpfr_get_decimal128 and mpfr_set_decimal128 (available only | 
 
 
 
 
 | 37 | when MPFR has been built with decimal float support). | 
 
 
 
 
 | 38 | - New function mpfr_cmpabs_ui. | 
 
 
 
 
 | 39 | - New function mpfr_total_order_p for the IEEE 754 totalOrder predicate. | 
 
 
 
 
 | 40 | - The mpfr_out_str function now accepts bases from -2 to -36, in order to | 
 
 
 
 
 | 41 | follow mpfr_get_str and GMP's mpf_out_str functions (these cases gave an | 
 
 
 
 
 | 42 | assertion failure, as with other invalid bases). | 
 
 
 
 
 | 43 | - Shared caches: cleanup; really detect lock failures (abort in this case). | 
 
 
 
 
 | 44 | - The behavior of the formatted output functions (mpfr_printf, etc.) with | 
 
 
 
 
 | 45 | an empty precision field has improved: trailing zeros are kept in a way | 
 
 
 
 
 | 46 | similar to the formatted output functions from C. | 
 
 
 
 
 | 47 | - Improved mpfr_add and mpfr_sub when all operands have a precision equal to | 
 
 
 
 
 | 48 | twice the number of bits per word, e.g., 128 bits on a 64-bit platform. | 
 
 
 
 
 | 49 | - Optimized the tuning parameters for various architectures. | 
 
 
 
 
 | 50 | - Improved test coverage to 98.6% of code for x86_64. | 
 
 
 
 
 | 51 | - Bug fixes. | 
 
 
 
 
 | 52 | - MPFR manual: corrected/completed the mpfr_get_str description in order to | 
 
 
 
 
 | 53 | follow the historical behavior and GMP's mpf_get_str function. | 
 
 
 
 
 | 54 | - New: optional "make check-exported-symbols", mainly for the MPFR developers | 
 
 
 
 
 | 55 | and binary distributions, to check that MPFR does not define symbols with a | 
 
 
 
 
 | 56 | GMP reserved prefix (experimental). | 
 
 
 
 
 | 57 | - Mini-gmp support: replaced --enable-mini-gmp configure option by | 
 
 
 
 
 | 58 | --with-mini-gmp (still experimental, read doc/mini-gmp). | 
 
 
 
 
 | 59 | - A GCC bug on Sparc (present at least in old GCC 4.5.3 and 5.5.0 versions), | 
 
 
 
 
 | 60 | which made several tests fail when TLS was enabled, is now avoided in the | 
 
 
 
 
 | 61 | tests. The MPFR library itself was not affected and normal code using the | 
 
 
 
 
 | 62 | MPFR library should not be affected either. Users and distributions that | 
 
 
 
 
 | 63 | disabled TLS just because of the test failures can safely re-enable it. | 
 
 
 
 
 | 64 |  | 
 
 
 
 
 | 65 | Changes from versions 3.1.* to version 4.0.0: | 
 
 
 
 
 | 66 | - The "dinde aux marrons" release. | 
 
 
 
 
 | 67 | - MPFR now depends on GMP 5.0+ instead of 4.1+. | 
 
 
 
 
 | 68 | - API change: | 
 
 
 
 
 | 69 | Applications that call GMP's mp_set_memory_functions function to change | 
 
 
 
 
 | 70 | the allocators must first call the new function mpfr_mp_memory_cleanup | 
 
 
 
 
 | 71 | in all threads where MPFR is potentially used; this new function is | 
 
 
 
 
 | 72 | currently equivalent to mpfr_free_cache. | 
 
 
 
 
 | 73 | The reason is that the way memory allocation is done by MPFR has changed | 
 
 
 
 
 | 74 | (again), so that the current GMP allocators are used (since for some | 
 
 
 
 
 | 75 | applications, the old allocators may become invalid). | 
 
 
 
 
 | 76 | Note: Freeing the caches like this might have a performance impact on some | 
 
 
 
 
 | 77 | particular applications; if this is an issue, this could be handled for a | 
 
 
 
 
 | 78 | future MPFR version. | 
 
 
 
 
 | 79 | - Mini-gmp support via the --enable-mini-gmp configure option (experimental). | 
 
 
 
 
 | 80 | - The minimum precision MPFR_PREC_MIN is now 1, with rounding defined as | 
 
 
 
 
 | 81 | in the errata of IEEE 754-2008 and in the following IEEE 754 revision | 
 
 
 
 
 | 82 | (ties rounded away from zero). | 
 
 
 
 
 | 83 | - Shared caches for multithreaded applications. | 
 
 
 
 
 | 84 | New function mpfr_free_cache2. | 
 
 
 
 
 | 85 | - Partial support of MPFR_RNDF (faithful rounding). | 
 
 
 
 
 | 86 | - New functions: mpfr_fpif_export and mpfr_fpif_import to export and import | 
 
 
 
 
 | 87 | numbers in a floating-point interchange format, independent both on the | 
 
 
 
 
 | 88 | number of bits per word and on the endianness. | 
 
 
 
 
 | 89 | - New function mpfr_fmodquo to return the low bits of the quotient | 
 
 
 
 
 | 90 | corresponding to mpfr_fmod. | 
 
 
 
 
 | 91 | - New functions mpfr_flags_clear, mpfr_flags_set, mpfr_flags_test, | 
 
 
 
 
 | 92 | mpfr_flags_save and mpfr_flags_restore to operate on groups of flags. | 
 
 
 
 
 | 93 | - New functions mpfr_set_float128 and mpfr_get_float128 to convert from/to | 
 
 
 
 
 | 94 | the __float128 type (requires --enable-float128 and compiler support). | 
 
 
 
 
 | 95 | - New functions mpfr_buildopt_float128_p and mpfr_buildopt_sharedcache_p. | 
 
 
 
 
 | 96 | - New functions mpfr_rint_roundeven and mpfr_roundeven, completing the | 
 
 
 
 
 | 97 | other similar round-to-integer functions for rounding to nearest with | 
 
 
 
 
 | 98 | the even-rounding rule. | 
 
 
 
 
 | 99 | - New macro mpfr_round_nearest_away to add partial emulation of the | 
 
 
 
 
 | 100 | rounding to nearest-away (as defined in IEEE 754-2008). | 
 
 
 
 
 | 101 | - New functions mpfr_nrandom and mpfr_erandom to generate random numbers | 
 
 
 
 
 | 102 | following normal and exponential distributions respectively. | 
 
 
 
 
 | 103 | - New functions mpfr_fmma and mpfr_fmms to compute a*b+c*d and a*b-c*d. | 
 
 
 
 
 | 104 | - New function mpfr_rootn_ui, similar to mpfr_root, but agreeing with the | 
 
 
 
 
 | 105 | rootn function of the IEEE 754-2008 standard. | 
 
 
 
 
 | 106 | - New functions mpfr_log_ui to compute the logarithm of an integer, | 
 
 
 
 
 | 107 | mpfr_gamma_inc for the incomplete Gamma function. | 
 
 
 
 
 | 108 | - New function mpfr_beta for the Beta function (incomplete, experimental). | 
 
 
 
 
 | 109 | - New function mpfr_get_q to convert a floating-point number into rational. | 
 
 
 
 
 | 110 | - The mpfr_dump function is now described in the manual; its output format | 
 
 
 
 
 | 111 | has slightly changed. | 
 
 
 
 
 | 112 | - The mpfr_eint function now returns the value of the E1/eint1 function | 
 
 
 
 
 | 113 | for negative argument. | 
 
 
 
 
 | 114 | - The behavior of the mpfr_set_exp function changed, as it could easily | 
 
 
 
 
 | 115 | yield undefined behavior in some cases (this modifies both the API and | 
 
 
 
 
 | 116 | the ABI). | 
 
 
 
 
 | 117 | - In function mpfr_urandom, the next random state no longer depends on the | 
 
 
 
 
 | 118 | current exponent range and the rounding mode. The exceptions due to the | 
 
 
 
 
 | 119 | rounding of the random number are now correctly generated, following the | 
 
 
 
 
 | 120 | uniform distribution. | 
 
 
 
 
 | 121 | - Functions mpfr_grandom and mpfr_root are deprecated and will be removed | 
 
 
 
 
 | 122 | in a future release. | 
 
 
 
 
 | 123 | - Complete rewrite of function mpfr_sum, which now works in all cases (the | 
 
 
 
 
 | 124 | old one could take all the memory and/or crash with inputs of different | 
 
 
 
 
 | 125 | magnitudes in case of huge cancellation or table maker's dilemma). The | 
 
 
 
 
 | 126 | sign of an exact zero result is now specified, and the return value is | 
 
 
 
 
 | 127 | now the usual ternary value. Note that the position of "const" in the | 
 
 
 
 
 | 128 | mpfr_sum prototype has been fixed (the manual was correct); user code | 
 
 
 
 
 | 129 | should not be affected. | 
 
 
 
 
 | 130 | - Old, deprecated macros mpfr_add_one_ulp and mpfr_sub_one_ulp removed. | 
 
 
 
 
 | 131 | The mpfr_next* functions should be used instead. | 
 
 
 
 
 | 132 | - Internally, improved caching: a minimum of 10% increase of the precision | 
 
 
 
 
 | 133 | is guaranteed to avoid too many recomputations. | 
 
 
 
 
 | 134 | - Added internal small-precision mpz_t pool, which aims to avoid the | 
 
 
 
 
 | 135 | overhead of memory allocation, in particular. | 
 
 
 
 
 | 136 | New function mpfr_free_pool. | 
 
 
 
 
 | 137 | - Added configure option --enable-assert=none to avoid checking any assertion. | 
 
 
 
 
 | 138 | - The --enable-decimal-float configure option no longer requires | 
 
 
 
 
 | 139 | --with-gmp-build, and support for decimal floats is now automatically | 
 
 
 
 
 | 140 | detected by default (similarly for support for __float128). | 
 
 
 
 
 | 141 | - Updated tuning parameters. | 
 
 
 
 
 | 142 | - Better support for Automake 1.13+ (now used to generate the tarball). | 
 
 
 
 
 | 143 | - Dropped K&R C compatibility. | 
 
 
 
 
 | 144 | - Improved MPFR manual. | 
 
 
 
 
 | 145 | - New MPFRbench program (see the tools/bench directory). | 
 
 
 
 
 | 146 | - Major speedup in mpfr_add, mpfr_sub, mpfr_mul, mpfr_div and mpfr_sqrt when | 
 
 
 
 
 | 147 | all operands have the same precision and this precision is less than twice | 
 
 
 
 
 | 148 | the number of bits per word, e.g., less than 128 on a 64-bit computer. | 
 
 
 
 
 | 149 | - Speedup by a factor of almost 2 in the double <--> mpfr conversions | 
 
 
 
 
 | 150 | (mpfr_set_d and mpfr_get_d). | 
 
 
 
 
 | 151 | - Speedup in mpfr_log1p and mpfr_atanh for small arguments. | 
 
 
 
 
 | 152 | - Speedup in the mpfr_const_euler function (contributed by Fredrik Johansson), | 
 
 
 
 
 | 153 | in the computation of Bernoulli numbers (used in mpfr_gamma, mpfr_li2, | 
 
 
 
 
 | 154 | mpfr_digamma, mpfr_lngamma and mpfr_lgamma), in mpfr_div, in mpfr_fma | 
 
 
 
 
 | 155 | and mpfr_fms. | 
 
 
 
 
 | 156 | - Test coverage: 96.3% lines of code. | 
 
 
 
 
 | 157 | - Bug fixes. In particular: a speed improvement when the --enable-assert | 
 
 
 
 
 | 158 | or --enable-assert=full configure option is used with GCC; mpfr_get_str | 
 
 
 
 
 | 159 | now sets the NaN flag on NaN input and the inexact flag when the conversion | 
 
 
 
 
 | 160 | is inexact. For a full list, see https://www.mpfr.org/mpfr-3.1.6/#fixed | 
 
 
 
 
 | 161 | and the same section for any previous 3.1.x version (follow the links | 
 
 
 
 
 | 162 | in the "Changes..." sections). | 
 
 
 
 
 | 163 | - Microsoft Windows: Added support for thread-safe DLL (shared library). | 
 
 
 
 
 | 164 | Tested with MinGW, ICC and MSVC. | 
 
 
 
 
 | 165 | - Limited pkg-config support. | 
 
 
 
 
 | 166 | - Autotools: Under Linux, make sure that the old dtags (when supported) | 
 
 
 
 
 | 167 | are used if LD_LIBRARY_PATH is defined; otherwise "make check" would | 
 
 
 
 
 | 168 | check an installed, compatible MPFR library found in LD_LIBRARY_PATH | 
 
 
 
 
 | 169 | instead of the one that has been built with "make". | 
 
 
 
 
 | 170 | - New: optional "make check-gmp-symbols", mainly for binary distributions, | 
 
 
 
 
 | 171 | to check that MPFR does not use GMP internal symbols (experimental). | 
 
 
 
 
 | 172 |  | 
 
 
 
 
 | 173 | Changes from versions 3.0.* to version 3.1.0: | 
 
 
 
 
 | 174 | - The "canard à l'orange" release. | 
 
 
 
 
 | 175 | - The MPFR source has been reorganized. | 
 
 
 
 
 | 176 | - Dropped ansi2knr support. | 
 
 
 
 
 | 177 | - TLS support is now detected automatically. If TLS is supported, MPFR is | 
 
 
 
 
 | 178 | built as thread safe by default. To disable TLS explicitly, configure | 
 
 
 
 
 | 179 | MPFR with --disable-thread-safe. | 
 
 
 
 
 | 180 | - New --enable-gmp-internals configure option to use GMP's undocumented | 
 
 
 
 
 | 181 | functions (not from the public API). Note that library versioning is | 
 
 
 
 
 | 182 | not guaranteed to work if this option is used. | 
 
 
 
 
 | 183 | - The mpfr_urandom and mpfr_urandomb functions now return identical values | 
 
 
 
 
 | 184 | on processors with different word size (assuming the same random seed, and | 
 
 
 
 
 | 185 | since the GMP random generator does not depend itself on the word size, | 
 
 
 
 
 | 186 | cf https://gmplib.org/list-archives/gmp-devel/2010-September/001642.html). | 
 
 
 
 
 | 187 | - The mpfr_add_one_ulp and mpfr_sub_one_ulp macros (which are obsolete and | 
 
 
 
 
 | 188 | no more documented) will be removed in a future release. | 
 
 
 
 
 | 189 | - Speed improvement for the mpfr_sqr and mpfr_div functions using Mulders' | 
 
 
 
 
 | 190 | algorithm. As a consequence, other functions using those routines are | 
 
 
 
 
 | 191 | also faster. | 
 
 
 
 
 | 192 | - Much faster formatted output (mpfr_printf, etc.) with %Rg and similar. | 
 
 
 
 
 | 193 | - The --with-gmp-build configure option can now be used when the GMP | 
 
 
 
 
 | 194 | source directory and the GMP build directory are different (without | 
 
 
 
 
 | 195 | having to copy header files manually as before). | 
 
 
 
 
 | 196 | - New functions mpfr_buildopt_gmpinternals_p, mpfr_buildopt_tune_case, | 
 
 
 
 
 | 197 | mpfr_frexp, mpfr_grandom and mpfr_z_sub. | 
 
 
 
 
 | 198 | - New divide-by-zero exception (flag) and associated functions. | 
 
 
 
 
 | 199 | - The mpfr.h header can be included several times, while still supporting | 
 
 
 
 
 | 200 | optional functions (see Section "Headers and Libraries" in the manual). | 
 
 
 
 
 | 201 | - Updated tuning parameters. | 
 
 
 
 
 | 202 | - Improved MPFR manual. | 
 
 
 
 
 | 203 | - MPFR tests: libtool no longer generates wrapper scripts with "make check" | 
 
 
 
 
 | 204 | (so that running the tests under valgrind or gdb is easier). | 
 
 
 
 
 | 205 | - Internal change: the logging mechanism has been improved. | 
 
 
 
 
 | 206 | - Test coverage: 95.2% lines of code. | 
 
 
 
 
 | 207 | - Bug fixes, in particular a huge inefficiency in mpfr_exp (when the | 
 
 
 
 
 | 208 | target precision is less than MPFR_EXP_THRESHOLD) on hard-to-round | 
 
 
 
 
 | 209 | cases, which can take several minutes. | 
 
 
 
 
 | 210 | Note: The mpfr_subnormalize implementation up to MPFR 3.0.0 did not change | 
 
 
 
 
 | 211 | the flags. In particular, it did not follow the generic rule concerning | 
 
 
 
 
 | 212 | the inexact flag (and no special behavior was specified). The case of the | 
 
 
 
 
 | 213 | underflow flag was more a lack of specification. | 
 
 
 
 
 | 214 |  | 
 
 
 
 
 | 215 | Changes from versions 2.4.* to version 3.0.0: | 
 
 
 
 
 | 216 | - The "boudin aux pommes" release. | 
 
 
 
 
 | 217 | - MPFR 3.0.0 is binary incompatible with previous versions but (almost) | 
 
 
 
 
 | 218 | API compatible.  More precisely the obsolete functions mpfr_random | 
 
 
 
 
 | 219 | and mpfr_random2 have been removed, the meaning of the return type | 
 
 
 
 
 | 220 | of the function mpfr_get_f has changed, and the return type of the | 
 
 
 
 
 | 221 | function mpfr_get_z is now int instead of void.  In practice, this | 
 
 
 
 
 | 222 | should not break any existing code. | 
 
 
 
 
 | 223 | - MPFR is now distributed under the GNU Lesser General Public License | 
 
 
 
 
 | 224 | version 3 or later (LGPL v3+). | 
 
 
 
 
 | 225 | - Rounding modes GMP_RNDx are now MPFR_RNDx (GMP_RNDx kept for | 
 
 
 
 
 | 226 | compatibility). | 
 
 
 
 
 | 227 | - A new rounding mode (MPFR_RNDA) is available to round away from zero. | 
 
 
 
 
 | 228 | - The rounding mode type is now mpfr_rnd_t (as in previous versions, | 
 
 
 
 
 | 229 | both mpfr_rnd_t and mp_rnd_t are accepted, but mp_rnd_t may be | 
 
 
 
 
 | 230 | removed in the future). | 
 
 
 
 
 | 231 | - The precision type is now mpfr_prec_t (as in previous versions, both | 
 
 
 
 
 | 232 | mpfr_prec_t and mp_prec_t are accepted, but mp_prec_t may be removed | 
 
 
 
 
 | 233 | in the future) and it is now signed (it was unsigned in MPFR 2.*, but | 
 
 
 
 
 | 234 | this was not documented). In practice, this change should not affect | 
 
 
 
 
 | 235 | existing code that assumed nothing on the precision type. | 
 
 
 
 
 | 236 | - MPFR now has its own exponent type mpfr_exp_t, which is currently | 
 
 
 
 
 | 237 | the same as GMP's mp_exp_t. | 
 
 
 
 
 | 238 | - Functions mpfr_random and mpfr_random2 have been removed. | 
 
 
 
 
 | 239 | - mpfr_get_f and mpfr_get_z now return a ternary value. | 
 
 
 
 
 | 240 | - mpfr_strtofr now accepts bases from 37 to 62. | 
 
 
 
 
 | 241 | - mpfr_custom_get_mantissa was renamed to mpfr_custom_get_significand | 
 
 
 
 
 | 242 | (mpfr_custom_get_mantissa is still available via a #define). | 
 
 
 
 
 | 243 | - Functions mpfr_get_si, mpfr_get_ui, mpfr_get_sj, mpfr_get_uj, | 
 
 
 
 
 | 244 | mpfr_get_z and mpfr_get_z_2exp no longer have cases with undefined | 
 
 
 
 
 | 245 | behavior; in these cases, the behavior is now specified, and in | 
 
 
 
 
 | 246 | particular, the erange flag is set. | 
 
 
 
 
 | 247 | - New functions mpfr_buildopt_tls_p and mpfr_buildopt_decimal_p giving | 
 
 
 
 
 | 248 | information about options used at MPFR build time. | 
 
 
 
 
 | 249 | - New function mpfr_regular_p. | 
 
 
 
 
 | 250 | - New function mpfr_set_zero. | 
 
 
 
 
 | 251 | - New function mpfr_digamma. | 
 
 
 
 
 | 252 | - New function mpfr_ai (incomplete, experimental). | 
 
 
 
 
 | 253 | - New functions mpfr_set_flt and mpfr_get_flt to convert from/to the | 
 
 
 
 
 | 254 | float type. | 
 
 
 
 
 | 255 | - New function mpfr_urandom. | 
 
 
 
 
 | 256 | - New function mpfr_set_z_2exp (companion to mpfr_get_z_2exp, which | 
 
 
 
 
 | 257 | was renamed from mpfr_get_z_exp in previous versions). | 
 
 
 
 
 | 258 | - New function mpfr_min_prec. | 
 
 
 
 
 | 259 | - Speed improvement for large precisions in the trigonometric functions | 
 
 
 
 
 | 260 | (mpfr_sin, mpfr_cos, mpfr_tan, mpfr_sin_cos): speedup of about 2.5 | 
 
 
 
 
 | 261 | for 10^5 digits, of about 5 for 10^6 digits. | 
 
 
 
 
 | 262 | - Speed improvement for large precisions of the inverse trigonometric | 
 
 
 
 
 | 263 | functions (arcsin, arccos, arctan): about 2 for 10^3 digits, up to | 
 
 
 
 
 | 264 | 2.7 for 10^6 digits. | 
 
 
 
 
 | 265 | - Some documentation files are installed in $docdir. | 
 
 
 
 
 | 266 | - The detection of a GMP build directory (more precisely, the internal | 
 
 
 
 
 | 267 | header files of GMP) was previously done separately from the use of | 
 
 
 
 
 | 268 | the --with-gmp-build configure option. This was not consistent with | 
 
 
 
 
 | 269 | the documentation and with other parts of the configure script. So, | 
 
 
 
 
 | 270 | as of MPFR 3.0.0, the internal header files of GMP are now used if | 
 
 
 
 
 | 271 | and only if the --with-gmp-build configure option is given. | 
 
 
 
 
 | 272 | - The configure script recognizes some extra "long double" formats | 
 
 
 
 
 | 273 | (double big endian, double little endian, double-double big endian). | 
 
 
 
 
 | 274 | - MPFR manual: added "API Compatibility" section. | 
 
 
 
 
 | 275 | - Test coverage: 97.1% lines of code. | 
 
 
 
 
 | 276 | - Bug fixes. | 
 
 
 
 
 | 277 |  | 
 
 
 
 
 | 278 | Changes from versions 2.3.* to version 2.4.0: | 
 
 
 
 
 | 279 | - The "andouillette sauce moutarde" release. | 
 
 
 
 
 | 280 | - MPFR is now a GNU package. | 
 
 
 
 
 | 281 | - Changes in the behavior of mpfr_strtofr and in its documentation | 
 
 
 
 
 | 282 | concerning particular cases where the code and the documentation | 
 
 
 
 
 | 283 | did not match; this change is also present in MPFR 2.3.1. | 
 
 
 
 
 | 284 | - Behavior of mpfr_check_range changed: if the value is an inexact | 
 
 
 
 
 | 285 | infinity, the overflow flag is set (in case it was lost); this | 
 
 
 
 
 | 286 | change is also present in MPFR 2.3.2. | 
 
 
 
 
 | 287 | - Function mpfr_init_gmp_rand (only defined when building MPFR without | 
 
 
 
 
 | 288 | the --with-gmp-build configure option) is no longer defined at all. | 
 
 
 
 
 | 289 | This function was private and not documented, and was used only in | 
 
 
 
 
 | 290 | the MPFR test suite. User code that calls it is regarded as broken | 
 
 
 
 
 | 291 | and may fail as a consequence. Running the old test suite against | 
 
 
 
 
 | 292 | MPFR 2.4.0 may also fail. | 
 
 
 
 
 | 293 | - New functions: | 
 
 
 
 
 | 294 | * between a MPFR number and a double: mpfr_add_d, mpfr_sub_d, | 
 
 
 
 
 | 295 | mpfr_d_sub, mpfr_mul_d, mpfr_div_d, mpfr_d_div, | 
 
 
 
 
 | 296 | * formatted input/output: | 
 
 
 
 
 | 297 | mpfr_printf, mpfr_fprintf, mpfr_vprintf, mpfr_vfprintf, | 
 
 
 
 
 | 298 | mpfr_sprintf, mpfr_snprintf, mpfr_vsprintf, mpfr_vsnprintf, | 
 
 
 
 
 | 299 | mpfr_asprintf, mpfr_vasprintf. | 
 
 
 
 
 | 300 | * mpfr_sinh_cosh, mpfr_li2, mpfr_modf, mpfr_fmod, mpfr_rec_sqrt. | 
 
 
 
 
 | 301 | - Configure test for TLS support. | 
 
 
 
 
 | 302 | - Get default $CC and $CFLAGS from gmp.h (__GMP_CC / __GMP_CFLAGS, | 
 
 
 
 
 | 303 | which are available as of GMP 4.2.3). | 
 
 
 
 
 | 304 | - Documented the fact that mpfr_random and mpfr_random2 will be | 
 
 
 
 
 | 305 | suppressed in the next release, and that the specification of | 
 
 
 
 
 | 306 | mpfr_eq may change in the next release (for compatibility with | 
 
 
 
 
 | 307 | the mpf layer of GMP). | 
 
 
 
 
 | 308 | - Test coverage: 96.7% lines of code. | 
 
 
 
 
 | 309 | - Bug fixes. | 
 
 
 
 
 | 310 |  | 
 
 
 
 
 | 311 | Changes from versions 2.2.* to version 2.3.0: | 
 
 
 
 
 | 312 | - The mpfr.info file is now installed in the share subdirectory | 
 
 
 
 
 | 313 | (as required by the Filesystem Hierarchy Standard); see output | 
 
 
 
 
 | 314 | of "./configure --help". | 
 
 
 
 
 | 315 | - The shared library is now enabled by default. If the MPFR build | 
 
 
 
 
 | 316 | fails on your platform, try the --disable-shared configure option | 
 
 
 
 
 | 317 | to disable the shared library. | 
 
 
 
 
 | 318 | - Thread-safe support with Microsoft Visual compiler. | 
 
 
 
 
 | 319 | - New functions mpfr_j0, mpfr_j1, mpfr_jn, mpfr_y0, mpfr_y1, mpfr_yn, | 
 
 
 
 
 | 320 | mpfr_lgamma, mpfr_remainder, mpfr_remquo, mpfr_fms, mpfr_signbit, | 
 
 
 
 
 | 321 | mpfr_setsign, mpfr_copysign, mpfr_get_patches. | 
 
 
 
 
 | 322 | - Functions mpfr_sin, mpfr_cos and mpfr_sin_cos improved (argument | 
 
 
 
 
 | 323 | reduction). | 
 
 
 
 
 | 324 | - More detailed MPFR manual. | 
 
 
 
 
 | 325 | - Improved tests (make check). | 
 
 
 
 
 | 326 | - Bug fixes. | 
 
 
 
 
 | 327 |  | 
 
 
 
 
 | 328 | Changes from versions 2.1.* to version 2.2.0: | 
 
 
 
 
 | 329 | - Bug fixes. | 
 
 
 
 
 | 330 | - new functions mpfr_set_overflow, mpfr_set_underflow, mpfr_set_inexflag, | 
 
 
 
 
 | 331 | mpfr_set_erangeflag, mpfr_set_nanflag, mpfr_erfc, mpfr_atan2, mpfr_pow_z, | 
 
 
 
 
 | 332 | mpfr_subnormalize, mpfr_const_catalan, mpfr_sec, mpfr_csc, mpfr_cot, | 
 
 
 
 
 | 333 | mpfr_root, mpfr_eint, mpfr_get_f, mpfr_sech, mpfr_csch, mpfr_coth, | 
 
 
 
 
 | 334 | mpfr_lngamma. | 
 
 
 
 
 | 335 | - new macro: MPFR_VERSION_STRING | 
 
 
 
 
 | 336 | - Remove the exported MPFR variables from mpfr.h to mpfr-impl.h. | 
 
 
 
 
 | 337 | (They were undocumented, so programs which respect the API still work). | 
 
 
 
 
 | 338 | - Grep CC and CFLAGS from GMP Makefile if possible. | 
 
 
 
 
 | 339 | - Math functions are faster (both average and worst cases). | 
 
 
 
 
 | 340 | - Better support for long double. | 
 
 
 
 
 | 341 | - Shared library of MPFR. | 
 
 
 
 
 | 342 | - Binary compatible with previous versions if you do not use undocumented | 
 
 
 
 
 | 343 | features. | 
 
 
 
 
 | 344 | - Thread safe (if built with --enable-thread-safe). | 
 
 
 
 
 | 345 | - Logging facility. | 
 
 
 
 
 | 346 | - Change in the semantics of mpfr_out_str/mpfr_get_str when n_digits=0. | 
 
 
 
 
 | 347 | - Better locale support. | 
 
 
 
 
 | 348 |  | 
 
 
 
 
 | 349 | Changes from version 2.1.0 to version 2.1.1: | 
 
 
 
 
 | 350 | - Better way to detect the GMP library. | 
 
 
 
 
 | 351 | - Bug fixes. | 
 
 
 
 
 | 352 |  | 
 
 
 
 
 | 353 | Changes from version 2.0.3 to version 2.1.0: | 
 
 
 
 
 | 354 | - Bug fixes. | 
 
 
 
 
 | 355 | - new functions mpfr_strtofr, mpfr_set_uj, mpfr_set_sj, mpfr_set_ui_2exp, | 
 
 
 
 
 | 356 | mpfr_set_si_2exp, mpfr_set_sj_2exp, mpfr_set_uj_2exp, mpfr_get_uj, | 
 
 
 
 
 | 357 | mpfr_get_sj, mpfr_get_z, mpfr_free_str, mpfr_si_sub, mpfr_sub_si, | 
 
 
 
 
 | 358 | mpfr_mul_si, mpfr_si_div, mpfr_div_si, mpfr_sqr, mpfr_cmp_z, mpfr_cmp_q, | 
 
 
 
 
 | 359 | mpfr_zero_p, mpfr_free_cache, mpfr_sum, mpfr_get_version, | 
 
 
 
 
 | 360 | mpfr_get_default_rounding_mode, mpfr_get_emin_min, mpfr_get_emin_max, | 
 
 
 
 
 | 361 | mpfr_get_emax_min, mpfr_get_emax_max, mpfr_inits, mpfr_inits2, mpfr_clears, | 
 
 
 
 
 | 362 | mpfr_fits_intmax_p, mpfr_fits_uintmax_p, mpfr_clear_erangeflag, | 
 
 
 
 
 | 363 | mpfr_erangeflag_p, mpfr_rint_round, mpfr_rint_trunc, mpfr_rint_ceil, | 
 
 
 
 
 | 364 | mpfr_rint_floor. | 
 
 
 
 
 | 365 | - new macros MPFR_DECL_INIT, MPFR_VERSION, MPFR_VERSION_NUM, | 
 
 
 
 
 | 366 | MPFR_VERSION_MAJOR, MPFR_VERSION_MINOR, MPFR_VERSION_PATCHLEVEL. | 
 
 
 
 
 | 367 | - improved documentation. | 
 
 
 
 
 | 368 | - improved configure. | 
 
 
 
 
 | 369 | - improved portability (library and test suite). | 
 
 
 
 
 | 370 | - It handles correctly non IEEE-754 double. | 
 
 
 
 
 | 371 | - GMP internal files are not needed to install MPFR. | 
 
 
 
 
 | 372 | - It is faster with low-precision floating point. | 
 
 
 
 
 | 373 | - New global flag: ERANGE_FLAG. | 
 
 
 
 
 | 374 | - Binary incompatible with previous versions, but API compatible. | 
 
 
 
 
 | 375 | - mpfr_set_str doesn't allow anymore "@NAN@garbagechar" and "@INF@garbagechar", | 
 
 
 
 
 | 376 | allows base 0 (detection of the base), prefix (0x, 0b), leading whitespace. | 
 
 
 
 
 | 377 |  | 
 
 
 
 
 | 378 | Changes from version 2.0.2 to version 2.0.3: | 
 
 
 
 
 | 379 | - Bug fixes. | 
 
 
 
 
 | 380 | - Support GMP as a shared library (not fully tested). | 
 
 
 
 
 | 381 |  | 
 
 
 
 
 | 382 | Changes from version 2.0.1 to version 2.0.2: | 
 
 
 
 
 | 383 | - many bug fixes and other improvements. | 
 
 
 
 
 | 384 | - new functions mpfr_prec_round (replaces mpfr_round_prec), mpfr_get_exp, | 
 
 
 
 
 | 385 | mpfr_set_exp, mpfr_get_ld, mpfr_set_ld, mpfr_get_d_2exp, mpfr_get_si, | 
 
 
 
 
 | 386 | mpfr_get_ui, mpfr_nextabove, mpfr_nextbelow, mpfr_nexttoward, mpfr_frac, | 
 
 
 
 
 | 387 | mpfr_fits_*, mpfr_cmp_d, mpfr_cmpabs, mpfr_erf, mpfr_gamma, mpfr_zeta, | 
 
 
 
 
 | 388 | mpfr_greater_p, mpfr_greaterequal_p, mpfr_less_p, mpfr_lessequal_p, | 
 
 
 
 
 | 389 | mpfr_lessgreater_p, mpfr_equal_p, mpfr_unordered_p. | 
 
 
 
 
 | 390 | - removed functions: mpfr_print_binary, mpfr_round_prec (replaced by | 
 
 
 
 
 | 391 | mpfr_prec_round), mpfr_set_str_raw, mpfr_set_machine_rnd_mode. | 
 
 
 
 
 | 392 | - function mpfr_isinteger renamed mpfr_integer_p. | 
 
 
 
 
 | 393 | - return type of some functions changed from void to int, for consistency. | 
 
 
 
 
 | 394 | - return type of mpfr_set_prec changed from int to void. | 
 
 
 
 
 | 395 | - new values for exponent range. | 
 
 
 
 
 | 396 | - rename internal variables. | 
 
 
 
 
 | 397 |  | 
 
 
 
 
 | 398 | Changes from version 2001 to version 2.0.1: | 
 
 
 
 
 | 399 | - new mathematical functions: acos, acosh, asin, asinh, atan, atanh, cosh, | 
 
 
 
 
 | 400 | base-2 exponential and logarithm, base-10 logarithm, expm1, factorial, | 
 
 
 
 
 | 401 | pow, pow_si, pow_ui, sinh, tan, tanh, ui_pow, ui_pow_ui | 
 
 
 
 
 | 402 | - other new functions: mpfr_const_euler, mpfr_dim, mpfr_fma, mpfr_hypot, | 
 
 
 
 
 | 403 | mpfr_min, mpfr_max, mpfr_rint, mpfr_set_inf, mpfr_set_nan | 
 
 
 
 
 | 404 | - new operations with MPZ or MPQ: mpfr_{add,sub,mul,div}_[zq] | 
 
 
 
 
 | 405 | - new predicates: mpfr_inf_p, mpfr_nan_p, mpfr_number_p, mpfr_isinteger, | 
 
 
 
 
 | 406 | - add mechanism to set/check exponent range (overflow, underflow), partially | 
 
 
 
 
 | 407 | implemented in the mpfr functions. | 
 
 
 
 
 | 408 | - efficiency: mpfr_div is now faster when the divisor has a few limbs | 
 
 
 
 
 | 409 | - rounding: now mpfr_pow implements exact rounding, and most functions return a | 
 
 
 
 
 | 410 | ternary value indicating the position of the returned value wrt the exact one | 
 
 
 
 
 | 411 | (thus the return value is now 'int' instead of 'void') | 
 
 
 
 
 | 412 | - complete rewrite of the configuration files | 
 
 
 
 
 | 413 | - mpfr_get_d, mpfr_{add,sub}_one_ulp now get a rounding mode as 2nd argument | 
 
 
 
 
 | 414 | - some function names did change: mpz_set_fr is now mpfr_get_z_exp, | 
 
 
 
 
 | 415 | mpfr_print_raw is now mpfr_print_binary. | 
 
 
 
 
 | 416 |  | 
 
 
 
 
 | 417 | Changes from version 1.0 to version 2001: | 
 
 
 
 
 | 418 | - the default installation does not provide any more access to machine | 
 
 
 
 
 | 419 | rounding mode, and as a consequence does not compare MPFR results with | 
 
 
 
 
 | 420 | precision=53 to machine results. Add option -DTEST if you want to have | 
 
 
 
 
 | 421 | access to machine rounding mode, and to check MPFR results against. | 
 
 
 
 
 | 422 | - the MPFR files do not need <math.h> any more | 
 
 
 
 
 | 423 | - the header file <mpfr.h> was split into <mpfr.h> for exported functions | 
 
 
 
 
 | 424 | and <mpfr-impl.h> for internal functions. The user should not use functions | 
 
 
 
 
 | 425 | or macros from <mpfr-impl.h>, since those may change in further releases. | 
 
 
 
 
 | 426 | - <mpfr.h> was modified in order to make easy a C++ interface | 
 
 
 
 
 | 427 | - MPFR now deals with infinities (+infinity and -infinity) and NaN | 
 
 
 
 
 | 428 | - the missing function mpfr_swap is now available | 
 
 
 
 
 | 429 | - mpfr_zeta was removed (was incomplete) | 
 
 
 
 
 | 430 | - mpfr_init and mpfr_init2 now initialize the corresponding variable to 0 | 
 
 
 
 
 | 431 | (like in other initialization functions from GNU MP) | 
 
 
 
 
 | 432 | - in case memory allocation fails, an error message is output | 
 
 
 
 
 | 433 | - several bugs of version 1.0 were fixed | 
 
 
 
 
 | 434 |  | 
 
 
 
 
 | 435 | Changes from version 0.4 to version 1.0: | 
 
 
 
 
 | 436 |  | 
 
 
 
 
 | 437 | - Version 1.0 now uses a standard configure/make installation. | 
 
 
 
 
 | 438 | - Version 1.0 implements all functions that are available in the MPF class | 
 
 
 
 
 | 439 | from GMP 3.1 (except mpf_swap) and a header file mpf2mpfr.h is included in | 
 
 
 
 
 | 440 | the distribution for easy change from MPF to MPFR. | 
 
 
 
 
 | 441 | - Version 1.0 implements new elementary functions: mpfr_sincos | 
 
 
 
 
 | 442 | - Some functions and macros have been renamed: mpfr_log2 is now | 
 
 
 
 
 | 443 | mpfr_const_log2, mpfr_pi is now mpfr_const_pi, SIGN is now MPFR_SIGN. | 
 
 
 
 
 | 444 | - Version 1.0 uses faster algorithms for mpfr_exp, mpfr_const_pi, | 
 
 
 
 
 | 445 | mpfr_const_log2. Compare the timings from version 1.0 and version 0.4. | 
 
 
 
 
 | 446 | - Version 1.0 corrects some bugs of version 0.4. | 
 
 
 
 
 | 447 | - The precision of MPFR variables is now named mpfr_prec, which makes it | 
 
 
 
 
 | 448 | easier to change it, to say unsigned long long. Same for the rounding mode | 
 
 
 
 
 | 449 | which is called mp_rnd_t. | 
 
 
 
 
 | 450 |  | 
 
 
 
 
 | 451 | You'll find other news concerning the GNU MPFR library on the web | 
 
 
 
 
 | 452 | page <https://www.mpfr.org/>. |