| 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. |