[Bug fortran/47295] New: libquadmath: List __complex128 and constants in the .texi file

[Bug fortran/47295] New: libquadmath: List __complex128 and constants in the .texi file

[burnus at gcc dot gnu.org]

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=47295

           Summary: libquadmath: List __complex128 and constants in the
                    .texi file
           Product: gcc
           Version: 4.6.0
            Status: UNCONFIRMED
          Keywords: documentation
          Severity: normal
          Priority: P3
         Component: fortran
        AssignedTo: unassigned@gcc.gnu.org
        ReportedBy: burnus@gcc.gnu.org


libquadmath.h contains a typedef and several macros (constants), which should
be listed in the documentation.

typedef _Complex float __attribute__((mode(TC))) __complex128;

// Macros
#define FLT128_MAX 1.18973149535723176508575932662800702e4932Q
#define FLT128_MIN 3.36210314311209350626267781732175260e-4932Q
#define FLT128_EPSILON 1.92592994438723585305597794258492732e-34Q
#define FLT128_DENORM_MIN 6.475175119438025110924438958227646552e-4966Q
#define FLT128_MANT_DIG 113
#define FLT128_MIN_EXP (-16381)
#define FLT128_MAX_EXP 16384
// TODO -- One day, we need to add the following macros:
// FLT128_DIG, FLT128_MIN_10_EXP, FLT128_MAX_10_EXP

#define HUGE_VALQ __builtin_huge_valq()


The math constants are added via
http://gcc.gnu.org/ml/gcc-patches/2011-01/msg00332.html

+#define M_Eq        2.7182818284590452353602874713526625Q  /* e */
+#define M_LOG2Eq    1.4426950408889634073599246810018921Q  /* log_2 e */
+#define M_LOG10Eq   0.4342944819032518276511289189166051Q  /* log_10 e */
+#define M_LN2q      0.6931471805599453094172321214581766Q  /* log_e 2 */
+#define M_LN10q     2.3025850929940456840179914546843642Q  /* log_e 10 */
+#define M_PIq       3.1415926535897932384626433832795029Q  /* pi */
+#define M_PI_2q     1.5707963267948966192313216916397514Q  /* pi/2 */
+#define M_PI_4q     0.7853981633974483096156608458198757Q  /* pi/4 */
+#define M_1_PIq     0.3183098861837906715377675267450287Q  /* 1/pi */
+#define M_2_PIq     0.6366197723675813430755350534900574Q  /* 2/pi */
+#define M_2_SQRTPIq 1.1283791670955125738961589031215452Q  /* 2/sqrt(pi) */
+#define M_SQRT2q    1.4142135623730950488016887242096981Q  /* sqrt(2) */
+#define M_SQRT1_2q  0.7071067811865475244008443621048490Q  /* 1/sqrt(2) */

[Bug fortran/47295] libquadmath: List __complex128 and constants in the .texi file

[kargl at gcc dot gnu.org]

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=47295

kargl at gcc dot gnu.org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |kargl at gcc dot gnu.org

--- Comment #1 from kargl at gcc dot gnu.org 2011-01-15 06:39:25 UTC ---
I don't understand the intent of this PR.  We
do not list the analogous constants for float, double,
and long double anywhere in the Fortran manual.
Why single out libquad constants?

[Bug fortran/47295] libquadmath: List __complex128 and constants in the .texi file

[burnus at gcc dot gnu.org]

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=47295

--- Comment #2 from Tobias Burnus <burnus at gcc dot gnu.org> 2011-01-15 17:55:35 UTC ---
(In reply to comment #1)
> We do not list the analogous constants for float, double,
> and long double anywhere in the Fortran manual.

Note: The PR is about libquadmath and libquadmath.texi and not about the GNU
Fortran manual.
Cf. http://gcc.gnu.org/onlinedocs/libquadmath/

 * * *

Patch: http://gcc.gnu.org/ml/gcc-patches/2011-01/msg01059.html

[Bug fortran/47295] libquadmath: List __complex128 and constants in the .texi file

[sgk at troutmask dot apl.washington.edu]

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=47295

--- Comment #3 from Steve Kargl <sgk at troutmask dot apl.washington.edu> 2011-01-15 21:56:40 UTC ---
On Sat, Jan 15, 2011 at 05:55:36PM +0000, burnus at gcc dot gnu.org wrote:
> http://gcc.gnu.org/bugzilla/show_bug.cgi?id=47295
> 
> --- Comment #2 from Tobias Burnus <burnus at gcc dot gnu.org> 2011-01-15 17:55:35 UTC ---
> (In reply to comment #1)
> > We do not list the analogous constants for float, double,
> > and long double anywhere in the Fortran manual.
> 
> Note: The PR is about libquadmath and libquadmath.texi and not about the GNU
> Fortran manual.

See the Subject line.  Specific this part --> [Bug fortran/47295].
If there isn't a libquad tag, then use Other as in [Bug Other/47295].

[Bug fortran/47295] libquadmath: List __complex128 and constants in the .texi file

[burnus at gcc dot gnu.org]

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=47295

--- Comment #4 from Tobias Burnus <burnus at gcc dot gnu.org> 2011-01-17 19:03:31 UTC ---
Author: burnus
Date: Mon Jan 17 19:03:28 2011
New Revision: 168930

URL: http://gcc.gnu.org/viewcvs?root=gcc&view=rev&rev=168930
Log:
2011-01-17  Tobias Burnus  <burnus@net-b.de>

        PR fortran/47295
        * libquadmath.text: Document typedef and constants.


Modified:
    trunk/libquadmath/ChangeLog
    trunk/libquadmath/libquadmath.texi

[Bug fortran/47295] libquadmath: List __complex128 and constants in the .texi file

[burnus at gcc dot gnu.org]

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=47295

Tobias Burnus <burnus at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|UNCONFIRMED                 |RESOLVED
         Resolution|                            |FIXED

--- Comment #5 from Tobias Burnus <burnus at gcc dot gnu.org> 2011-01-17 19:06:59 UTC ---
FIXED.