Home | History | Annotate | Line # | Download | only in libquadmath
      1 This is libquadmath.info, produced by makeinfo version 6.5 from
      2 libquadmath.texi.
      3 
      4 Copyright (C) 2010-2024 Free Software Foundation, Inc.
      5 
      6      Permission is granted to copy, distribute and/or modify this
      7      document under the terms of the GNU Free Documentation License,
      8      Version 1.2 or any later version published by the Free Software
      9      Foundation; with no Invariant Sections, with the Front-Cover Texts
     10      being "A GNU Manual," and with the Back-Cover Texts as in (a)
     11      below.  A copy of the license is included in the section entitled
     12      "GNU Free Documentation License."
     13 
     14      (a) The FSF's Back-Cover Text is: "You have the freedom to copy and
     15      modify this GNU manual.
     16 INFO-DIR-SECTION GNU Libraries
     17 START-INFO-DIR-ENTRY
     18 * libquadmath: (libquadmath).                  GCC Quad-Precision Math Library
     19 END-INFO-DIR-ENTRY
     20 
     21    This manual documents the GCC Quad-Precision Math Library API.
     22 
     23    Published by the Free Software Foundation 51 Franklin Street, Fifth
     24 Floor Boston, MA 02110-1301 USA
     25 
     26    Copyright (C) 2010-2024 Free Software Foundation, Inc.
     27 
     28      Permission is granted to copy, distribute and/or modify this
     29      document under the terms of the GNU Free Documentation License,
     30      Version 1.2 or any later version published by the Free Software
     31      Foundation; with no Invariant Sections, with the Front-Cover Texts
     32      being "A GNU Manual," and with the Back-Cover Texts as in (a)
     33      below.  A copy of the license is included in the section entitled
     34      "GNU Free Documentation License."
     35 
     36      (a) The FSF's Back-Cover Text is: "You have the freedom to copy and
     37      modify this GNU manual.
     38 
     39 
     40 File: libquadmath.info,  Node: Top,  Next: Typedef and constants,  Up: (dir)
     41 
     42 Introduction
     43 ************
     44 
     45 This manual documents the usage of libquadmath, the GCC Quad-Precision
     46 Math Library Application Programming Interface (API).
     47 
     48 * Menu:
     49 
     50 * Typedef and constants::      Defined data types and constants
     51 * Math Library Routines::      The Libquadmath math runtime application
     52                                programming interface.
     53 * I/O Library Routines::       The Libquadmath I/O runtime application
     54                                programming interface.
     55 * GNU Free Documentation License::
     56                                How you can copy and share this manual.
     57 * Reporting Bugs::             How to report bugs in GCC Libquadmath.
     58 
     59 
     60 File: libquadmath.info,  Node: Typedef and constants,  Next: Math Library Routines,  Prev: Top,  Up: Top
     61 
     62 1 Typedef and constants
     63 ***********************
     64 
     65 The following data type has been defined via 'typedef'.
     66 
     67 '__complex128': '__float128'-based complex number
     68 
     69    The following macros are defined, which give the numeric limits of
     70 the '__float128' data type.
     71 
     72 'FLT128_MAX': largest finite number
     73 'FLT128_MIN': smallest positive number with full precision
     74 'FLT128_EPSILON': difference between 1 and the next larger
     75      representable number
     76 'FLT128_DENORM_MIN': smallest positive denormalized number
     77 'FLT128_MANT_DIG': number of digits in the mantissa (bit precision)
     78 'FLT128_MIN_EXP': maximal negative exponent
     79 'FLT128_MAX_EXP': maximal positive exponent
     80 'FLT128_DIG': number of decimal digits in the mantissa
     81 'FLT128_MIN_10_EXP': maximal negative decimal exponent
     82 'FLT128_MAX_10_EXP': maximal positive decimal exponent
     83 
     84    The following mathematical constants of type '__float128' are
     85 defined.
     86 
     87 'M_Eq': the constant e (Euler's number)
     88 'M_LOG2Eq': binary logarithm of 2
     89 'M_LOG10Eq': common, decimal logarithm of 2
     90 'M_LN2q': natural logarithm of 2
     91 'M_LN10q': natural logarithm of 10
     92 'M_PIq': pi
     93 'M_PI_2q': pi divided by two
     94 'M_PI_4q': pi divided by four
     95 'M_1_PIq': one over pi
     96 'M_2_PIq': one over two pi
     97 'M_2_SQRTPIq': two over square root of pi
     98 'M_SQRT2q': square root of 2
     99 'M_SQRT1_2q': one over square root of 2
    100 
    101 
    102 File: libquadmath.info,  Node: Math Library Routines,  Next: I/O Library Routines,  Prev: Typedef and constants,  Up: Top
    103 
    104 2 Math Library Routines
    105 ***********************
    106 
    107 The following mathematical functions are available:
    108 
    109 'acosq': arc cosine function
    110 'acoshq': inverse hyperbolic cosine function
    111 'asinq': arc sine function
    112 'asinhq': inverse hyperbolic sine function
    113 'atanq': arc tangent function
    114 'atanhq': inverse hyperbolic tangent function
    115 'atan2q': arc tangent function
    116 'cbrtq': cube root function
    117 'ceilq': ceiling value function
    118 'copysignq': copy sign of a number
    119 'coshq': hyperbolic cosine function
    120 'cosq': cosine function
    121 'erfq': error function
    122 'erfcq': complementary error function
    123 'exp2q': base 2 exponential function
    124 'expq': exponential function
    125 'expm1q': exponential minus 1 function
    126 'fabsq': absolute value function
    127 'fdimq': positive difference function
    128 'finiteq': check finiteness of value
    129 'floorq': floor value function
    130 'fmaq': fused multiply and add
    131 'fmaxq': determine maximum of two values
    132 'fminq': determine minimum of two values
    133 'fmodq': remainder value function
    134 'frexpq': extract mantissa and exponent
    135 'hypotq': Eucledian distance function
    136 'ilogbq': get exponent of the value
    137 'isinfq': check for infinity
    138 'isnanq': check for not a number
    139 'issignalingq': check for signaling not a number
    140 'j0q': Bessel function of the first kind, first order
    141 'j1q': Bessel function of the first kind, second order
    142 'jnq': Bessel function of the first kind, N-th order
    143 'ldexpq': load exponent of the value
    144 'lgammaq': logarithmic gamma function
    145 'llrintq': round to nearest integer value
    146 'llroundq': round to nearest integer value away from zero
    147 'logbq': get exponent of the value
    148 'logq': natural logarithm function
    149 'log10q': base 10 logarithm function
    150 'log1pq': compute natural logarithm of the value plus one
    151 'log2q': base 2 logarithm function
    152 'lrintq': round to nearest integer value
    153 'lroundq': round to nearest integer value away from zero
    154 'modfq': decompose the floating-point number
    155 'nanq': return quiet NaN
    156 'nearbyintq': round to nearest integer
    157 'nextafterq': next representable floating-point number
    158 'powq': power function
    159 'remainderq': remainder function
    160 'remquoq': remainder and part of quotient
    161 'rintq': round-to-nearest integral value
    162 'roundq': round-to-nearest integral value, return '__float128'
    163 'scalblnq': compute exponent using 'FLT_RADIX'
    164 'scalbnq': compute exponent using 'FLT_RADIX'
    165 'signbitq': return sign bit
    166 'sincosq': calculate sine and cosine simultaneously
    167 'sinhq': hyperbolic sine function
    168 'sinq': sine function
    169 'sqrtq': square root function
    170 'tanq': tangent function
    171 'tanhq': hyperbolic tangent function
    172 'tgammaq': true gamma function
    173 'truncq': round to integer, towards zero
    174 'y0q': Bessel function of the second kind, first order
    175 'y1q': Bessel function of the second kind, second order
    176 'ynq': Bessel function of the second kind, N-th order
    177 'cabsq' complex absolute value function
    178 'cargq': calculate the argument
    179 'cimagq' imaginary part of complex number
    180 'crealq': real part of complex number
    181 'cacoshq': complex arc hyperbolic cosine function
    182 'cacosq': complex arc cosine function
    183 'casinhq': complex arc hyperbolic sine function
    184 'casinq': complex arc sine function
    185 'catanhq': complex arc hyperbolic tangent function
    186 'catanq': complex arc tangent function
    187 'ccosq' complex cosine function:
    188 'ccoshq': complex hyperbolic cosine function
    189 'cexpq': complex exponential function
    190 'cexpiq': computes the exponential function of "i" times a
    191      real value
    192 'clogq': complex natural logarithm
    193 'clog10q': complex base 10 logarithm
    194 'conjq': complex conjugate function
    195 'cpowq': complex power function
    196 'cprojq': project into Riemann Sphere
    197 'csinq': complex sine function
    198 'csinhq': complex hyperbolic sine function
    199 'csqrtq': complex square root
    200 'ctanq': complex tangent function
    201 'ctanhq': complex hyperbolic tangent function
    202 
    203 
    204 File: libquadmath.info,  Node: I/O Library Routines,  Next: GNU Free Documentation License,  Prev: Math Library Routines,  Up: Top
    205 
    206 3 I/O Library Routines
    207 **********************
    208 
    209 * Menu:
    210 
    211 * 'strtoflt128':          strtoflt128,          Convert from string
    212 * 'quadmath_snprintf':    quadmath_snprintf,    Convert to string
    213 
    214 
    215 File: libquadmath.info,  Node: strtoflt128,  Next: quadmath_snprintf,  Up: I/O Library Routines
    216 
    217 3.1 'strtoflt128' -- Convert from string
    218 ========================================
    219 
    220 The function 'strtoflt128' converts a string into a '__float128' number.
    221 
    222 Syntax
    223      '__float128 strtoflt128 (const char *s, char **sp)'
    224 
    225 _Arguments_:
    226      S           input string
    227      SP          the address of the next character in the string
    228 
    229      The argument SP contains, if not 'NULL', the address of the next
    230      character following the parts of the string, which have been read.
    231 
    232 Example
    233           #include <quadmath.h>
    234 
    235           int main ()
    236           {
    237             __float128 r;
    238 
    239             r = strtoflt128 ("1.2345678", NULL);
    240 
    241             return 0;
    242           }
    243 
    244 
    245 File: libquadmath.info,  Node: quadmath_snprintf,  Prev: strtoflt128,  Up: I/O Library Routines
    246 
    247 3.2 'quadmath_snprintf' -- Convert to string
    248 ============================================
    249 
    250 The function 'quadmath_snprintf' converts a '__float128' floating-point
    251 number into a string.  It is a specialized alternative to 'snprintf',
    252 where the format string is restricted to a single conversion specifier
    253 with 'Q' modifier and conversion specifier 'e', 'E', 'f', 'F', 'g', 'G',
    254 'a' or 'A', with no extra characters before or after the conversion
    255 specifier.  The '%m$' or '*m$' style must not be used in the format.
    256 
    257 Syntax
    258      'int quadmath_snprintf (char *s, size_t size, const char *format,
    259      ...)'
    260 
    261 _Arguments_:
    262      S           output string
    263      SIZE        byte size of the string, including trailing NUL
    264      FORMAT      conversion specifier string
    265 
    266 Note
    267      On some targets when supported by the C library hooks are installed
    268      for 'printf' family of functions, so that 'printf ("%Qe", 1.2Q);'
    269      etc. works too.
    270 
    271 Example
    272           #include <quadmath.h>
    273           #include <stdlib.h>
    274           #include <stdio.h>
    275 
    276           int main ()
    277           {
    278             __float128 r;
    279             int prec = 20;
    280             int width = 46;
    281             char buf[128];
    282 
    283             r = 2.0q;
    284             r = sqrtq (r);
    285             int n = quadmath_snprintf (buf, sizeof buf, "%+-#*.20Qe", width, r);
    286             if ((size_t) n < sizeof buf)
    287               printf ("%s\n", buf);
    288               /* Prints: +1.41421356237309504880e+00 */
    289             quadmath_snprintf (buf, sizeof buf, "%Qa", r);
    290             if ((size_t) n < sizeof buf)
    291               printf ("%s\n", buf);
    292               /* Prints: 0x1.6a09e667f3bcc908b2fb1366ea96p+0 */
    293             n = quadmath_snprintf (NULL, 0, "%+-#46.*Qe", prec, r);
    294             if (n > -1)
    295               {
    296                 char *str = malloc (n + 1);
    297                 if (str)
    298                   {
    299                     quadmath_snprintf (str, n + 1, "%+-#46.*Qe", prec, r);
    300                     printf ("%s\n", str);
    301                     /* Prints: +1.41421356237309504880e+00 */
    302                   }
    303                 free (str);
    304               }
    305             return 0;
    306           }
    307 
    308 
    309 File: libquadmath.info,  Node: GNU Free Documentation License,  Next: Reporting Bugs,  Prev: I/O Library Routines,  Up: Top
    310 
    311 GNU Free Documentation License
    312 ******************************
    313 
    314                      Version 1.3, 3 November 2008
    315 
    316      Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
    317      <https://www.fsf.org>
    318 
    319      Everyone is permitted to copy and distribute verbatim copies
    320      of this license document, but changing it is not allowed.
    321 
    322   0. PREAMBLE
    323 
    324      The purpose of this License is to make a manual, textbook, or other
    325      functional and useful document "free" in the sense of freedom: to
    326      assure everyone the effective freedom to copy and redistribute it,
    327      with or without modifying it, either commercially or
    328      noncommercially.  Secondarily, this License preserves for the
    329      author and publisher a way to get credit for their work, while not
    330      being considered responsible for modifications made by others.
    331 
    332      This License is a kind of "copyleft", which means that derivative
    333      works of the document must themselves be free in the same sense.
    334      It complements the GNU General Public License, which is a copyleft
    335      license designed for free software.
    336 
    337      We have designed this License in order to use it for manuals for
    338      free software, because free software needs free documentation: a
    339      free program should come with manuals providing the same freedoms
    340      that the software does.  But this License is not limited to
    341      software manuals; it can be used for any textual work, regardless
    342      of subject matter or whether it is published as a printed book.  We
    343      recommend this License principally for works whose purpose is
    344      instruction or reference.
    345 
    346   1. APPLICABILITY AND DEFINITIONS
    347 
    348      This License applies to any manual or other work, in any medium,
    349      that contains a notice placed by the copyright holder saying it can
    350      be distributed under the terms of this License.  Such a notice
    351      grants a world-wide, royalty-free license, unlimited in duration,
    352      to use that work under the conditions stated herein.  The
    353      "Document", below, refers to any such manual or work.  Any member
    354      of the public is a licensee, and is addressed as "you".  You accept
    355      the license if you copy, modify or distribute the work in a way
    356      requiring permission under copyright law.
    357 
    358      A "Modified Version" of the Document means any work containing the
    359      Document or a portion of it, either copied verbatim, or with
    360      modifications and/or translated into another language.
    361 
    362      A "Secondary Section" is a named appendix or a front-matter section
    363      of the Document that deals exclusively with the relationship of the
    364      publishers or authors of the Document to the Document's overall
    365      subject (or to related matters) and contains nothing that could
    366      fall directly within that overall subject.  (Thus, if the Document
    367      is in part a textbook of mathematics, a Secondary Section may not
    368      explain any mathematics.)  The relationship could be a matter of
    369      historical connection with the subject or with related matters, or
    370      of legal, commercial, philosophical, ethical or political position
    371      regarding them.
    372 
    373      The "Invariant Sections" are certain Secondary Sections whose
    374      titles are designated, as being those of Invariant Sections, in the
    375      notice that says that the Document is released under this License.
    376      If a section does not fit the above definition of Secondary then it
    377      is not allowed to be designated as Invariant.  The Document may
    378      contain zero Invariant Sections.  If the Document does not identify
    379      any Invariant Sections then there are none.
    380 
    381      The "Cover Texts" are certain short passages of text that are
    382      listed, as Front-Cover Texts or Back-Cover Texts, in the notice
    383      that says that the Document is released under this License.  A
    384      Front-Cover Text may be at most 5 words, and a Back-Cover Text may
    385      be at most 25 words.
    386 
    387      A "Transparent" copy of the Document means a machine-readable copy,
    388      represented in a format whose specification is available to the
    389      general public, that is suitable for revising the document
    390      straightforwardly with generic text editors or (for images composed
    391      of pixels) generic paint programs or (for drawings) some widely
    392      available drawing editor, and that is suitable for input to text
    393      formatters or for automatic translation to a variety of formats
    394      suitable for input to text formatters.  A copy made in an otherwise
    395      Transparent file format whose markup, or absence of markup, has
    396      been arranged to thwart or discourage subsequent modification by
    397      readers is not Transparent.  An image format is not Transparent if
    398      used for any substantial amount of text.  A copy that is not
    399      "Transparent" is called "Opaque".
    400 
    401      Examples of suitable formats for Transparent copies include plain
    402      ASCII without markup, Texinfo input format, LaTeX input format,
    403      SGML or XML using a publicly available DTD, and standard-conforming
    404      simple HTML, PostScript or PDF designed for human modification.
    405      Examples of transparent image formats include PNG, XCF and JPG.
    406      Opaque formats include proprietary formats that can be read and
    407      edited only by proprietary word processors, SGML or XML for which
    408      the DTD and/or processing tools are not generally available, and
    409      the machine-generated HTML, PostScript or PDF produced by some word
    410      processors for output purposes only.
    411 
    412      The "Title Page" means, for a printed book, the title page itself,
    413      plus such following pages as are needed to hold, legibly, the
    414      material this License requires to appear in the title page.  For
    415      works in formats which do not have any title page as such, "Title
    416      Page" means the text near the most prominent appearance of the
    417      work's title, preceding the beginning of the body of the text.
    418 
    419      The "publisher" means any person or entity that distributes copies
    420      of the Document to the public.
    421 
    422      A section "Entitled XYZ" means a named subunit of the Document
    423      whose title either is precisely XYZ or contains XYZ in parentheses
    424      following text that translates XYZ in another language.  (Here XYZ
    425      stands for a specific section name mentioned below, such as
    426      "Acknowledgements", "Dedications", "Endorsements", or "History".)
    427      To "Preserve the Title" of such a section when you modify the
    428      Document means that it remains a section "Entitled XYZ" according
    429      to this definition.
    430 
    431      The Document may include Warranty Disclaimers next to the notice
    432      which states that this License applies to the Document.  These
    433      Warranty Disclaimers are considered to be included by reference in
    434      this License, but only as regards disclaiming warranties: any other
    435      implication that these Warranty Disclaimers may have is void and
    436      has no effect on the meaning of this License.
    437 
    438   2. VERBATIM COPYING
    439 
    440      You may copy and distribute the Document in any medium, either
    441      commercially or noncommercially, provided that this License, the
    442      copyright notices, and the license notice saying this License
    443      applies to the Document are reproduced in all copies, and that you
    444      add no other conditions whatsoever to those of this License.  You
    445      may not use technical measures to obstruct or control the reading
    446      or further copying of the copies you make or distribute.  However,
    447      you may accept compensation in exchange for copies.  If you
    448      distribute a large enough number of copies you must also follow the
    449      conditions in section 3.
    450 
    451      You may also lend copies, under the same conditions stated above,
    452      and you may publicly display copies.
    453 
    454   3. COPYING IN QUANTITY
    455 
    456      If you publish printed copies (or copies in media that commonly
    457      have printed covers) of the Document, numbering more than 100, and
    458      the Document's license notice requires Cover Texts, you must
    459      enclose the copies in covers that carry, clearly and legibly, all
    460      these Cover Texts: Front-Cover Texts on the front cover, and
    461      Back-Cover Texts on the back cover.  Both covers must also clearly
    462      and legibly identify you as the publisher of these copies.  The
    463      front cover must present the full title with all words of the title
    464      equally prominent and visible.  You may add other material on the
    465      covers in addition.  Copying with changes limited to the covers, as
    466      long as they preserve the title of the Document and satisfy these
    467      conditions, can be treated as verbatim copying in other respects.
    468 
    469      If the required texts for either cover are too voluminous to fit
    470      legibly, you should put the first ones listed (as many as fit
    471      reasonably) on the actual cover, and continue the rest onto
    472      adjacent pages.
    473 
    474      If you publish or distribute Opaque copies of the Document
    475      numbering more than 100, you must either include a machine-readable
    476      Transparent copy along with each Opaque copy, or state in or with
    477      each Opaque copy a computer-network location from which the general
    478      network-using public has access to download using public-standard
    479      network protocols a complete Transparent copy of the Document, free
    480      of added material.  If you use the latter option, you must take
    481      reasonably prudent steps, when you begin distribution of Opaque
    482      copies in quantity, to ensure that this Transparent copy will
    483      remain thus accessible at the stated location until at least one
    484      year after the last time you distribute an Opaque copy (directly or
    485      through your agents or retailers) of that edition to the public.
    486 
    487      It is requested, but not required, that you contact the authors of
    488      the Document well before redistributing any large number of copies,
    489      to give them a chance to provide you with an updated version of the
    490      Document.
    491 
    492   4. MODIFICATIONS
    493 
    494      You may copy and distribute a Modified Version of the Document
    495      under the conditions of sections 2 and 3 above, provided that you
    496      release the Modified Version under precisely this License, with the
    497      Modified Version filling the role of the Document, thus licensing
    498      distribution and modification of the Modified Version to whoever
    499      possesses a copy of it.  In addition, you must do these things in
    500      the Modified Version:
    501 
    502        A. Use in the Title Page (and on the covers, if any) a title
    503           distinct from that of the Document, and from those of previous
    504           versions (which should, if there were any, be listed in the
    505           History section of the Document).  You may use the same title
    506           as a previous version if the original publisher of that
    507           version gives permission.
    508 
    509        B. List on the Title Page, as authors, one or more persons or
    510           entities responsible for authorship of the modifications in
    511           the Modified Version, together with at least five of the
    512           principal authors of the Document (all of its principal
    513           authors, if it has fewer than five), unless they release you
    514           from this requirement.
    515 
    516        C. State on the Title page the name of the publisher of the
    517           Modified Version, as the publisher.
    518 
    519        D. Preserve all the copyright notices of the Document.
    520 
    521        E. Add an appropriate copyright notice for your modifications
    522           adjacent to the other copyright notices.
    523 
    524        F. Include, immediately after the copyright notices, a license
    525           notice giving the public permission to use the Modified
    526           Version under the terms of this License, in the form shown in
    527           the Addendum below.
    528 
    529        G. Preserve in that license notice the full lists of Invariant
    530           Sections and required Cover Texts given in the Document's
    531           license notice.
    532 
    533        H. Include an unaltered copy of this License.
    534 
    535        I. Preserve the section Entitled "History", Preserve its Title,
    536           and add to it an item stating at least the title, year, new
    537           authors, and publisher of the Modified Version as given on the
    538           Title Page.  If there is no section Entitled "History" in the
    539           Document, create one stating the title, year, authors, and
    540           publisher of the Document as given on its Title Page, then add
    541           an item describing the Modified Version as stated in the
    542           previous sentence.
    543 
    544        J. Preserve the network location, if any, given in the Document
    545           for public access to a Transparent copy of the Document, and
    546           likewise the network locations given in the Document for
    547           previous versions it was based on.  These may be placed in the
    548           "History" section.  You may omit a network location for a work
    549           that was published at least four years before the Document
    550           itself, or if the original publisher of the version it refers
    551           to gives permission.
    552 
    553        K. For any section Entitled "Acknowledgements" or "Dedications",
    554           Preserve the Title of the section, and preserve in the section
    555           all the substance and tone of each of the contributor
    556           acknowledgements and/or dedications given therein.
    557 
    558        L. Preserve all the Invariant Sections of the Document, unaltered
    559           in their text and in their titles.  Section numbers or the
    560           equivalent are not considered part of the section titles.
    561 
    562        M. Delete any section Entitled "Endorsements".  Such a section
    563           may not be included in the Modified Version.
    564 
    565        N. Do not retitle any existing section to be Entitled
    566           "Endorsements" or to conflict in title with any Invariant
    567           Section.
    568 
    569        O. Preserve any Warranty Disclaimers.
    570 
    571      If the Modified Version includes new front-matter sections or
    572      appendices that qualify as Secondary Sections and contain no
    573      material copied from the Document, you may at your option designate
    574      some or all of these sections as invariant.  To do this, add their
    575      titles to the list of Invariant Sections in the Modified Version's
    576      license notice.  These titles must be distinct from any other
    577      section titles.
    578 
    579      You may add a section Entitled "Endorsements", provided it contains
    580      nothing but endorsements of your Modified Version by various
    581      parties--for example, statements of peer review or that the text
    582      has been approved by an organization as the authoritative
    583      definition of a standard.
    584 
    585      You may add a passage of up to five words as a Front-Cover Text,
    586      and a passage of up to 25 words as a Back-Cover Text, to the end of
    587      the list of Cover Texts in the Modified Version.  Only one passage
    588      of Front-Cover Text and one of Back-Cover Text may be added by (or
    589      through arrangements made by) any one entity.  If the Document
    590      already includes a cover text for the same cover, previously added
    591      by you or by arrangement made by the same entity you are acting on
    592      behalf of, you may not add another; but you may replace the old
    593      one, on explicit permission from the previous publisher that added
    594      the old one.
    595 
    596      The author(s) and publisher(s) of the Document do not by this
    597      License give permission to use their names for publicity for or to
    598      assert or imply endorsement of any Modified Version.
    599 
    600   5. COMBINING DOCUMENTS
    601 
    602      You may combine the Document with other documents released under
    603      this License, under the terms defined in section 4 above for
    604      modified versions, provided that you include in the combination all
    605      of the Invariant Sections of all of the original documents,
    606      unmodified, and list them all as Invariant Sections of your
    607      combined work in its license notice, and that you preserve all
    608      their Warranty Disclaimers.
    609 
    610      The combined work need only contain one copy of this License, and
    611      multiple identical Invariant Sections may be replaced with a single
    612      copy.  If there are multiple Invariant Sections with the same name
    613      but different contents, make the title of each such section unique
    614      by adding at the end of it, in parentheses, the name of the
    615      original author or publisher of that section if known, or else a
    616      unique number.  Make the same adjustment to the section titles in
    617      the list of Invariant Sections in the license notice of the
    618      combined work.
    619 
    620      In the combination, you must combine any sections Entitled
    621      "History" in the various original documents, forming one section
    622      Entitled "History"; likewise combine any sections Entitled
    623      "Acknowledgements", and any sections Entitled "Dedications".  You
    624      must delete all sections Entitled "Endorsements."
    625 
    626   6. COLLECTIONS OF DOCUMENTS
    627 
    628      You may make a collection consisting of the Document and other
    629      documents released under this License, and replace the individual
    630      copies of this License in the various documents with a single copy
    631      that is included in the collection, provided that you follow the
    632      rules of this License for verbatim copying of each of the documents
    633      in all other respects.
    634 
    635      You may extract a single document from such a collection, and
    636      distribute it individually under this License, provided you insert
    637      a copy of this License into the extracted document, and follow this
    638      License in all other respects regarding verbatim copying of that
    639      document.
    640 
    641   7. AGGREGATION WITH INDEPENDENT WORKS
    642 
    643      A compilation of the Document or its derivatives with other
    644      separate and independent documents or works, in or on a volume of a
    645      storage or distribution medium, is called an "aggregate" if the
    646      copyright resulting from the compilation is not used to limit the
    647      legal rights of the compilation's users beyond what the individual
    648      works permit.  When the Document is included in an aggregate, this
    649      License does not apply to the other works in the aggregate which
    650      are not themselves derivative works of the Document.
    651 
    652      If the Cover Text requirement of section 3 is applicable to these
    653      copies of the Document, then if the Document is less than one half
    654      of the entire aggregate, the Document's Cover Texts may be placed
    655      on covers that bracket the Document within the aggregate, or the
    656      electronic equivalent of covers if the Document is in electronic
    657      form.  Otherwise they must appear on printed covers that bracket
    658      the whole aggregate.
    659 
    660   8. TRANSLATION
    661 
    662      Translation is considered a kind of modification, so you may
    663      distribute translations of the Document under the terms of section
    664      4.  Replacing Invariant Sections with translations requires special
    665      permission from their copyright holders, but you may include
    666      translations of some or all Invariant Sections in addition to the
    667      original versions of these Invariant Sections.  You may include a
    668      translation of this License, and all the license notices in the
    669      Document, and any Warranty Disclaimers, provided that you also
    670      include the original English version of this License and the
    671      original versions of those notices and disclaimers.  In case of a
    672      disagreement between the translation and the original version of
    673      this License or a notice or disclaimer, the original version will
    674      prevail.
    675 
    676      If a section in the Document is Entitled "Acknowledgements",
    677      "Dedications", or "History", the requirement (section 4) to
    678      Preserve its Title (section 1) will typically require changing the
    679      actual title.
    680 
    681   9. TERMINATION
    682 
    683      You may not copy, modify, sublicense, or distribute the Document
    684      except as expressly provided under this License.  Any attempt
    685      otherwise to copy, modify, sublicense, or distribute it is void,
    686      and will automatically terminate your rights under this License.
    687 
    688      However, if you cease all violation of this License, then your
    689      license from a particular copyright holder is reinstated (a)
    690      provisionally, unless and until the copyright holder explicitly and
    691      finally terminates your license, and (b) permanently, if the
    692      copyright holder fails to notify you of the violation by some
    693      reasonable means prior to 60 days after the cessation.
    694 
    695      Moreover, your license from a particular copyright holder is
    696      reinstated permanently if the copyright holder notifies you of the
    697      violation by some reasonable means, this is the first time you have
    698      received notice of violation of this License (for any work) from
    699      that copyright holder, and you cure the violation prior to 30 days
    700      after your receipt of the notice.
    701 
    702      Termination of your rights under this section does not terminate
    703      the licenses of parties who have received copies or rights from you
    704      under this License.  If your rights have been terminated and not
    705      permanently reinstated, receipt of a copy of some or all of the
    706      same material does not give you any rights to use it.
    707 
    708   10. FUTURE REVISIONS OF THIS LICENSE
    709 
    710      The Free Software Foundation may publish new, revised versions of
    711      the GNU Free Documentation License from time to time.  Such new
    712      versions will be similar in spirit to the present version, but may
    713      differ in detail to address new problems or concerns.  See
    714      <https://www.gnu.org/copyleft/>.
    715 
    716      Each version of the License is given a distinguishing version
    717      number.  If the Document specifies that a particular numbered
    718      version of this License "or any later version" applies to it, you
    719      have the option of following the terms and conditions either of
    720      that specified version or of any later version that has been
    721      published (not as a draft) by the Free Software Foundation.  If the
    722      Document does not specify a version number of this License, you may
    723      choose any version ever published (not as a draft) by the Free
    724      Software Foundation.  If the Document specifies that a proxy can
    725      decide which future versions of this License can be used, that
    726      proxy's public statement of acceptance of a version permanently
    727      authorizes you to choose that version for the Document.
    728 
    729   11. RELICENSING
    730 
    731      "Massive Multiauthor Collaboration Site" (or "MMC Site") means any
    732      World Wide Web server that publishes copyrightable works and also
    733      provides prominent facilities for anybody to edit those works.  A
    734      public wiki that anybody can edit is an example of such a server.
    735      A "Massive Multiauthor Collaboration" (or "MMC") contained in the
    736      site means any set of copyrightable works thus published on the MMC
    737      site.
    738 
    739      "CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0
    740      license published by Creative Commons Corporation, a not-for-profit
    741      corporation with a principal place of business in San Francisco,
    742      California, as well as future copyleft versions of that license
    743      published by that same organization.
    744 
    745      "Incorporate" means to publish or republish a Document, in whole or
    746      in part, as part of another Document.
    747 
    748      An MMC is "eligible for relicensing" if it is licensed under this
    749      License, and if all works that were first published under this
    750      License somewhere other than this MMC, and subsequently
    751      incorporated in whole or in part into the MMC, (1) had no cover
    752      texts or invariant sections, and (2) were thus incorporated prior
    753      to November 1, 2008.
    754 
    755      The operator of an MMC Site may republish an MMC contained in the
    756      site under CC-BY-SA on the same site at any time before August 1,
    757      2009, provided the MMC is eligible for relicensing.
    758 
    759 ADDENDUM: How to use this License for your documents
    760 ====================================================
    761 
    762 To use this License in a document you have written, include a copy of
    763 the License in the document and put the following copyright and license
    764 notices just after the title page:
    765 
    766        Copyright (C)  YEAR  YOUR NAME.
    767        Permission is granted to copy, distribute and/or modify this document
    768        under the terms of the GNU Free Documentation License, Version 1.3
    769        or any later version published by the Free Software Foundation;
    770        with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
    771        Texts.  A copy of the license is included in the section entitled ``GNU
    772        Free Documentation License''.
    773 
    774    If you have Invariant Sections, Front-Cover Texts and Back-Cover
    775 Texts, replace the "with...Texts."  line with this:
    776 
    777          with the Invariant Sections being LIST THEIR TITLES, with
    778          the Front-Cover Texts being LIST, and with the Back-Cover Texts
    779          being LIST.
    780 
    781    If you have Invariant Sections without Cover Texts, or some other
    782 combination of the three, merge those two alternatives to suit the
    783 situation.
    784 
    785    If your document contains nontrivial examples of program code, we
    786 recommend releasing these examples in parallel under your choice of free
    787 software license, such as the GNU General Public License, to permit
    788 their use in free software.
    789 
    790 
    791 File: libquadmath.info,  Node: Reporting Bugs,  Prev: GNU Free Documentation License,  Up: Top
    792 
    793 4 Reporting Bugs
    794 ****************
    795 
    796 Bugs in the GCC Quad-Precision Math Library implementation should be
    797 reported via <https://gcc.gnu.org/bugs/>.
    798 
    799 
    800 
    801 Tag Table:
    802 Node: Top1633
    803 Node: Typedef and constants2367
    804 Node: Math Library Routines3786
    805 Node: I/O Library Routines7623
    806 Node: strtoflt1287948
    807 Node: quadmath_snprintf8708
    808 Node: GNU Free Documentation License10919
    809 Node: Reporting Bugs36071
    810 
    811 End Tag Table
    812