| 1 | Copyright 1999, 2001-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 | Known bugs:
 | 
|---|
| 24 | 
 | 
|---|
| 25 | * The overflow/underflow exceptions may be badly handled in some functions;
 | 
|---|
| 26 |   specially when the intermediary internal results have exponent which
 | 
|---|
| 27 |   exceeds the hardware limit (2^30 for a 32 bits CPU, and 2^62 for a 64 bits
 | 
|---|
| 28 |   CPU) or the exact result is close to an overflow/underflow threshold.
 | 
|---|
| 29 | 
 | 
|---|
| 30 | * Under Linux/x86 with the traditional FPU, some functions do not work
 | 
|---|
| 31 |   if the FPU rounding precision has been changed to single (this is a
 | 
|---|
| 32 |   bad practice and should be useless, but one never knows what other
 | 
|---|
| 33 |   software will do).
 | 
|---|
| 34 | 
 | 
|---|
| 35 | * Some functions do not use MPFR_SAVE_EXPO_* macros, thus do not behave
 | 
|---|
| 36 |   correctly in a reduced exponent range.
 | 
|---|
| 37 | 
 | 
|---|
| 38 | * Function hypot gives incorrect result when on the one hand the difference
 | 
|---|
| 39 |   between parameters' exponents is near 2*MPFR_EMAX_MAX and on the other hand
 | 
|---|
| 40 |   the output precision or the precision of the parameter with greatest
 | 
|---|
| 41 |   absolute value is greater than 2*MPFR_EMAX_MAX-4.
 | 
|---|
| 42 | 
 | 
|---|
| 43 | Potential bugs:
 | 
|---|
| 44 | 
 | 
|---|
| 45 | * Possible incorrect results due to internal underflow, which can lead to
 | 
|---|
| 46 |   a huge loss of accuracy while the error analysis doesn't take that into
 | 
|---|
| 47 |   account. If the underflow occurs at the last function call (just before
 | 
|---|
| 48 |   the MPFR_CAN_ROUND), the result should be correct (or MPFR gets into an
 | 
|---|
| 49 |   infinite loop). TODO: check the code and the error analysis.
 | 
|---|
| 50 | 
 | 
|---|
| 51 | * Possible bugs with huge precisions (> 2^30) and a 32-bit ABI, in particular
 | 
|---|
| 52 |   undetected integer overflows. TODO: use the MPFR_ADD_PREC macro.
 | 
|---|
| 53 | 
 | 
|---|
| 54 | * Possible bugs if the chosen exponent range does not allow to represent
 | 
|---|
| 55 |   the range [1/16, 16].
 | 
|---|
| 56 | 
 | 
|---|
| 57 | * Possible infinite loop in some functions for particular cases: when
 | 
|---|
| 58 |   the exact result is an exactly representable number or the middle of
 | 
|---|
| 59 |   consecutive two such numbers. However for non-algebraic functions, it is
 | 
|---|
| 60 |   believed that no such case exists, except the well-known cases like cos(0)=1,
 | 
|---|
| 61 |   exp(0)=1, and so on, and the x^y function when y is an integer or y=1/2^k.
 | 
|---|
| 62 | 
 | 
|---|
| 63 | * The mpfr_set_ld function may be quite slow if the long double type has an
 | 
|---|
| 64 |   exponent of more than 15 bits.
 | 
|---|
| 65 | 
 | 
|---|
| 66 | * mpfr_set_d may give wrong results on some non-IEEE architectures.
 | 
|---|
| 67 | 
 | 
|---|
| 68 | * Error analysis for some functions may be incorrect (out-of-date due
 | 
|---|
| 69 |   to modifications in the code?).
 | 
|---|
| 70 | 
 | 
|---|
| 71 | * Possible use of non-portable feature (pre-C99) of the integer division
 | 
|---|
| 72 |   with negative result.
 | 
|---|