Mercurial > repos > rliterman > csp2

annotate CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/share/info/libquadmath.info @ 68:5028fdace37b

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