diff options
author | Arnold D. Robbins <arnold@skeeve.com> | 2023-05-15 22:19:10 +0300 |
---|---|---|
committer | Arnold D. Robbins <arnold@skeeve.com> | 2023-05-15 22:19:10 +0300 |
commit | a9c370a24f51f9840f6aedd0c719dd3d49de6265 (patch) | |
tree | cfede22c87d5975bb89d2d9dd7f1b6908867f7b3 | |
parent | b285b6b6a05e92af5c8814d5a475195a5c0ea81e (diff) | |
download | gawk-5.2-stable.tar.gz |
Small doc improvement.gawk-5.2-stable
-rw-r--r-- | doc/ChangeLog | 5 | ||||
-rw-r--r-- | doc/gawk.info | 981 | ||||
-rw-r--r-- | doc/gawk.texi | 6 | ||||
-rw-r--r-- | doc/gawktexi.in | 6 |
4 files changed, 510 insertions, 488 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 4eab337d..42aa9352 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2023-05-15 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in (OFMT): Add note about conversion of + integral values. + 2023-05-07 Arnold D. Robbins <arnold@skeeve.com> * 5.2.2: Release tar ball made. diff --git a/doc/gawk.info b/doc/gawk.info index 36a7ee90..ed9f53b7 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -6924,6 +6924,11 @@ example: > print 17.23, 17.54 }' ⊣ 17 18 + More detail on how ‘awk’ converts numeric values into strings is +provided in *note Strings And Numbers::. In particular, for ‘print’, +‘awk’ uses the value of ‘OFMT’ instead of that of ‘CONVFMT’, but +otherwise behaves exactly the same as described in that minor node. + According to the POSIX standard, ‘awk’’s behavior is undefined if ‘OFMT’ contains anything but a floating-point conversion specification. (d.c.) @@ -36762,7 +36767,7 @@ Index * dark corner, field separators: Full Line Fields. (line 22) * dark corner, multiline records: Multiple Line. (line 35) * dark corner, FILENAME variable: Getline Notes. (line 19) -* dark corner, OFMT variable: OFMT. (line 27) +* dark corner, OFMT variable: OFMT. (line 32) * dark corner, format-control characters: Control Letters. (line 33) * dark corner, format-control characters <1>: Control Letters. (line 108) @@ -38267,7 +38272,7 @@ Index * octal numbers: Nondecimal-numbers. (line 6) * octal values, enabling interpretation of: Options. (line 255) * OFMT variable: OFMT. (line 15) -* OFMT variable, POSIX awk and: OFMT. (line 27) +* OFMT variable, POSIX awk and: OFMT. (line 32) * OFMT variable <1>: Strings And Numbers. (line 56) * OFMT variable <2>: User-modified. (line 107) * OFS variable: Changing Fields. (line 64) @@ -38463,7 +38468,7 @@ Index * POSIX awk, field separators and: Full Line Fields. (line 16) * POSIX awk, < operator and: Getline/File. (line 26) * POSIX awk, | I/O operator and: Getline/Pipe. (line 56) -* POSIX awk, OFMT variable and: OFMT. (line 27) +* POSIX awk, OFMT variable and: OFMT. (line 32) * POSIX awk, printf format strings and: Format Modifiers. (line 157) * POSIX awk, OFMT variable and <1>: Strings And Numbers. (line 56) * POSIX awk, arithmetic operators and: Arithmetic Ops. (line 30) @@ -39514,491 +39519,491 @@ Node: Print308864 Node: Print Examples310370 Node: Output Separators313223 Node: OFMT315334 -Node: Printf316757 -Node: Basic Printf317562 -Node: Control Letters319198 -Node: Format Modifiers324667 -Node: Printf Examples330953 -Node: Redirection333498 -Node: Special FD340572 -Ref: Special FD-Footnote-1343862 -Node: Special Files343948 -Node: Other Inherited Files344577 -Node: Special Network345642 -Node: Special Caveats346530 -Node: Close Files And Pipes347513 -Ref: Close Files And Pipes-Footnote-1353650 -Node: Close Return Value353806 -Ref: table-close-pipe-return-values355081 -Ref: Close Return Value-Footnote-1355915 -Node: Nonfatal356071 -Node: Output Summary358502 -Node: Output Exercises359788 -Node: Expressions360479 -Node: Values361681 -Node: Constants362359 -Node: Scalar Constants363056 -Ref: Scalar Constants-Footnote-1365631 -Node: Nondecimal-numbers365881 -Node: Regexp Constants369002 -Node: Using Constant Regexps369548 -Node: Standard Regexp Constants370194 -Node: Strong Regexp Constants373494 -Node: Variables377345 -Node: Using Variables378010 -Node: Assignment Options379990 -Node: Conversion382552 -Node: Strings And Numbers383084 -Ref: Strings And Numbers-Footnote-1386303 -Node: Locale influences conversions386412 -Ref: table-locale-affects389262 -Node: All Operators389905 -Node: Arithmetic Ops390546 -Node: Concatenation393376 -Ref: Concatenation-Footnote-1396326 -Node: Assignment Ops396449 -Ref: table-assign-ops401588 -Node: Increment Ops402970 -Node: Truth Values and Conditions406569 -Node: Truth Values407695 -Node: Typing and Comparison408786 -Node: Variable Typing409622 -Ref: Variable Typing-Footnote-1416284 -Ref: Variable Typing-Footnote-2416364 -Node: Comparison Operators416447 -Ref: table-relational-ops416874 -Node: POSIX String Comparison420560 -Ref: POSIX String Comparison-Footnote-1422319 -Ref: POSIX String Comparison-Footnote-2422462 -Node: Boolean Ops422546 -Ref: Boolean Ops-Footnote-1427239 -Node: Conditional Exp427335 -Node: Function Calls429121 -Node: Precedence433071 -Node: Locales436948 -Node: Expressions Summary438630 -Node: Patterns and Actions441293 -Node: Pattern Overview442435 -Node: Regexp Patterns444161 -Node: Expression Patterns444707 -Node: Ranges448616 -Node: BEGIN/END451794 -Node: Using BEGIN/END452607 -Ref: Using BEGIN/END-Footnote-1455517 -Node: I/O And BEGIN/END455627 -Node: BEGINFILE/ENDFILE458108 -Node: Empty461549 -Node: Using Shell Variables461866 -Node: Action Overview464204 -Node: Statements466639 -Node: If Statement468537 -Node: While Statement470106 -Node: Do Statement472194 -Node: For Statement473380 -Node: Switch Statement476737 -Node: Break Statement479288 -Node: Continue Statement481480 -Node: Next Statement483412 -Node: Nextfile Statement485909 -Node: Exit Statement488770 -Node: Built-in Variables491303 -Node: User-modified492482 -Node: Auto-set500693 -Ref: Auto-set-Footnote-1518546 -Ref: Auto-set-Footnote-2518764 -Node: ARGC and ARGV518820 -Node: Pattern Action Summary523259 -Node: Arrays525875 -Node: Array Basics527252 -Node: Array Intro528102 -Ref: figure-array-elements530118 -Ref: Array Intro-Footnote-1532987 -Node: Reference to Elements533119 -Node: Assigning Elements535641 -Node: Array Example536136 -Node: Scanning an Array538105 -Node: Controlling Scanning541202 -Ref: Controlling Scanning-Footnote-1547848 -Node: Numeric Array Subscripts548172 -Node: Uninitialized Subscripts550446 -Node: Delete552125 -Ref: Delete-Footnote-1554939 -Node: Multidimensional554996 -Node: Multiscanning558201 -Node: Arrays of Arrays559873 -Node: Arrays Summary564773 -Node: Functions566962 -Node: Built-in568022 -Node: Calling Built-in569211 -Node: Boolean Functions571258 -Node: Numeric Functions571828 -Ref: Numeric Functions-Footnote-1576021 -Ref: Numeric Functions-Footnote-2576705 -Ref: Numeric Functions-Footnote-3576757 -Node: String Functions577033 -Ref: String Functions-Footnote-1602863 -Ref: String Functions-Footnote-2602997 -Ref: String Functions-Footnote-3603257 -Node: Gory Details603344 -Ref: table-sub-escapes605251 -Ref: table-sub-proposed606897 -Ref: table-posix-sub608407 -Ref: table-gensub-escapes610095 -Ref: Gory Details-Footnote-1611029 -Node: I/O Functions611183 -Ref: table-system-return-values617870 -Ref: I/O Functions-Footnote-1620041 -Ref: I/O Functions-Footnote-2620189 -Node: Time Functions620309 -Ref: Time Functions-Footnote-1631465 -Ref: Time Functions-Footnote-2631541 -Ref: Time Functions-Footnote-3631703 -Ref: Time Functions-Footnote-4631814 -Ref: Time Functions-Footnote-5631932 -Ref: Time Functions-Footnote-6632167 -Node: Bitwise Functions632449 -Ref: table-bitwise-ops633051 -Ref: Bitwise Functions-Footnote-1639305 -Ref: Bitwise Functions-Footnote-2639484 -Node: Type Functions639681 -Node: I18N Functions643274 -Node: User-defined645017 -Node: Definition Syntax645837 -Ref: Definition Syntax-Footnote-1651665 -Node: Function Example651742 -Ref: Function Example-Footnote-1654721 -Node: Function Calling654743 -Node: Calling A Function655337 -Node: Variable Scope656307 -Node: Pass By Value/Reference659361 -Node: Function Caveats662093 -Ref: Function Caveats-Footnote-1664188 -Node: Return Statement664312 -Node: Dynamic Typing667367 -Node: Indirect Calls669768 -Node: Functions Summary680927 -Node: Library Functions683704 -Ref: Library Functions-Footnote-1687252 -Ref: Library Functions-Footnote-2687395 -Node: Library Names687570 -Ref: Library Names-Footnote-1691364 -Ref: Library Names-Footnote-2691591 -Node: General Functions691687 -Node: Strtonum Function692881 -Node: Assert Function695963 -Node: Round Function699415 -Node: Cliff Random Function700993 -Node: Ordinal Functions702026 -Ref: Ordinal Functions-Footnote-1705135 -Ref: Ordinal Functions-Footnote-2705387 -Node: Join Function705601 -Ref: Join Function-Footnote-1707404 -Node: Getlocaltime Function707608 -Node: Readfile Function711382 -Node: Shell Quoting713411 -Node: Isnumeric Function714867 -Node: Data File Management716279 -Node: Filetrans Function716911 -Node: Rewind Function721205 -Node: File Checking723184 -Ref: File Checking-Footnote-1724556 -Node: Empty Files724763 -Node: Ignoring Assigns726830 -Node: Getopt Function728404 -Ref: Getopt Function-Footnote-1744238 -Node: Passwd Functions744450 -Ref: Passwd Functions-Footnote-1753632 -Node: Group Functions753720 -Ref: Group Functions-Footnote-1761858 -Node: Walking Arrays762071 -Node: Library Functions Summary765119 -Node: Library Exercises766543 -Node: Sample Programs767030 -Node: Running Examples767812 -Node: Clones768564 -Node: Cut Program769836 -Node: Egrep Program780277 -Node: Id Program789594 -Node: Split Program799708 -Ref: Split Program-Footnote-1809943 -Node: Tee Program810130 -Node: Uniq Program813039 -Node: Wc Program820904 -Node: Bytes vs. Characters821299 -Node: Using extensions822901 -Node: wc program823681 -Node: Miscellaneous Programs828687 -Node: Dupword Program829916 -Node: Alarm Program831979 -Node: Translate Program836892 -Ref: Translate Program-Footnote-1841633 -Node: Labels Program841911 -Ref: Labels Program-Footnote-1845352 -Node: Word Sorting845444 -Node: History Sorting849638 -Node: Extract Program851913 -Node: Simple Sed860182 -Node: Igawk Program863398 -Ref: Igawk Program-Footnote-1878645 -Ref: Igawk Program-Footnote-2878851 -Ref: Igawk Program-Footnote-3878981 -Node: Anagram Program879108 -Node: Signature Program882204 -Node: Programs Summary883456 -Node: Programs Exercises884714 -Ref: Programs Exercises-Footnote-1889030 -Node: Advanced Features889116 -Node: Nondecimal Data891610 -Node: Boolean Typed Values893240 -Node: Array Sorting895215 -Node: Controlling Array Traversal895944 -Ref: Controlling Array Traversal-Footnote-1904451 -Node: Array Sorting Functions904573 -Ref: Array Sorting Functions-Footnote-1910692 -Node: Two-way I/O910900 -Ref: Two-way I/O-Footnote-1918895 -Ref: Two-way I/O-Footnote-2919086 -Node: TCP/IP Networking919168 -Node: Profiling922348 -Node: Persistent Memory932058 -Ref: Persistent Memory-Footnote-1941668 -Node: Extension Philosophy941799 -Node: Advanced Features Summary943334 -Node: Internationalization945604 -Node: I18N and L10N947310 -Node: Explaining gettext948005 -Ref: Explaining gettext-Footnote-1954158 -Ref: Explaining gettext-Footnote-2954353 -Node: Programmer i18n954518 -Ref: Programmer i18n-Footnote-1959631 -Node: Translator i18n959680 -Node: String Extraction960516 -Ref: String Extraction-Footnote-1961694 -Node: Printf Ordering961792 -Ref: Printf Ordering-Footnote-1964654 -Node: I18N Portability964722 -Ref: I18N Portability-Footnote-1967296 -Node: I18N Example967367 -Ref: I18N Example-Footnote-1970767 -Ref: I18N Example-Footnote-2970843 -Node: Gawk I18N970960 -Node: I18N Summary971616 -Node: Debugger973017 -Node: Debugging974041 -Node: Debugging Concepts974490 -Node: Debugging Terms976316 -Node: Awk Debugging978929 -Ref: Awk Debugging-Footnote-1979906 -Node: Sample Debugging Session980046 -Node: Debugger Invocation980598 -Node: Finding The Bug982227 -Node: List of Debugger Commands988913 -Node: Breakpoint Control990290 -Node: Debugger Execution Control994122 -Node: Viewing And Changing Data997602 -Node: Execution Stack1001340 -Node: Debugger Info1003021 -Node: Miscellaneous Debugger Commands1007320 -Node: Readline Support1012573 -Node: Limitations1013519 -Node: Debugging Summary1016163 -Node: Namespaces1017466 -Node: Global Namespace1018593 -Node: Qualified Names1020038 -Node: Default Namespace1021073 -Node: Changing The Namespace1021848 -Node: Naming Rules1023542 -Node: Internal Name Management1025457 -Node: Namespace Example1026527 -Node: Namespace And Features1029110 -Node: Namespace Summary1030567 -Node: Arbitrary Precision Arithmetic1032080 -Node: Computer Arithmetic1033599 -Ref: table-numeric-ranges1037416 -Ref: table-floating-point-ranges1037914 -Ref: Computer Arithmetic-Footnote-11038573 -Node: Math Definitions1038632 -Ref: table-ieee-formats1041677 -Node: MPFR features1042251 -Node: MPFR On Parole1042704 -Ref: MPFR On Parole-Footnote-11043548 -Node: MPFR Intro1043707 -Node: FP Math Caution1045397 -Ref: FP Math Caution-Footnote-11046471 -Node: Inexactness of computations1046848 -Node: Inexact representation1047879 -Node: Comparing FP Values1049262 -Node: Errors accumulate1050520 -Node: Strange values1051987 -Ref: Strange values-Footnote-11054653 -Node: Getting Accuracy1054758 -Node: Try To Round1057495 -Node: Setting precision1058402 -Ref: table-predefined-precision-strings1059107 -Node: Setting the rounding mode1060992 -Ref: table-gawk-rounding-modes1061374 -Ref: Setting the rounding mode-Footnote-11065432 -Node: Arbitrary Precision Integers1065615 -Ref: Arbitrary Precision Integers-Footnote-11068827 -Node: Checking for MPFR1068983 -Node: POSIX Floating Point Problems1070473 -Ref: POSIX Floating Point Problems-Footnote-11075337 -Node: Floating point summary1075375 -Node: Dynamic Extensions1077639 -Node: Extension Intro1079238 -Node: Plugin License1080546 -Node: Extension Mechanism Outline1081359 -Ref: figure-load-extension1081810 -Ref: figure-register-new-function1083395 -Ref: figure-call-new-function1084505 -Node: Extension API Description1086629 -Node: Extension API Functions Introduction1088358 -Ref: table-api-std-headers1090256 -Node: General Data Types1094720 -Ref: General Data Types-Footnote-11103888 -Node: Memory Allocation Functions1104203 -Ref: Memory Allocation Functions-Footnote-11108928 -Node: Constructor Functions1109027 -Node: API Ownership of MPFR and GMP Values1112932 -Node: Registration Functions1114493 -Node: Extension Functions1115197 -Node: Exit Callback Functions1120773 -Node: Extension Version String1122092 -Node: Input Parsers1122787 -Node: Output Wrappers1137431 -Node: Two-way processors1142279 -Node: Printing Messages1144640 -Ref: Printing Messages-Footnote-11145854 -Node: Updating ERRNO1146009 -Node: Requesting Values1146808 -Ref: table-value-types-returned1147561 -Node: Accessing Parameters1148670 -Node: Symbol Table Access1149954 -Node: Symbol table by name1150470 -Ref: Symbol table by name-Footnote-11153681 -Node: Symbol table by cookie1153813 -Ref: Symbol table by cookie-Footnote-11158094 -Node: Cached values1158158 -Ref: Cached values-Footnote-11161802 -Node: Array Manipulation1161959 -Ref: Array Manipulation-Footnote-11163062 -Node: Array Data Types1163099 -Ref: Array Data Types-Footnote-11165921 -Node: Array Functions1166021 -Node: Flattening Arrays1171050 -Node: Creating Arrays1178102 -Node: Redirection API1182952 -Node: Extension API Variables1185973 -Node: Extension Versioning1186698 -Ref: gawk-api-version1187135 -Node: Extension GMP/MPFR Versioning1188923 -Node: Extension API Informational Variables1190629 -Node: Extension API Boilerplate1191790 -Node: Changes from API V11195926 -Node: Finding Extensions1197560 -Node: Extension Example1198135 -Node: Internal File Description1198959 -Node: Internal File Ops1203283 -Ref: Internal File Ops-Footnote-11214841 -Node: Using Internal File Ops1214989 -Ref: Using Internal File Ops-Footnote-11217420 -Node: Extension Samples1217698 -Node: Extension Sample File Functions1219267 -Node: Extension Sample Fnmatch1227405 -Node: Extension Sample Fork1229000 -Node: Extension Sample Inplace1230276 -Node: Extension Sample Ord1233948 -Node: Extension Sample Readdir1234824 -Ref: table-readdir-file-types1235721 -Node: Extension Sample Revout1236859 -Node: Extension Sample Rev2way1237456 -Node: Extension Sample Read write array1238208 -Node: Extension Sample Readfile1241482 -Node: Extension Sample Time1242613 -Node: Extension Sample API Tests1244903 -Node: gawkextlib1245411 -Node: Extension summary1248447 -Node: Extension Exercises1252305 -Node: Language History1253583 -Node: V7/SVR3.11255297 -Node: SVR41257647 -Node: POSIX1259179 -Node: BTL1260604 -Node: POSIX/GNU1261373 -Node: Feature History1267904 -Node: Common Extensions1287022 -Node: Ranges and Locales1288391 -Ref: Ranges and Locales-Footnote-11293192 -Ref: Ranges and Locales-Footnote-21293219 -Ref: Ranges and Locales-Footnote-31293458 -Node: Contributors1293681 -Node: History summary1299886 -Node: Installation1301332 -Node: Gawk Distribution1302296 -Node: Getting1302788 -Node: Extracting1303787 -Node: Distribution contents1305499 -Node: Unix Installation1313579 -Node: Quick Installation1314401 -Node: Compiling with MPFR1316947 -Node: Shell Startup Files1317653 -Node: Additional Configuration Options1318810 -Node: Configuration Philosophy1321197 -Node: Compiling from Git1323699 -Node: Building the Documentation1324258 -Node: Non-Unix Installation1325670 -Node: PC Installation1326146 -Node: PC Binary Installation1327019 -Node: PC Compiling1327924 -Node: PC Using1329102 -Node: Cygwin1332830 -Node: MSYS1334086 -Node: OpenVMS Installation1334718 -Node: OpenVMS Compilation1335399 -Ref: OpenVMS Compilation-Footnote-11336882 -Node: OpenVMS Dynamic Extensions1336944 -Node: OpenVMS Installation Details1338580 -Node: OpenVMS Running1341015 -Node: OpenVMS GNV1345152 -Node: Bugs1345907 -Node: Bug definition1346831 -Node: Bug address1350482 -Node: Usenet1354073 -Node: Performance bugs1355304 -Node: Asking for help1358322 -Node: Maintainers1360313 -Node: Other Versions1361340 -Node: Installation summary1370683 -Node: Notes1372067 -Node: Compatibility Mode1372877 -Node: Additions1373699 -Node: Accessing The Source1374644 -Node: Adding Code1376179 -Node: New Ports1383315 -Node: Derived Files1387825 -Ref: Derived Files-Footnote-11393672 -Ref: Derived Files-Footnote-21393707 -Ref: Derived Files-Footnote-31394324 -Node: Future Extensions1394438 -Node: Implementation Limitations1395110 -Node: Extension Design1396352 -Node: Old Extension Problems1397516 -Ref: Old Extension Problems-Footnote-11399092 -Node: Extension New Mechanism Goals1399153 -Ref: Extension New Mechanism Goals-Footnote-11402649 -Node: Extension Other Design Decisions1402850 -Node: Extension Future Growth1405049 -Node: Notes summary1405673 -Node: Basic Concepts1406886 -Node: Basic High Level1407571 -Ref: figure-general-flow1407853 -Ref: figure-process-flow1408560 -Ref: Basic High Level-Footnote-11411961 -Node: Basic Data Typing1412150 -Node: Glossary1415568 -Node: Copying1448690 -Node: GNU Free Documentation License1486451 -Node: Index1511774 +Node: Printf317049 +Node: Basic Printf317854 +Node: Control Letters319490 +Node: Format Modifiers324959 +Node: Printf Examples331245 +Node: Redirection333790 +Node: Special FD340864 +Ref: Special FD-Footnote-1344154 +Node: Special Files344240 +Node: Other Inherited Files344869 +Node: Special Network345934 +Node: Special Caveats346822 +Node: Close Files And Pipes347805 +Ref: Close Files And Pipes-Footnote-1353942 +Node: Close Return Value354098 +Ref: table-close-pipe-return-values355373 +Ref: Close Return Value-Footnote-1356207 +Node: Nonfatal356363 +Node: Output Summary358794 +Node: Output Exercises360080 +Node: Expressions360771 +Node: Values361973 +Node: Constants362651 +Node: Scalar Constants363348 +Ref: Scalar Constants-Footnote-1365923 +Node: Nondecimal-numbers366173 +Node: Regexp Constants369294 +Node: Using Constant Regexps369840 +Node: Standard Regexp Constants370486 +Node: Strong Regexp Constants373786 +Node: Variables377637 +Node: Using Variables378302 +Node: Assignment Options380282 +Node: Conversion382844 +Node: Strings And Numbers383376 +Ref: Strings And Numbers-Footnote-1386595 +Node: Locale influences conversions386704 +Ref: table-locale-affects389554 +Node: All Operators390197 +Node: Arithmetic Ops390838 +Node: Concatenation393668 +Ref: Concatenation-Footnote-1396618 +Node: Assignment Ops396741 +Ref: table-assign-ops401880 +Node: Increment Ops403262 +Node: Truth Values and Conditions406861 +Node: Truth Values407987 +Node: Typing and Comparison409078 +Node: Variable Typing409914 +Ref: Variable Typing-Footnote-1416576 +Ref: Variable Typing-Footnote-2416656 +Node: Comparison Operators416739 +Ref: table-relational-ops417166 +Node: POSIX String Comparison420852 +Ref: POSIX String Comparison-Footnote-1422611 +Ref: POSIX String Comparison-Footnote-2422754 +Node: Boolean Ops422838 +Ref: Boolean Ops-Footnote-1427531 +Node: Conditional Exp427627 +Node: Function Calls429413 +Node: Precedence433363 +Node: Locales437240 +Node: Expressions Summary438922 +Node: Patterns and Actions441585 +Node: Pattern Overview442727 +Node: Regexp Patterns444453 +Node: Expression Patterns444999 +Node: Ranges448908 +Node: BEGIN/END452086 +Node: Using BEGIN/END452899 +Ref: Using BEGIN/END-Footnote-1455809 +Node: I/O And BEGIN/END455919 +Node: BEGINFILE/ENDFILE458400 +Node: Empty461841 +Node: Using Shell Variables462158 +Node: Action Overview464496 +Node: Statements466931 +Node: If Statement468829 +Node: While Statement470398 +Node: Do Statement472486 +Node: For Statement473672 +Node: Switch Statement477029 +Node: Break Statement479580 +Node: Continue Statement481772 +Node: Next Statement483704 +Node: Nextfile Statement486201 +Node: Exit Statement489062 +Node: Built-in Variables491595 +Node: User-modified492774 +Node: Auto-set500985 +Ref: Auto-set-Footnote-1518838 +Ref: Auto-set-Footnote-2519056 +Node: ARGC and ARGV519112 +Node: Pattern Action Summary523551 +Node: Arrays526167 +Node: Array Basics527544 +Node: Array Intro528394 +Ref: figure-array-elements530410 +Ref: Array Intro-Footnote-1533279 +Node: Reference to Elements533411 +Node: Assigning Elements535933 +Node: Array Example536428 +Node: Scanning an Array538397 +Node: Controlling Scanning541494 +Ref: Controlling Scanning-Footnote-1548140 +Node: Numeric Array Subscripts548464 +Node: Uninitialized Subscripts550738 +Node: Delete552417 +Ref: Delete-Footnote-1555231 +Node: Multidimensional555288 +Node: Multiscanning558493 +Node: Arrays of Arrays560165 +Node: Arrays Summary565065 +Node: Functions567254 +Node: Built-in568314 +Node: Calling Built-in569503 +Node: Boolean Functions571550 +Node: Numeric Functions572120 +Ref: Numeric Functions-Footnote-1576313 +Ref: Numeric Functions-Footnote-2576997 +Ref: Numeric Functions-Footnote-3577049 +Node: String Functions577325 +Ref: String Functions-Footnote-1603155 +Ref: String Functions-Footnote-2603289 +Ref: String Functions-Footnote-3603549 +Node: Gory Details603636 +Ref: table-sub-escapes605543 +Ref: table-sub-proposed607189 +Ref: table-posix-sub608699 +Ref: table-gensub-escapes610387 +Ref: Gory Details-Footnote-1611321 +Node: I/O Functions611475 +Ref: table-system-return-values618162 +Ref: I/O Functions-Footnote-1620333 +Ref: I/O Functions-Footnote-2620481 +Node: Time Functions620601 +Ref: Time Functions-Footnote-1631757 +Ref: Time Functions-Footnote-2631833 +Ref: Time Functions-Footnote-3631995 +Ref: Time Functions-Footnote-4632106 +Ref: Time Functions-Footnote-5632224 +Ref: Time Functions-Footnote-6632459 +Node: Bitwise Functions632741 +Ref: table-bitwise-ops633343 +Ref: Bitwise Functions-Footnote-1639597 +Ref: Bitwise Functions-Footnote-2639776 +Node: Type Functions639973 +Node: I18N Functions643566 +Node: User-defined645309 +Node: Definition Syntax646129 +Ref: Definition Syntax-Footnote-1651957 +Node: Function Example652034 +Ref: Function Example-Footnote-1655013 +Node: Function Calling655035 +Node: Calling A Function655629 +Node: Variable Scope656599 +Node: Pass By Value/Reference659653 +Node: Function Caveats662385 +Ref: Function Caveats-Footnote-1664480 +Node: Return Statement664604 +Node: Dynamic Typing667659 +Node: Indirect Calls670060 +Node: Functions Summary681219 +Node: Library Functions683996 +Ref: Library Functions-Footnote-1687544 +Ref: Library Functions-Footnote-2687687 +Node: Library Names687862 +Ref: Library Names-Footnote-1691656 +Ref: Library Names-Footnote-2691883 +Node: General Functions691979 +Node: Strtonum Function693173 +Node: Assert Function696255 +Node: Round Function699707 +Node: Cliff Random Function701285 +Node: Ordinal Functions702318 +Ref: Ordinal Functions-Footnote-1705427 +Ref: Ordinal Functions-Footnote-2705679 +Node: Join Function705893 +Ref: Join Function-Footnote-1707696 +Node: Getlocaltime Function707900 +Node: Readfile Function711674 +Node: Shell Quoting713703 +Node: Isnumeric Function715159 +Node: Data File Management716571 +Node: Filetrans Function717203 +Node: Rewind Function721497 +Node: File Checking723476 +Ref: File Checking-Footnote-1724848 +Node: Empty Files725055 +Node: Ignoring Assigns727122 +Node: Getopt Function728696 +Ref: Getopt Function-Footnote-1744530 +Node: Passwd Functions744742 +Ref: Passwd Functions-Footnote-1753924 +Node: Group Functions754012 +Ref: Group Functions-Footnote-1762150 +Node: Walking Arrays762363 +Node: Library Functions Summary765411 +Node: Library Exercises766835 +Node: Sample Programs767322 +Node: Running Examples768104 +Node: Clones768856 +Node: Cut Program770128 +Node: Egrep Program780569 +Node: Id Program789886 +Node: Split Program800000 +Ref: Split Program-Footnote-1810235 +Node: Tee Program810422 +Node: Uniq Program813331 +Node: Wc Program821196 +Node: Bytes vs. Characters821591 +Node: Using extensions823193 +Node: wc program823973 +Node: Miscellaneous Programs828979 +Node: Dupword Program830208 +Node: Alarm Program832271 +Node: Translate Program837184 +Ref: Translate Program-Footnote-1841925 +Node: Labels Program842203 +Ref: Labels Program-Footnote-1845644 +Node: Word Sorting845736 +Node: History Sorting849930 +Node: Extract Program852205 +Node: Simple Sed860474 +Node: Igawk Program863690 +Ref: Igawk Program-Footnote-1878937 +Ref: Igawk Program-Footnote-2879143 +Ref: Igawk Program-Footnote-3879273 +Node: Anagram Program879400 +Node: Signature Program882496 +Node: Programs Summary883748 +Node: Programs Exercises885006 +Ref: Programs Exercises-Footnote-1889322 +Node: Advanced Features889408 +Node: Nondecimal Data891902 +Node: Boolean Typed Values893532 +Node: Array Sorting895507 +Node: Controlling Array Traversal896236 +Ref: Controlling Array Traversal-Footnote-1904743 +Node: Array Sorting Functions904865 +Ref: Array Sorting Functions-Footnote-1910984 +Node: Two-way I/O911192 +Ref: Two-way I/O-Footnote-1919187 +Ref: Two-way I/O-Footnote-2919378 +Node: TCP/IP Networking919460 +Node: Profiling922640 +Node: Persistent Memory932350 +Ref: Persistent Memory-Footnote-1941960 +Node: Extension Philosophy942091 +Node: Advanced Features Summary943626 +Node: Internationalization945896 +Node: I18N and L10N947602 +Node: Explaining gettext948297 +Ref: Explaining gettext-Footnote-1954450 +Ref: Explaining gettext-Footnote-2954645 +Node: Programmer i18n954810 +Ref: Programmer i18n-Footnote-1959923 +Node: Translator i18n959972 +Node: String Extraction960808 +Ref: String Extraction-Footnote-1961986 +Node: Printf Ordering962084 +Ref: Printf Ordering-Footnote-1964946 +Node: I18N Portability965014 +Ref: I18N Portability-Footnote-1967588 +Node: I18N Example967659 +Ref: I18N Example-Footnote-1971059 +Ref: I18N Example-Footnote-2971135 +Node: Gawk I18N971252 +Node: I18N Summary971908 +Node: Debugger973309 +Node: Debugging974333 +Node: Debugging Concepts974782 +Node: Debugging Terms976608 +Node: Awk Debugging979221 +Ref: Awk Debugging-Footnote-1980198 +Node: Sample Debugging Session980338 +Node: Debugger Invocation980890 +Node: Finding The Bug982519 +Node: List of Debugger Commands989205 +Node: Breakpoint Control990582 +Node: Debugger Execution Control994414 +Node: Viewing And Changing Data997894 +Node: Execution Stack1001632 +Node: Debugger Info1003313 +Node: Miscellaneous Debugger Commands1007612 +Node: Readline Support1012865 +Node: Limitations1013811 +Node: Debugging Summary1016455 +Node: Namespaces1017758 +Node: Global Namespace1018885 +Node: Qualified Names1020330 +Node: Default Namespace1021365 +Node: Changing The Namespace1022140 +Node: Naming Rules1023834 +Node: Internal Name Management1025749 +Node: Namespace Example1026819 +Node: Namespace And Features1029402 +Node: Namespace Summary1030859 +Node: Arbitrary Precision Arithmetic1032372 +Node: Computer Arithmetic1033891 +Ref: table-numeric-ranges1037708 +Ref: table-floating-point-ranges1038206 +Ref: Computer Arithmetic-Footnote-11038865 +Node: Math Definitions1038924 +Ref: table-ieee-formats1041969 +Node: MPFR features1042543 +Node: MPFR On Parole1042996 +Ref: MPFR On Parole-Footnote-11043840 +Node: MPFR Intro1043999 +Node: FP Math Caution1045689 +Ref: FP Math Caution-Footnote-11046763 +Node: Inexactness of computations1047140 +Node: Inexact representation1048171 +Node: Comparing FP Values1049554 +Node: Errors accumulate1050812 +Node: Strange values1052279 +Ref: Strange values-Footnote-11054945 +Node: Getting Accuracy1055050 +Node: Try To Round1057787 +Node: Setting precision1058694 +Ref: table-predefined-precision-strings1059399 +Node: Setting the rounding mode1061284 +Ref: table-gawk-rounding-modes1061666 +Ref: Setting the rounding mode-Footnote-11065724 +Node: Arbitrary Precision Integers1065907 +Ref: Arbitrary Precision Integers-Footnote-11069119 +Node: Checking for MPFR1069275 +Node: POSIX Floating Point Problems1070765 +Ref: POSIX Floating Point Problems-Footnote-11075629 +Node: Floating point summary1075667 +Node: Dynamic Extensions1077931 +Node: Extension Intro1079530 +Node: Plugin License1080838 +Node: Extension Mechanism Outline1081651 +Ref: figure-load-extension1082102 +Ref: figure-register-new-function1083687 +Ref: figure-call-new-function1084797 +Node: Extension API Description1086921 +Node: Extension API Functions Introduction1088650 +Ref: table-api-std-headers1090548 +Node: General Data Types1095012 +Ref: General Data Types-Footnote-11104180 +Node: Memory Allocation Functions1104495 +Ref: Memory Allocation Functions-Footnote-11109220 +Node: Constructor Functions1109319 +Node: API Ownership of MPFR and GMP Values1113224 +Node: Registration Functions1114785 +Node: Extension Functions1115489 +Node: Exit Callback Functions1121065 +Node: Extension Version String1122384 +Node: Input Parsers1123079 +Node: Output Wrappers1137723 +Node: Two-way processors1142571 +Node: Printing Messages1144932 +Ref: Printing Messages-Footnote-11146146 +Node: Updating ERRNO1146301 +Node: Requesting Values1147100 +Ref: table-value-types-returned1147853 +Node: Accessing Parameters1148962 +Node: Symbol Table Access1150246 +Node: Symbol table by name1150762 +Ref: Symbol table by name-Footnote-11153973 +Node: Symbol table by cookie1154105 +Ref: Symbol table by cookie-Footnote-11158386 +Node: Cached values1158450 +Ref: Cached values-Footnote-11162094 +Node: Array Manipulation1162251 +Ref: Array Manipulation-Footnote-11163354 +Node: Array Data Types1163391 +Ref: Array Data Types-Footnote-11166213 +Node: Array Functions1166313 +Node: Flattening Arrays1171342 +Node: Creating Arrays1178394 +Node: Redirection API1183244 +Node: Extension API Variables1186265 +Node: Extension Versioning1186990 +Ref: gawk-api-version1187427 +Node: Extension GMP/MPFR Versioning1189215 +Node: Extension API Informational Variables1190921 +Node: Extension API Boilerplate1192082 +Node: Changes from API V11196218 +Node: Finding Extensions1197852 +Node: Extension Example1198427 +Node: Internal File Description1199251 +Node: Internal File Ops1203575 +Ref: Internal File Ops-Footnote-11215133 +Node: Using Internal File Ops1215281 +Ref: Using Internal File Ops-Footnote-11217712 +Node: Extension Samples1217990 +Node: Extension Sample File Functions1219559 +Node: Extension Sample Fnmatch1227697 +Node: Extension Sample Fork1229292 +Node: Extension Sample Inplace1230568 +Node: Extension Sample Ord1234240 +Node: Extension Sample Readdir1235116 +Ref: table-readdir-file-types1236013 +Node: Extension Sample Revout1237151 +Node: Extension Sample Rev2way1237748 +Node: Extension Sample Read write array1238500 +Node: Extension Sample Readfile1241774 +Node: Extension Sample Time1242905 +Node: Extension Sample API Tests1245195 +Node: gawkextlib1245703 +Node: Extension summary1248739 +Node: Extension Exercises1252597 +Node: Language History1253875 +Node: V7/SVR3.11255589 +Node: SVR41257939 +Node: POSIX1259471 +Node: BTL1260896 +Node: POSIX/GNU1261665 +Node: Feature History1268196 +Node: Common Extensions1287314 +Node: Ranges and Locales1288683 +Ref: Ranges and Locales-Footnote-11293484 +Ref: Ranges and Locales-Footnote-21293511 +Ref: Ranges and Locales-Footnote-31293750 +Node: Contributors1293973 +Node: History summary1300178 +Node: Installation1301624 +Node: Gawk Distribution1302588 +Node: Getting1303080 +Node: Extracting1304079 +Node: Distribution contents1305791 +Node: Unix Installation1313871 +Node: Quick Installation1314693 +Node: Compiling with MPFR1317239 +Node: Shell Startup Files1317945 +Node: Additional Configuration Options1319102 +Node: Configuration Philosophy1321489 +Node: Compiling from Git1323991 +Node: Building the Documentation1324550 +Node: Non-Unix Installation1325962 +Node: PC Installation1326438 +Node: PC Binary Installation1327311 +Node: PC Compiling1328216 +Node: PC Using1329394 +Node: Cygwin1333122 +Node: MSYS1334378 +Node: OpenVMS Installation1335010 +Node: OpenVMS Compilation1335691 +Ref: OpenVMS Compilation-Footnote-11337174 +Node: OpenVMS Dynamic Extensions1337236 +Node: OpenVMS Installation Details1338872 +Node: OpenVMS Running1341307 +Node: OpenVMS GNV1345444 +Node: Bugs1346199 +Node: Bug definition1347123 +Node: Bug address1350774 +Node: Usenet1354365 +Node: Performance bugs1355596 +Node: Asking for help1358614 +Node: Maintainers1360605 +Node: Other Versions1361632 +Node: Installation summary1370975 +Node: Notes1372359 +Node: Compatibility Mode1373169 +Node: Additions1373991 +Node: Accessing The Source1374936 +Node: Adding Code1376471 +Node: New Ports1383607 +Node: Derived Files1388117 +Ref: Derived Files-Footnote-11393964 +Ref: Derived Files-Footnote-21393999 +Ref: Derived Files-Footnote-31394616 +Node: Future Extensions1394730 +Node: Implementation Limitations1395402 +Node: Extension Design1396644 +Node: Old Extension Problems1397808 +Ref: Old Extension Problems-Footnote-11399384 +Node: Extension New Mechanism Goals1399445 +Ref: Extension New Mechanism Goals-Footnote-11402941 +Node: Extension Other Design Decisions1403142 +Node: Extension Future Growth1405341 +Node: Notes summary1405965 +Node: Basic Concepts1407178 +Node: Basic High Level1407863 +Ref: figure-general-flow1408145 +Ref: figure-process-flow1408852 +Ref: Basic High Level-Footnote-11412253 +Node: Basic Data Typing1412442 +Node: Glossary1415860 +Node: Copying1448982 +Node: GNU Free Documentation License1486743 +Node: Index1512066 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 344ea62e..75eaf419 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -10208,6 +10208,12 @@ $ @kbd{awk 'BEGIN @{} @print{} 17 18 @end example +More detail on how @command{awk} converts numeric values into +strings is provided in @ref{Strings And Numbers}. In particular, for +@code{print}, @command{awk} uses the value of @code{OFMT} instead of +that of @code{CONVFMT}, but otherwise behaves exactly the same +as described in that @value{SECTION}. + @noindent @cindex dark corner @subentry @code{OFMT} variable @cindex POSIX @command{awk} @subentry @code{OFMT} variable and diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 06279a08..6f8ad60e 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -9677,6 +9677,12 @@ $ @kbd{awk 'BEGIN @{} @print{} 17 18 @end example +More detail on how @command{awk} converts numeric values into +strings is provided in @ref{Strings And Numbers}. In particular, for +@code{print}, @command{awk} uses the value of @code{OFMT} instead of +that of @code{CONVFMT}, but otherwise behaves exactly the same +as described in that @value{SECTION}. + @noindent @cindex dark corner @subentry @code{OFMT} variable @cindex POSIX @command{awk} @subentry @code{OFMT} variable and |