diff options
| -rw-r--r-- | doc/ChangeLog | 7 | ||||
| -rw-r--r-- | doc/gawk.info | 1038 | ||||
| -rw-r--r-- | doc/gawk.texi | 5 | ||||
| -rw-r--r-- | doc/gawktexi.in | 5 |
4 files changed, 532 insertions, 523 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 7acbea48..77d26057 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,10 @@ +2016-02-03 Andrew J. Schorr <aschorr@telemetry-investments.com> + + * gawktexi.in (Command-Line Options): Change wording of -M description + to say "Select" instead of "Force". + (Arbitrary-Precision Arithmetic Features): Tweak the wording to make + it clear that MPFR is not used unless the -M option is supplied. + 2016-02-03 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in (VMS Running): Improve the Texinfo usage. diff --git a/doc/gawk.info b/doc/gawk.info index 59c1c69e..24bd51ad 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -2605,7 +2605,7 @@ The following list describes options mandated by the POSIX standard: '-M' '--bignum' - Force arbitrary-precision arithmetic on numbers. This option has + Select arbitrary-precision arithmetic on numbers. This option has no effect if 'gawk' is not compiled to use the GNU MPFR and MP libraries (*note Arbitrary Precision Arithmetic::). @@ -21931,10 +21931,10 @@ File: gawk.info, Node: MPFR features, Next: FP Math Caution, Prev: Math Defin By default, 'gawk' uses the double-precision floating-point values supplied by the hardware of the system it runs on. However, if it was -compiled to do so, 'gawk' uses the GNU MPFR (http://www.mpfr.org) and -GNU MP (http://gmplib.org) (GMP) libraries for arbitrary-precision -arithmetic on numbers. You can see if MPFR support is available like -so: +compiled to do so, and the '-M' command-line option is supplied, 'gawk' +uses the GNU MPFR (http://www.mpfr.org) and GNU MP (http://gmplib.org) +(GMP) libraries for arbitrary-precision arithmetic on numbers. You can +see if MPFR support is available like so: $ gawk --version -| GNU Awk 4.1.2, API: 1.1 (GNU MPFR 3.1.0-p3, GNU MP 5.0.2) @@ -34634,519 +34634,519 @@ Node: Intro Summary112866 Node: Invoking Gawk113750 Node: Command Line115264 Node: Options116062 -Ref: Options-Footnote-1131969 -Ref: Options-Footnote-2132199 -Node: Other Arguments132224 -Node: Naming Standard Input135171 -Node: Environment Variables136264 -Node: AWKPATH Variable136822 -Ref: AWKPATH Variable-Footnote-1140123 -Ref: AWKPATH Variable-Footnote-2140168 -Node: AWKLIBPATH Variable140429 -Node: Other Environment Variables141573 -Node: Exit Status145338 -Node: Include Files146015 -Node: Loading Shared Libraries149610 -Node: Obsolete151038 -Node: Undocumented151730 -Node: Invoking Summary152027 -Node: Regexp153687 -Node: Regexp Usage155141 -Node: Escape Sequences157178 -Node: Regexp Operators163193 -Ref: Regexp Operators-Footnote-1170610 -Ref: Regexp Operators-Footnote-2170757 -Node: Bracket Expressions170855 -Ref: table-char-classes172878 -Node: Leftmost Longest176015 -Node: Computed Regexps177318 -Node: GNU Regexp Operators180745 -Node: Case-sensitivity184424 -Ref: Case-sensitivity-Footnote-1187311 -Ref: Case-sensitivity-Footnote-2187546 -Node: Regexp Summary187654 -Node: Reading Files189120 -Node: Records191214 -Node: awk split records191947 -Node: gawk split records196879 -Ref: gawk split records-Footnote-1201423 -Node: Fields201460 -Ref: Fields-Footnote-1204240 -Node: Nonconstant Fields204326 -Ref: Nonconstant Fields-Footnote-1206562 -Node: Changing Fields206766 -Node: Field Separators212696 -Node: Default Field Splitting215394 -Node: Regexp Field Splitting216512 -Node: Single Character Fields219865 -Node: Command Line Field Separator220925 -Node: Full Line Fields224143 -Ref: Full Line Fields-Footnote-1225665 -Ref: Full Line Fields-Footnote-2225711 -Node: Field Splitting Summary225812 -Node: Constant Size227886 -Node: Splitting By Content232465 -Ref: Splitting By Content-Footnote-1236436 -Node: Multiple Line236599 -Ref: Multiple Line-Footnote-1242482 -Node: Getline242661 -Node: Plain Getline244865 -Node: Getline/Variable247504 -Node: Getline/File248653 -Node: Getline/Variable/File250039 -Ref: Getline/Variable/File-Footnote-1251643 -Node: Getline/Pipe251731 -Node: Getline/Variable/Pipe254436 -Node: Getline/Coprocess255569 -Node: Getline/Variable/Coprocess256834 -Node: Getline Notes257574 -Node: Getline Summary260369 -Ref: table-getline-variants260791 -Node: Read Timeout261539 -Ref: Read Timeout-Footnote-1265380 -Node: Command-line directories265438 -Node: Input Summary266343 -Node: Input Exercises269515 -Node: Printing270243 -Node: Print272020 -Node: Print Examples273477 -Node: Output Separators276257 -Node: OFMT278274 -Node: Printf279630 -Node: Basic Printf280415 -Node: Control Letters281989 -Node: Format Modifiers285977 -Node: Printf Examples291992 -Node: Redirection294478 -Node: Special FD301321 -Ref: Special FD-Footnote-1304489 -Node: Special Files304563 -Node: Other Inherited Files305180 -Node: Special Network306181 -Node: Special Caveats307041 -Node: Close Files And Pipes307990 -Ref: Close Files And Pipes-Footnote-1315183 -Ref: Close Files And Pipes-Footnote-2315331 -Node: Output Summary315482 -Node: Output Exercises316480 -Node: Expressions317159 -Node: Values318347 -Node: Constants319025 -Node: Scalar Constants319716 -Ref: Scalar Constants-Footnote-1320580 -Node: Nondecimal-numbers320830 -Node: Regexp Constants323844 -Node: Using Constant Regexps324370 -Node: Variables327533 -Node: Using Variables328190 -Node: Assignment Options330101 -Node: Conversion331975 -Node: Strings And Numbers332499 -Ref: Strings And Numbers-Footnote-1335563 -Node: Locale influences conversions335672 -Ref: table-locale-affects338430 -Node: All Operators339048 -Node: Arithmetic Ops339677 -Node: Concatenation342183 -Ref: Concatenation-Footnote-1345030 -Node: Assignment Ops345137 -Ref: table-assign-ops350129 -Node: Increment Ops351442 -Node: Truth Values and Conditions354902 -Node: Truth Values355976 -Node: Typing and Comparison357024 -Node: Variable Typing357844 -Node: Comparison Operators361468 -Ref: table-relational-ops361887 -Node: POSIX String Comparison365382 -Ref: POSIX String Comparison-Footnote-1366456 -Node: Boolean Ops366595 -Ref: Boolean Ops-Footnote-1371077 -Node: Conditional Exp371169 -Node: Function Calls372905 -Node: Precedence376785 -Node: Locales380444 -Node: Expressions Summary382076 -Node: Patterns and Actions384649 -Node: Pattern Overview385769 -Node: Regexp Patterns387446 -Node: Expression Patterns387988 -Node: Ranges391769 -Node: BEGIN/END394877 -Node: Using BEGIN/END395638 -Ref: Using BEGIN/END-Footnote-1398375 -Node: I/O And BEGIN/END398481 -Node: BEGINFILE/ENDFILE400797 -Node: Empty403704 -Node: Using Shell Variables404021 -Node: Action Overview406295 -Node: Statements408620 -Node: If Statement410468 -Node: While Statement411963 -Node: Do Statement413991 -Node: For Statement415139 -Node: Switch Statement418298 -Node: Break Statement420684 -Node: Continue Statement422776 -Node: Next Statement424603 -Node: Nextfile Statement426986 -Node: Exit Statement429638 -Node: Built-in Variables432043 -Node: User-modified433176 -Ref: User-modified-Footnote-1440803 -Node: Auto-set440865 -Ref: Auto-set-Footnote-1453959 -Ref: Auto-set-Footnote-2454165 -Node: ARGC and ARGV454221 -Node: Pattern Action Summary458440 -Node: Arrays460870 -Node: Array Basics462199 -Node: Array Intro463043 -Ref: figure-array-elements465018 -Ref: Array Intro-Footnote-1467722 -Node: Reference to Elements467850 -Node: Assigning Elements470314 -Node: Array Example470805 -Node: Scanning an Array472564 -Node: Controlling Scanning475588 -Ref: Controlling Scanning-Footnote-1480987 -Node: Numeric Array Subscripts481303 -Node: Uninitialized Subscripts483487 -Node: Delete485106 -Ref: Delete-Footnote-1487858 -Node: Multidimensional487915 -Node: Multiscanning491010 -Node: Arrays of Arrays492601 -Node: Arrays Summary497369 -Node: Functions499462 -Node: Built-in500500 -Node: Calling Built-in501578 -Node: Numeric Functions503574 -Ref: Numeric Functions-Footnote-1507602 -Ref: Numeric Functions-Footnote-2507959 -Ref: Numeric Functions-Footnote-3508007 -Node: String Functions508279 -Ref: String Functions-Footnote-1531787 -Ref: String Functions-Footnote-2531916 -Ref: String Functions-Footnote-3532164 -Node: Gory Details532251 -Ref: table-sub-escapes534042 -Ref: table-sub-proposed535561 -Ref: table-posix-sub536924 -Ref: table-gensub-escapes538465 -Ref: Gory Details-Footnote-1539288 -Node: I/O Functions539439 -Ref: I/O Functions-Footnote-1546660 -Node: Time Functions546808 -Ref: Time Functions-Footnote-1557313 -Ref: Time Functions-Footnote-2557381 -Ref: Time Functions-Footnote-3557539 -Ref: Time Functions-Footnote-4557650 -Ref: Time Functions-Footnote-5557762 -Ref: Time Functions-Footnote-6557989 -Node: Bitwise Functions558255 -Ref: table-bitwise-ops558849 -Ref: Bitwise Functions-Footnote-1563187 -Node: Type Functions563360 -Node: I18N Functions564516 -Node: User-defined566167 -Node: Definition Syntax566972 -Ref: Definition Syntax-Footnote-1572659 -Node: Function Example572730 -Ref: Function Example-Footnote-1575652 -Node: Function Caveats575674 -Node: Calling A Function576192 -Node: Variable Scope577150 -Node: Pass By Value/Reference580144 -Node: Return Statement583643 -Node: Dynamic Typing586622 -Node: Indirect Calls587552 -Ref: Indirect Calls-Footnote-1597803 -Node: Functions Summary597931 -Node: Library Functions600636 -Ref: Library Functions-Footnote-1604245 -Ref: Library Functions-Footnote-2604388 -Node: Library Names604559 -Ref: Library Names-Footnote-1608020 -Ref: Library Names-Footnote-2608243 -Node: General Functions608329 -Node: Strtonum Function609432 -Node: Assert Function612454 -Node: Round Function615780 -Node: Cliff Random Function617321 -Node: Ordinal Functions618337 -Ref: Ordinal Functions-Footnote-1621400 -Ref: Ordinal Functions-Footnote-2621652 -Node: Join Function621862 -Ref: Join Function-Footnote-1623632 -Node: Getlocaltime Function623832 -Node: Readfile Function627576 -Node: Shell Quoting629550 -Node: Data File Management630951 -Node: Filetrans Function631583 -Node: Rewind Function635680 -Node: File Checking637066 -Ref: File Checking-Footnote-1638400 -Node: Empty Files638601 -Node: Ignoring Assigns640580 -Node: Getopt Function642130 -Ref: Getopt Function-Footnote-1653600 -Node: Passwd Functions653800 -Ref: Passwd Functions-Footnote-1662641 -Node: Group Functions662729 -Ref: Group Functions-Footnote-1670628 -Node: Walking Arrays670835 -Node: Library Functions Summary673845 -Node: Library Exercises675251 -Node: Sample Programs675716 -Node: Running Examples676486 -Node: Clones677214 -Node: Cut Program678438 -Node: Egrep Program688159 -Ref: Egrep Program-Footnote-1695671 -Node: Id Program695781 -Node: Split Program699461 -Ref: Split Program-Footnote-1702920 -Node: Tee Program703049 -Node: Uniq Program705839 -Node: Wc Program713265 -Ref: Wc Program-Footnote-1717520 -Node: Miscellaneous Programs717614 -Node: Dupword Program718827 -Node: Alarm Program720857 -Node: Translate Program725712 -Ref: Translate Program-Footnote-1730277 -Node: Labels Program730547 -Ref: Labels Program-Footnote-1733898 -Node: Word Sorting733982 -Node: History Sorting738054 -Node: Extract Program739889 -Node: Simple Sed747418 -Node: Igawk Program750492 -Ref: Igawk Program-Footnote-1764823 -Ref: Igawk Program-Footnote-2765025 -Ref: Igawk Program-Footnote-3765147 -Node: Anagram Program765262 -Node: Signature Program768324 -Node: Programs Summary769571 -Node: Programs Exercises770786 -Ref: Programs Exercises-Footnote-1774915 -Node: Advanced Features775006 -Node: Nondecimal Data776996 -Node: Array Sorting778587 -Node: Controlling Array Traversal779287 -Ref: Controlling Array Traversal-Footnote-1787656 -Node: Array Sorting Functions787774 -Ref: Array Sorting Functions-Footnote-1792865 -Node: Two-way I/O793061 -Ref: Two-way I/O-Footnote-1798881 -Ref: Two-way I/O-Footnote-2799068 -Node: TCP/IP Networking799150 -Node: Profiling802268 -Node: Advanced Features Summary809807 -Node: Internationalization811743 -Node: I18N and L10N813223 -Node: Explaining gettext813910 -Ref: Explaining gettext-Footnote-1818933 -Ref: Explaining gettext-Footnote-2819118 -Node: Programmer i18n819283 -Ref: Programmer i18n-Footnote-1824139 -Node: Translator i18n824188 -Node: String Extraction824982 -Ref: String Extraction-Footnote-1826115 -Node: Printf Ordering826201 -Ref: Printf Ordering-Footnote-1828987 -Node: I18N Portability829051 -Ref: I18N Portability-Footnote-1831507 -Node: I18N Example831570 -Ref: I18N Example-Footnote-1834376 -Node: Gawk I18N834449 -Node: I18N Summary835094 -Node: Debugger836435 -Node: Debugging837457 -Node: Debugging Concepts837898 -Node: Debugging Terms839707 -Node: Awk Debugging842282 -Node: Sample Debugging Session843188 -Node: Debugger Invocation843722 -Node: Finding The Bug845108 -Node: List of Debugger Commands851586 -Node: Breakpoint Control852919 -Node: Debugger Execution Control856613 -Node: Viewing And Changing Data859975 -Node: Execution Stack863349 -Node: Debugger Info864986 -Node: Miscellaneous Debugger Commands869057 -Node: Readline Support874145 -Node: Limitations875041 -Node: Debugging Summary877150 -Node: Arbitrary Precision Arithmetic878323 -Node: Computer Arithmetic879739 -Ref: table-numeric-ranges883330 -Ref: Computer Arithmetic-Footnote-1884052 -Node: Math Definitions884109 -Ref: table-ieee-formats887423 -Ref: Math Definitions-Footnote-1888026 -Node: MPFR features888131 -Node: FP Math Caution889804 -Ref: FP Math Caution-Footnote-1890876 -Node: Inexactness of computations891245 -Node: Inexact representation892205 -Node: Comparing FP Values893565 -Node: Errors accumulate894647 -Node: Getting Accuracy896080 -Node: Try To Round898790 -Node: Setting precision899689 -Ref: table-predefined-precision-strings900386 -Node: Setting the rounding mode902216 -Ref: table-gawk-rounding-modes902590 -Ref: Setting the rounding mode-Footnote-1905998 -Node: Arbitrary Precision Integers906177 -Ref: Arbitrary Precision Integers-Footnote-1909161 -Node: POSIX Floating Point Problems909310 -Ref: POSIX Floating Point Problems-Footnote-1913192 -Node: Floating point summary913230 -Node: Dynamic Extensions915420 -Node: Extension Intro916973 -Node: Plugin License918239 -Node: Extension Mechanism Outline919036 -Ref: figure-load-extension919475 -Ref: figure-register-new-function921040 -Ref: figure-call-new-function922132 -Node: Extension API Description924195 -Node: Extension API Functions Introduction925643 -Node: General Data Types930455 -Ref: General Data Types-Footnote-1936410 -Node: Memory Allocation Functions936709 -Ref: Memory Allocation Functions-Footnote-1939554 -Node: Constructor Functions939653 -Node: Registration Functions941398 -Node: Extension Functions942083 -Node: Exit Callback Functions944382 -Node: Extension Version String945632 -Node: Input Parsers946295 -Node: Output Wrappers956180 -Node: Two-way processors960692 -Node: Printing Messages962956 -Ref: Printing Messages-Footnote-1964030 -Node: Updating ERRNO964183 -Node: Requesting Values964922 -Ref: table-value-types-returned965659 -Node: Accessing Parameters966542 -Node: Symbol Table Access967778 -Node: Symbol table by name968290 -Node: Symbol table by cookie970311 -Ref: Symbol table by cookie-Footnote-1974460 -Node: Cached values974524 -Ref: Cached values-Footnote-1978025 -Node: Array Manipulation978116 -Ref: Array Manipulation-Footnote-1979215 -Node: Array Data Types979252 -Ref: Array Data Types-Footnote-1981910 -Node: Array Functions982002 -Node: Flattening Arrays985861 -Node: Creating Arrays992769 -Node: Extension API Variables997541 -Node: Extension Versioning998177 -Node: Extension API Informational Variables1000068 -Node: Extension API Boilerplate1001132 -Node: Finding Extensions1004946 -Node: Extension Example1005506 -Node: Internal File Description1006304 -Node: Internal File Ops1010384 -Ref: Internal File Ops-Footnote-11022146 -Node: Using Internal File Ops1022286 -Ref: Using Internal File Ops-Footnote-11024669 -Node: Extension Samples1024944 -Node: Extension Sample File Functions1026473 -Node: Extension Sample Fnmatch1034122 -Node: Extension Sample Fork1035609 -Node: Extension Sample Inplace1036827 -Node: Extension Sample Ord1040037 -Node: Extension Sample Readdir1040873 -Ref: table-readdir-file-types1041762 -Node: Extension Sample Revout1042567 -Node: Extension Sample Rev2way1043156 -Node: Extension Sample Read write array1043896 -Node: Extension Sample Readfile1045838 -Node: Extension Sample Time1046933 -Node: Extension Sample API Tests1048281 -Node: gawkextlib1048773 -Node: Extension summary1051197 -Node: Extension Exercises1054889 -Node: Language History1056386 -Node: V7/SVR3.11058042 -Node: SVR41060194 -Node: POSIX1061628 -Node: BTL1063008 -Node: POSIX/GNU1063738 -Node: Feature History1069259 -Node: Common Extensions1082588 -Node: Ranges and Locales1083871 -Ref: Ranges and Locales-Footnote-11088487 -Ref: Ranges and Locales-Footnote-21088514 -Ref: Ranges and Locales-Footnote-31088749 -Node: Contributors1088970 -Node: History summary1094539 -Node: Installation1095919 -Node: Gawk Distribution1096864 -Node: Getting1097348 -Node: Extracting1098309 -Node: Distribution contents1099947 -Node: Unix Installation1105700 -Node: Quick Installation1106316 -Node: Additional Configuration Options1108743 -Node: Configuration Philosophy1110547 -Node: Non-Unix Installation1112917 -Node: PC Installation1113375 -Node: PC Binary Installation1114695 -Node: PC Compiling1116547 -Ref: PC Compiling-Footnote-11119571 -Node: PC Testing1119680 -Node: PC Using1120860 -Node: Cygwin1124974 -Node: MSYS1125744 -Node: VMS Installation1126245 -Node: VMS Compilation1127036 -Ref: VMS Compilation-Footnote-11128266 -Node: VMS Dynamic Extensions1128324 -Node: VMS Installation Details1130009 -Node: VMS Running1132262 -Node: VMS GNV1136541 -Node: VMS Old Gawk1137276 -Node: Bugs1137747 -Node: Other Versions1141944 -Node: Installation summary1148530 -Node: Notes1149588 -Node: Compatibility Mode1150453 -Node: Additions1151235 -Node: Accessing The Source1152160 -Node: Adding Code1153596 -Node: New Ports1159815 -Node: Derived Files1164303 -Ref: Derived Files-Footnote-11169788 -Ref: Derived Files-Footnote-21169823 -Ref: Derived Files-Footnote-31170421 -Node: Future Extensions1170535 -Node: Implementation Limitations1171193 -Node: Extension Design1172376 -Node: Old Extension Problems1173530 -Ref: Old Extension Problems-Footnote-11175048 -Node: Extension New Mechanism Goals1175105 -Ref: Extension New Mechanism Goals-Footnote-11178469 -Node: Extension Other Design Decisions1178658 -Node: Extension Future Growth1180771 -Node: Old Extension Mechanism1181607 -Node: Notes summary1183370 -Node: Basic Concepts1184552 -Node: Basic High Level1185233 -Ref: figure-general-flow1185515 -Ref: figure-process-flow1186200 -Ref: Basic High Level-Footnote-11189501 -Node: Basic Data Typing1189686 -Node: Glossary1193014 -Node: Copying1224960 -Node: GNU Free Documentation License1262499 -Node: Index1287617 +Ref: Options-Footnote-1131970 +Ref: Options-Footnote-2132200 +Node: Other Arguments132225 +Node: Naming Standard Input135172 +Node: Environment Variables136265 +Node: AWKPATH Variable136823 +Ref: AWKPATH Variable-Footnote-1140124 +Ref: AWKPATH Variable-Footnote-2140169 +Node: AWKLIBPATH Variable140430 +Node: Other Environment Variables141574 +Node: Exit Status145339 +Node: Include Files146016 +Node: Loading Shared Libraries149611 +Node: Obsolete151039 +Node: Undocumented151731 +Node: Invoking Summary152028 +Node: Regexp153688 +Node: Regexp Usage155142 +Node: Escape Sequences157179 +Node: Regexp Operators163194 +Ref: Regexp Operators-Footnote-1170611 +Ref: Regexp Operators-Footnote-2170758 +Node: Bracket Expressions170856 +Ref: table-char-classes172879 +Node: Leftmost Longest176016 +Node: Computed Regexps177319 +Node: GNU Regexp Operators180746 +Node: Case-sensitivity184425 +Ref: Case-sensitivity-Footnote-1187312 +Ref: Case-sensitivity-Footnote-2187547 +Node: Regexp Summary187655 +Node: Reading Files189121 +Node: Records191215 +Node: awk split records191948 +Node: gawk split records196880 +Ref: gawk split records-Footnote-1201424 +Node: Fields201461 +Ref: Fields-Footnote-1204241 +Node: Nonconstant Fields204327 +Ref: Nonconstant Fields-Footnote-1206563 +Node: Changing Fields206767 +Node: Field Separators212697 +Node: Default Field Splitting215395 +Node: Regexp Field Splitting216513 +Node: Single Character Fields219866 +Node: Command Line Field Separator220926 +Node: Full Line Fields224144 +Ref: Full Line Fields-Footnote-1225666 +Ref: Full Line Fields-Footnote-2225712 +Node: Field Splitting Summary225813 +Node: Constant Size227887 +Node: Splitting By Content232466 +Ref: Splitting By Content-Footnote-1236437 +Node: Multiple Line236600 +Ref: Multiple Line-Footnote-1242483 +Node: Getline242662 +Node: Plain Getline244866 +Node: Getline/Variable247505 +Node: Getline/File248654 +Node: Getline/Variable/File250040 +Ref: Getline/Variable/File-Footnote-1251644 +Node: Getline/Pipe251732 +Node: Getline/Variable/Pipe254437 +Node: Getline/Coprocess255570 +Node: Getline/Variable/Coprocess256835 +Node: Getline Notes257575 +Node: Getline Summary260370 +Ref: table-getline-variants260792 +Node: Read Timeout261540 +Ref: Read Timeout-Footnote-1265381 +Node: Command-line directories265439 +Node: Input Summary266344 +Node: Input Exercises269516 +Node: Printing270244 +Node: Print272021 +Node: Print Examples273478 +Node: Output Separators276258 +Node: OFMT278275 +Node: Printf279631 +Node: Basic Printf280416 +Node: Control Letters281990 +Node: Format Modifiers285978 +Node: Printf Examples291993 +Node: Redirection294479 +Node: Special FD301322 +Ref: Special FD-Footnote-1304490 +Node: Special Files304564 +Node: Other Inherited Files305181 +Node: Special Network306182 +Node: Special Caveats307042 +Node: Close Files And Pipes307991 +Ref: Close Files And Pipes-Footnote-1315184 +Ref: Close Files And Pipes-Footnote-2315332 +Node: Output Summary315483 +Node: Output Exercises316481 +Node: Expressions317160 +Node: Values318348 +Node: Constants319026 +Node: Scalar Constants319717 +Ref: Scalar Constants-Footnote-1320581 +Node: Nondecimal-numbers320831 +Node: Regexp Constants323845 +Node: Using Constant Regexps324371 +Node: Variables327534 +Node: Using Variables328191 +Node: Assignment Options330102 +Node: Conversion331976 +Node: Strings And Numbers332500 +Ref: Strings And Numbers-Footnote-1335564 +Node: Locale influences conversions335673 +Ref: table-locale-affects338431 +Node: All Operators339049 +Node: Arithmetic Ops339678 +Node: Concatenation342184 +Ref: Concatenation-Footnote-1345031 +Node: Assignment Ops345138 +Ref: table-assign-ops350130 +Node: Increment Ops351443 +Node: Truth Values and Conditions354903 +Node: Truth Values355977 +Node: Typing and Comparison357025 +Node: Variable Typing357845 +Node: Comparison Operators361469 +Ref: table-relational-ops361888 +Node: POSIX String Comparison365383 +Ref: POSIX String Comparison-Footnote-1366457 +Node: Boolean Ops366596 +Ref: Boolean Ops-Footnote-1371078 +Node: Conditional Exp371170 +Node: Function Calls372906 +Node: Precedence376786 +Node: Locales380445 +Node: Expressions Summary382077 +Node: Patterns and Actions384650 +Node: Pattern Overview385770 +Node: Regexp Patterns387447 +Node: Expression Patterns387989 +Node: Ranges391770 +Node: BEGIN/END394878 +Node: Using BEGIN/END395639 +Ref: Using BEGIN/END-Footnote-1398376 +Node: I/O And BEGIN/END398482 +Node: BEGINFILE/ENDFILE400798 +Node: Empty403705 +Node: Using Shell Variables404022 +Node: Action Overview406296 +Node: Statements408621 +Node: If Statement410469 +Node: While Statement411964 +Node: Do Statement413992 +Node: For Statement415140 +Node: Switch Statement418299 +Node: Break Statement420685 +Node: Continue Statement422777 +Node: Next Statement424604 +Node: Nextfile Statement426987 +Node: Exit Statement429639 +Node: Built-in Variables432044 +Node: User-modified433177 +Ref: User-modified-Footnote-1440804 +Node: Auto-set440866 +Ref: Auto-set-Footnote-1453960 +Ref: Auto-set-Footnote-2454166 +Node: ARGC and ARGV454222 +Node: Pattern Action Summary458441 +Node: Arrays460871 +Node: Array Basics462200 +Node: Array Intro463044 +Ref: figure-array-elements465019 +Ref: Array Intro-Footnote-1467723 +Node: Reference to Elements467851 +Node: Assigning Elements470315 +Node: Array Example470806 +Node: Scanning an Array472565 +Node: Controlling Scanning475589 +Ref: Controlling Scanning-Footnote-1480988 +Node: Numeric Array Subscripts481304 +Node: Uninitialized Subscripts483488 +Node: Delete485107 +Ref: Delete-Footnote-1487859 +Node: Multidimensional487916 +Node: Multiscanning491011 +Node: Arrays of Arrays492602 +Node: Arrays Summary497370 +Node: Functions499463 +Node: Built-in500501 +Node: Calling Built-in501579 +Node: Numeric Functions503575 +Ref: Numeric Functions-Footnote-1507603 +Ref: Numeric Functions-Footnote-2507960 +Ref: Numeric Functions-Footnote-3508008 +Node: String Functions508280 +Ref: String Functions-Footnote-1531788 +Ref: String Functions-Footnote-2531917 +Ref: String Functions-Footnote-3532165 +Node: Gory Details532252 +Ref: table-sub-escapes534043 +Ref: table-sub-proposed535562 +Ref: table-posix-sub536925 +Ref: table-gensub-escapes538466 +Ref: Gory Details-Footnote-1539289 +Node: I/O Functions539440 +Ref: I/O Functions-Footnote-1546661 +Node: Time Functions546809 +Ref: Time Functions-Footnote-1557314 +Ref: Time Functions-Footnote-2557382 +Ref: Time Functions-Footnote-3557540 +Ref: Time Functions-Footnote-4557651 +Ref: Time Functions-Footnote-5557763 +Ref: Time Functions-Footnote-6557990 +Node: Bitwise Functions558256 +Ref: table-bitwise-ops558850 +Ref: Bitwise Functions-Footnote-1563188 +Node: Type Functions563361 +Node: I18N Functions564517 +Node: User-defined566168 +Node: Definition Syntax566973 +Ref: Definition Syntax-Footnote-1572660 +Node: Function Example572731 +Ref: Function Example-Footnote-1575653 +Node: Function Caveats575675 +Node: Calling A Function576193 +Node: Variable Scope577151 +Node: Pass By Value/Reference580145 +Node: Return Statement583644 +Node: Dynamic Typing586623 +Node: Indirect Calls587553 +Ref: Indirect Calls-Footnote-1597804 +Node: Functions Summary597932 +Node: Library Functions600637 +Ref: Library Functions-Footnote-1604246 +Ref: Library Functions-Footnote-2604389 +Node: Library Names604560 +Ref: Library Names-Footnote-1608021 +Ref: Library Names-Footnote-2608244 +Node: General Functions608330 +Node: Strtonum Function609433 +Node: Assert Function612455 +Node: Round Function615781 +Node: Cliff Random Function617322 +Node: Ordinal Functions618338 +Ref: Ordinal Functions-Footnote-1621401 +Ref: Ordinal Functions-Footnote-2621653 +Node: Join Function621863 +Ref: Join Function-Footnote-1623633 +Node: Getlocaltime Function623833 +Node: Readfile Function627577 +Node: Shell Quoting629551 +Node: Data File Management630952 +Node: Filetrans Function631584 +Node: Rewind Function635681 +Node: File Checking637067 +Ref: File Checking-Footnote-1638401 +Node: Empty Files638602 +Node: Ignoring Assigns640581 +Node: Getopt Function642131 +Ref: Getopt Function-Footnote-1653601 +Node: Passwd Functions653801 +Ref: Passwd Functions-Footnote-1662642 +Node: Group Functions662730 +Ref: Group Functions-Footnote-1670629 +Node: Walking Arrays670836 +Node: Library Functions Summary673846 +Node: Library Exercises675252 +Node: Sample Programs675717 +Node: Running Examples676487 +Node: Clones677215 +Node: Cut Program678439 +Node: Egrep Program688160 +Ref: Egrep Program-Footnote-1695672 +Node: Id Program695782 +Node: Split Program699462 +Ref: Split Program-Footnote-1702921 +Node: Tee Program703050 +Node: Uniq Program705840 +Node: Wc Program713266 +Ref: Wc Program-Footnote-1717521 +Node: Miscellaneous Programs717615 +Node: Dupword Program718828 +Node: Alarm Program720858 +Node: Translate Program725713 +Ref: Translate Program-Footnote-1730278 +Node: Labels Program730548 +Ref: Labels Program-Footnote-1733899 +Node: Word Sorting733983 +Node: History Sorting738055 +Node: Extract Program739890 +Node: Simple Sed747419 +Node: Igawk Program750493 +Ref: Igawk Program-Footnote-1764824 +Ref: Igawk Program-Footnote-2765026 +Ref: Igawk Program-Footnote-3765148 +Node: Anagram Program765263 +Node: Signature Program768325 +Node: Programs Summary769572 +Node: Programs Exercises770787 +Ref: Programs Exercises-Footnote-1774916 +Node: Advanced Features775007 +Node: Nondecimal Data776997 +Node: Array Sorting778588 +Node: Controlling Array Traversal779288 +Ref: Controlling Array Traversal-Footnote-1787657 +Node: Array Sorting Functions787775 +Ref: Array Sorting Functions-Footnote-1792866 +Node: Two-way I/O793062 +Ref: Two-way I/O-Footnote-1798882 +Ref: Two-way I/O-Footnote-2799069 +Node: TCP/IP Networking799151 +Node: Profiling802269 +Node: Advanced Features Summary809808 +Node: Internationalization811744 +Node: I18N and L10N813224 +Node: Explaining gettext813911 +Ref: Explaining gettext-Footnote-1818934 +Ref: Explaining gettext-Footnote-2819119 +Node: Programmer i18n819284 +Ref: Programmer i18n-Footnote-1824140 +Node: Translator i18n824189 +Node: String Extraction824983 +Ref: String Extraction-Footnote-1826116 +Node: Printf Ordering826202 +Ref: Printf Ordering-Footnote-1828988 +Node: I18N Portability829052 +Ref: I18N Portability-Footnote-1831508 +Node: I18N Example831571 +Ref: I18N Example-Footnote-1834377 +Node: Gawk I18N834450 +Node: I18N Summary835095 +Node: Debugger836436 +Node: Debugging837458 +Node: Debugging Concepts837899 +Node: Debugging Terms839708 +Node: Awk Debugging842283 +Node: Sample Debugging Session843189 +Node: Debugger Invocation843723 +Node: Finding The Bug845109 +Node: List of Debugger Commands851587 +Node: Breakpoint Control852920 +Node: Debugger Execution Control856614 +Node: Viewing And Changing Data859976 +Node: Execution Stack863350 +Node: Debugger Info864987 +Node: Miscellaneous Debugger Commands869058 +Node: Readline Support874146 +Node: Limitations875042 +Node: Debugging Summary877151 +Node: Arbitrary Precision Arithmetic878324 +Node: Computer Arithmetic879740 +Ref: table-numeric-ranges883331 +Ref: Computer Arithmetic-Footnote-1884053 +Node: Math Definitions884110 +Ref: table-ieee-formats887424 +Ref: Math Definitions-Footnote-1888027 +Node: MPFR features888132 +Node: FP Math Caution889851 +Ref: FP Math Caution-Footnote-1890923 +Node: Inexactness of computations891292 +Node: Inexact representation892252 +Node: Comparing FP Values893612 +Node: Errors accumulate894694 +Node: Getting Accuracy896127 +Node: Try To Round898837 +Node: Setting precision899736 +Ref: table-predefined-precision-strings900433 +Node: Setting the rounding mode902263 +Ref: table-gawk-rounding-modes902637 +Ref: Setting the rounding mode-Footnote-1906045 +Node: Arbitrary Precision Integers906224 +Ref: Arbitrary Precision Integers-Footnote-1909208 +Node: POSIX Floating Point Problems909357 +Ref: POSIX Floating Point Problems-Footnote-1913239 +Node: Floating point summary913277 +Node: Dynamic Extensions915467 +Node: Extension Intro917020 +Node: Plugin License918286 +Node: Extension Mechanism Outline919083 +Ref: figure-load-extension919522 +Ref: figure-register-new-function921087 +Ref: figure-call-new-function922179 +Node: Extension API Description924242 +Node: Extension API Functions Introduction925690 +Node: General Data Types930502 +Ref: General Data Types-Footnote-1936457 +Node: Memory Allocation Functions936756 +Ref: Memory Allocation Functions-Footnote-1939601 +Node: Constructor Functions939700 +Node: Registration Functions941445 +Node: Extension Functions942130 +Node: Exit Callback Functions944429 +Node: Extension Version String945679 +Node: Input Parsers946342 +Node: Output Wrappers956227 +Node: Two-way processors960739 +Node: Printing Messages963003 +Ref: Printing Messages-Footnote-1964077 +Node: Updating ERRNO964230 +Node: Requesting Values964969 +Ref: table-value-types-returned965706 +Node: Accessing Parameters966589 +Node: Symbol Table Access967825 +Node: Symbol table by name968337 +Node: Symbol table by cookie970358 +Ref: Symbol table by cookie-Footnote-1974507 +Node: Cached values974571 +Ref: Cached values-Footnote-1978072 +Node: Array Manipulation978163 +Ref: Array Manipulation-Footnote-1979262 +Node: Array Data Types979299 +Ref: Array Data Types-Footnote-1981957 +Node: Array Functions982049 +Node: Flattening Arrays985908 +Node: Creating Arrays992816 +Node: Extension API Variables997588 +Node: Extension Versioning998224 +Node: Extension API Informational Variables1000115 +Node: Extension API Boilerplate1001179 +Node: Finding Extensions1004993 +Node: Extension Example1005553 +Node: Internal File Description1006351 +Node: Internal File Ops1010431 +Ref: Internal File Ops-Footnote-11022193 +Node: Using Internal File Ops1022333 +Ref: Using Internal File Ops-Footnote-11024716 +Node: Extension Samples1024991 +Node: Extension Sample File Functions1026520 +Node: Extension Sample Fnmatch1034169 +Node: Extension Sample Fork1035656 +Node: Extension Sample Inplace1036874 +Node: Extension Sample Ord1040084 +Node: Extension Sample Readdir1040920 +Ref: table-readdir-file-types1041809 +Node: Extension Sample Revout1042614 +Node: Extension Sample Rev2way1043203 +Node: Extension Sample Read write array1043943 +Node: Extension Sample Readfile1045885 +Node: Extension Sample Time1046980 +Node: Extension Sample API Tests1048328 +Node: gawkextlib1048820 +Node: Extension summary1051244 +Node: Extension Exercises1054936 +Node: Language History1056433 +Node: V7/SVR3.11058089 +Node: SVR41060241 +Node: POSIX1061675 +Node: BTL1063055 +Node: POSIX/GNU1063785 +Node: Feature History1069306 +Node: Common Extensions1082635 +Node: Ranges and Locales1083918 +Ref: Ranges and Locales-Footnote-11088534 +Ref: Ranges and Locales-Footnote-21088561 +Ref: Ranges and Locales-Footnote-31088796 +Node: Contributors1089017 +Node: History summary1094586 +Node: Installation1095966 +Node: Gawk Distribution1096911 +Node: Getting1097395 +Node: Extracting1098356 +Node: Distribution contents1099994 +Node: Unix Installation1105747 +Node: Quick Installation1106363 +Node: Additional Configuration Options1108790 +Node: Configuration Philosophy1110594 +Node: Non-Unix Installation1112964 +Node: PC Installation1113422 +Node: PC Binary Installation1114742 +Node: PC Compiling1116594 +Ref: PC Compiling-Footnote-11119618 +Node: PC Testing1119727 +Node: PC Using1120907 +Node: Cygwin1125021 +Node: MSYS1125791 +Node: VMS Installation1126292 +Node: VMS Compilation1127083 +Ref: VMS Compilation-Footnote-11128313 +Node: VMS Dynamic Extensions1128371 +Node: VMS Installation Details1130056 +Node: VMS Running1132309 +Node: VMS GNV1136588 +Node: VMS Old Gawk1137323 +Node: Bugs1137794 +Node: Other Versions1141991 +Node: Installation summary1148577 +Node: Notes1149635 +Node: Compatibility Mode1150500 +Node: Additions1151282 +Node: Accessing The Source1152207 +Node: Adding Code1153643 +Node: New Ports1159862 +Node: Derived Files1164350 +Ref: Derived Files-Footnote-11169835 +Ref: Derived Files-Footnote-21169870 +Ref: Derived Files-Footnote-31170468 +Node: Future Extensions1170582 +Node: Implementation Limitations1171240 +Node: Extension Design1172423 +Node: Old Extension Problems1173577 +Ref: Old Extension Problems-Footnote-11175095 +Node: Extension New Mechanism Goals1175152 +Ref: Extension New Mechanism Goals-Footnote-11178516 +Node: Extension Other Design Decisions1178705 +Node: Extension Future Growth1180818 +Node: Old Extension Mechanism1181654 +Node: Notes summary1183417 +Node: Basic Concepts1184599 +Node: Basic High Level1185280 +Ref: figure-general-flow1185562 +Ref: figure-process-flow1186247 +Ref: Basic High Level-Footnote-11189548 +Node: Basic Data Typing1189733 +Node: Glossary1193061 +Node: Copying1225007 +Node: GNU Free Documentation License1262546 +Node: Index1287664 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 146a3761..a48c40f6 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -4044,7 +4044,7 @@ care to search for all occurrences of each inappropriate construct. As @itemx @option{--bignum} @cindex @option{-M} option @cindex @option{--bignum} option -Force arbitrary-precision arithmetic on numbers. This option has no effect +Select arbitrary-precision arithmetic on numbers. This option has no effect if @command{gawk} is not compiled to use the GNU MPFR and MP libraries (@pxref{Arbitrary Precision Arithmetic}). @@ -30459,7 +30459,8 @@ one extra bit of significand. By default, @command{gawk} uses the double-precision floating-point values supplied by the hardware of the system it runs on. However, if it was -compiled to do so, @command{gawk} uses the @uref{http://www.mpfr.org, +compiled to do so, and the @option{-M} command-line option is supplied, +@command{gawk} uses the @uref{http://www.mpfr.org, GNU MPFR} and @uref{http://gmplib.org, GNU MP} (GMP) libraries for arbitrary-precision arithmetic on numbers. You can see if MPFR support is available like so: diff --git a/doc/gawktexi.in b/doc/gawktexi.in index fd2f2825..c392624d 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -3955,7 +3955,7 @@ care to search for all occurrences of each inappropriate construct. As @itemx @option{--bignum} @cindex @option{-M} option @cindex @option{--bignum} option -Force arbitrary-precision arithmetic on numbers. This option has no effect +Select arbitrary-precision arithmetic on numbers. This option has no effect if @command{gawk} is not compiled to use the GNU MPFR and MP libraries (@pxref{Arbitrary Precision Arithmetic}). @@ -29550,7 +29550,8 @@ one extra bit of significand. By default, @command{gawk} uses the double-precision floating-point values supplied by the hardware of the system it runs on. However, if it was -compiled to do so, @command{gawk} uses the @uref{http://www.mpfr.org, +compiled to do so, and the @option{-M} command-line option is supplied, +@command{gawk} uses the @uref{http://www.mpfr.org, GNU MPFR} and @uref{http://gmplib.org, GNU MP} (GMP) libraries for arbitrary-precision arithmetic on numbers. You can see if MPFR support is available like so: |