diff options
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/gawk.info | 456 | ||||
| -rw-r--r-- | doc/gawk.texi | 4 | ||||
| -rw-r--r-- | doc/gawktexi.in | 4 |
4 files changed, 237 insertions, 232 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 0f2a5ead..4e801a46 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2013-10-11 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in (Conversion, Printf Ordering): Better wording for + descriptions of CONVFMT. Thanks to Hermann Peifer. + 2013-09-29 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in (Other Versions): Updated info on MKS awk and diff --git a/doc/gawk.info b/doc/gawk.info index 1b4a66e9..e8ea41db 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -7097,7 +7097,7 @@ controlled by the `awk' built-in variable `CONVFMT' (*note Built-in Variables::). Numbers are converted using the `sprintf()' function with `CONVFMT' as the format specifier (*note String Functions::). - `CONVFMT''s default value is `"%.6g"', which prints a value with at + `CONVFMT''s default value is `"%.6g"', which creates a value with at most six significant digits. For some applications, you might want to change it to specify more precision. On most modern machines, 17 digits is usually enough to capture a floating-point number's value @@ -20580,7 +20580,7 @@ automatic conversion (via `CONVFMT') and from printing (via `OFMT'). what the default string representations show. `CONVFMT''s default value is `"%.6g"', which yields a value with at -least six significant digits. For some applications, you might want to +most six significant digits. For some applications, you might want to change it to specify more precision. On most modern machines, most of the time, 17 digits is enough to capture a floating-point number's value exactly.(1) @@ -32307,232 +32307,232 @@ Node: Variables303836 Node: Using Variables304491 Node: Assignment Options306215 Node: Conversion308087 -Ref: table-locale-affects313587 -Ref: Conversion-Footnote-1314211 -Node: All Operators314320 -Node: Arithmetic Ops314950 -Node: Concatenation317455 -Ref: Concatenation-Footnote-1320248 -Node: Assignment Ops320368 -Ref: table-assign-ops325356 -Node: Increment Ops326687 -Node: Truth Values and Conditions330122 -Node: Truth Values331205 -Node: Typing and Comparison332254 -Node: Variable Typing333043 -Ref: Variable Typing-Footnote-1336940 -Node: Comparison Operators337062 -Ref: table-relational-ops337472 -Node: POSIX String Comparison341021 -Ref: POSIX String Comparison-Footnote-1341977 -Node: Boolean Ops342115 -Ref: Boolean Ops-Footnote-1346193 -Node: Conditional Exp346284 -Node: Function Calls348016 -Node: Precedence351610 -Node: Locales355279 -Node: Patterns and Actions356368 -Node: Pattern Overview357422 -Node: Regexp Patterns359091 -Node: Expression Patterns359634 -Node: Ranges363319 -Node: BEGIN/END366285 -Node: Using BEGIN/END367047 -Ref: Using BEGIN/END-Footnote-1369778 -Node: I/O And BEGIN/END369884 -Node: BEGINFILE/ENDFILE372166 -Node: Empty375080 -Node: Using Shell Variables375396 -Node: Action Overview377681 -Node: Statements380038 -Node: If Statement381892 -Node: While Statement383391 -Node: Do Statement385435 -Node: For Statement386591 -Node: Switch Statement389743 -Node: Break Statement391840 -Node: Continue Statement393830 -Node: Next Statement395623 -Node: Nextfile Statement398013 -Node: Exit Statement400656 -Node: Built-in Variables403072 -Node: User-modified404167 -Ref: User-modified-Footnote-1412527 -Node: Auto-set412589 -Ref: Auto-set-Footnote-1426077 -Ref: Auto-set-Footnote-2426282 -Node: ARGC and ARGV426338 -Node: Arrays430189 -Node: Array Basics431694 -Node: Array Intro432520 -Node: Reference to Elements436838 -Node: Assigning Elements439108 -Node: Array Example439599 -Node: Scanning an Array441331 -Node: Controlling Scanning443645 -Ref: Controlling Scanning-Footnote-1448568 -Node: Delete448884 -Ref: Delete-Footnote-1451649 -Node: Numeric Array Subscripts451706 -Node: Uninitialized Subscripts453889 -Node: Multi-dimensional455517 -Node: Multi-scanning458611 -Node: Arrays of Arrays460202 -Node: Functions464843 -Node: Built-in465662 -Node: Calling Built-in466740 -Node: Numeric Functions468728 -Ref: Numeric Functions-Footnote-1472560 -Ref: Numeric Functions-Footnote-2472917 -Ref: Numeric Functions-Footnote-3472965 -Node: String Functions473234 -Ref: String Functions-Footnote-1496792 -Ref: String Functions-Footnote-2496921 -Ref: String Functions-Footnote-3497169 -Node: Gory Details497256 -Ref: table-sub-escapes498935 -Ref: table-sub-posix-92500289 -Ref: table-sub-proposed501640 -Ref: table-posix-sub502994 -Ref: table-gensub-escapes504539 -Ref: Gory Details-Footnote-1505715 -Ref: Gory Details-Footnote-2505766 -Node: I/O Functions505917 -Ref: I/O Functions-Footnote-1512902 -Node: Time Functions513049 -Ref: Time Functions-Footnote-1523982 -Ref: Time Functions-Footnote-2524050 -Ref: Time Functions-Footnote-3524208 -Ref: Time Functions-Footnote-4524319 -Ref: Time Functions-Footnote-5524431 -Ref: Time Functions-Footnote-6524658 -Node: Bitwise Functions524924 -Ref: table-bitwise-ops525482 -Ref: Bitwise Functions-Footnote-1529703 -Node: Type Functions529887 -Node: I18N Functions531038 -Node: User-defined532665 -Node: Definition Syntax533469 -Ref: Definition Syntax-Footnote-1538379 -Node: Function Example538448 -Node: Function Caveats541042 -Node: Calling A Function541463 -Node: Variable Scope542578 -Node: Pass By Value/Reference545541 -Node: Return Statement549049 -Node: Dynamic Typing552030 -Node: Indirect Calls552961 -Node: Library Functions562646 -Ref: Library Functions-Footnote-1566159 -Ref: Library Functions-Footnote-2566302 -Node: Library Names566473 -Ref: Library Names-Footnote-1569944 -Ref: Library Names-Footnote-2570164 -Node: General Functions570250 -Node: Strtonum Function571278 -Node: Assert Function574208 -Node: Round Function577534 -Node: Cliff Random Function579077 -Node: Ordinal Functions580093 -Ref: Ordinal Functions-Footnote-1583163 -Ref: Ordinal Functions-Footnote-2583415 -Node: Join Function583624 -Ref: Join Function-Footnote-1585395 -Node: Getlocaltime Function585595 -Node: Readfile Function589336 -Node: Data File Management591175 -Node: Filetrans Function591807 -Node: Rewind Function595876 -Node: File Checking597263 -Node: Empty Files598357 -Node: Ignoring Assigns600587 -Node: Getopt Function602140 -Ref: Getopt Function-Footnote-1613444 -Node: Passwd Functions613647 -Ref: Passwd Functions-Footnote-1622622 -Node: Group Functions622710 -Node: Walking Arrays630794 -Node: Sample Programs632931 -Node: Running Examples633605 -Node: Clones634333 -Node: Cut Program635557 -Node: Egrep Program645402 -Ref: Egrep Program-Footnote-1653175 -Node: Id Program653285 -Node: Split Program656901 -Ref: Split Program-Footnote-1660420 -Node: Tee Program660548 -Node: Uniq Program663351 -Node: Wc Program670780 -Ref: Wc Program-Footnote-1675046 -Ref: Wc Program-Footnote-2675246 -Node: Miscellaneous Programs675338 -Node: Dupword Program676526 -Node: Alarm Program678557 -Node: Translate Program683306 -Ref: Translate Program-Footnote-1687693 -Ref: Translate Program-Footnote-2687921 -Node: Labels Program688055 -Ref: Labels Program-Footnote-1691426 -Node: Word Sorting691510 -Node: History Sorting695394 -Node: Extract Program697233 -Ref: Extract Program-Footnote-1704734 -Node: Simple Sed704862 -Node: Igawk Program707924 -Ref: Igawk Program-Footnote-1723081 -Ref: Igawk Program-Footnote-2723282 -Node: Anagram Program723420 -Node: Signature Program726488 -Node: Advanced Features727588 -Node: Nondecimal Data729470 -Node: Array Sorting731053 -Node: Controlling Array Traversal731750 -Node: Array Sorting Functions739988 -Ref: Array Sorting Functions-Footnote-1743662 -Ref: Array Sorting Functions-Footnote-2743755 -Node: Two-way I/O743949 -Ref: Two-way I/O-Footnote-1749381 -Node: TCP/IP Networking749451 -Node: Profiling752295 -Node: Internationalization759792 -Node: I18N and L10N761217 -Node: Explaining gettext761903 -Ref: Explaining gettext-Footnote-1766971 -Ref: Explaining gettext-Footnote-2767155 -Node: Programmer i18n767320 -Node: Translator i18n771522 -Node: String Extraction772315 -Ref: String Extraction-Footnote-1773276 -Node: Printf Ordering773362 -Ref: Printf Ordering-Footnote-1776146 -Node: I18N Portability776210 -Ref: I18N Portability-Footnote-1778659 -Node: I18N Example778722 -Ref: I18N Example-Footnote-1781360 -Node: Gawk I18N781432 -Node: Debugger782053 -Node: Debugging783024 -Node: Debugging Concepts783457 -Node: Debugging Terms785313 -Node: Awk Debugging787910 -Node: Sample Debugging Session788802 -Node: Debugger Invocation789322 -Node: Finding The Bug790654 -Node: List of Debugger Commands797142 -Node: Breakpoint Control798476 -Node: Debugger Execution Control802140 -Node: Viewing And Changing Data805500 -Node: Execution Stack808856 -Node: Debugger Info810323 -Node: Miscellaneous Debugger Commands814305 -Node: Readline Support819481 -Node: Limitations820312 -Node: Arbitrary Precision Arithmetic822564 -Ref: Arbitrary Precision Arithmetic-Footnote-1824215 -Node: General Arithmetic824363 -Node: Floating Point Issues826083 -Node: String Conversion Precision826964 +Ref: table-locale-affects313588 +Ref: Conversion-Footnote-1314212 +Node: All Operators314321 +Node: Arithmetic Ops314951 +Node: Concatenation317456 +Ref: Concatenation-Footnote-1320249 +Node: Assignment Ops320369 +Ref: table-assign-ops325357 +Node: Increment Ops326688 +Node: Truth Values and Conditions330123 +Node: Truth Values331206 +Node: Typing and Comparison332255 +Node: Variable Typing333044 +Ref: Variable Typing-Footnote-1336941 +Node: Comparison Operators337063 +Ref: table-relational-ops337473 +Node: POSIX String Comparison341022 +Ref: POSIX String Comparison-Footnote-1341978 +Node: Boolean Ops342116 +Ref: Boolean Ops-Footnote-1346194 +Node: Conditional Exp346285 +Node: Function Calls348017 +Node: Precedence351611 +Node: Locales355280 +Node: Patterns and Actions356369 +Node: Pattern Overview357423 +Node: Regexp Patterns359092 +Node: Expression Patterns359635 +Node: Ranges363320 +Node: BEGIN/END366286 +Node: Using BEGIN/END367048 +Ref: Using BEGIN/END-Footnote-1369779 +Node: I/O And BEGIN/END369885 +Node: BEGINFILE/ENDFILE372167 +Node: Empty375081 +Node: Using Shell Variables375397 +Node: Action Overview377682 +Node: Statements380039 +Node: If Statement381893 +Node: While Statement383392 +Node: Do Statement385436 +Node: For Statement386592 +Node: Switch Statement389744 +Node: Break Statement391841 +Node: Continue Statement393831 +Node: Next Statement395624 +Node: Nextfile Statement398014 +Node: Exit Statement400657 +Node: Built-in Variables403073 +Node: User-modified404168 +Ref: User-modified-Footnote-1412528 +Node: Auto-set412590 +Ref: Auto-set-Footnote-1426078 +Ref: Auto-set-Footnote-2426283 +Node: ARGC and ARGV426339 +Node: Arrays430190 +Node: Array Basics431695 +Node: Array Intro432521 +Node: Reference to Elements436839 +Node: Assigning Elements439109 +Node: Array Example439600 +Node: Scanning an Array441332 +Node: Controlling Scanning443646 +Ref: Controlling Scanning-Footnote-1448569 +Node: Delete448885 +Ref: Delete-Footnote-1451650 +Node: Numeric Array Subscripts451707 +Node: Uninitialized Subscripts453890 +Node: Multi-dimensional455518 +Node: Multi-scanning458612 +Node: Arrays of Arrays460203 +Node: Functions464844 +Node: Built-in465663 +Node: Calling Built-in466741 +Node: Numeric Functions468729 +Ref: Numeric Functions-Footnote-1472561 +Ref: Numeric Functions-Footnote-2472918 +Ref: Numeric Functions-Footnote-3472966 +Node: String Functions473235 +Ref: String Functions-Footnote-1496793 +Ref: String Functions-Footnote-2496922 +Ref: String Functions-Footnote-3497170 +Node: Gory Details497257 +Ref: table-sub-escapes498936 +Ref: table-sub-posix-92500290 +Ref: table-sub-proposed501641 +Ref: table-posix-sub502995 +Ref: table-gensub-escapes504540 +Ref: Gory Details-Footnote-1505716 +Ref: Gory Details-Footnote-2505767 +Node: I/O Functions505918 +Ref: I/O Functions-Footnote-1512903 +Node: Time Functions513050 +Ref: Time Functions-Footnote-1523983 +Ref: Time Functions-Footnote-2524051 +Ref: Time Functions-Footnote-3524209 +Ref: Time Functions-Footnote-4524320 +Ref: Time Functions-Footnote-5524432 +Ref: Time Functions-Footnote-6524659 +Node: Bitwise Functions524925 +Ref: table-bitwise-ops525483 +Ref: Bitwise Functions-Footnote-1529704 +Node: Type Functions529888 +Node: I18N Functions531039 +Node: User-defined532666 +Node: Definition Syntax533470 +Ref: Definition Syntax-Footnote-1538380 +Node: Function Example538449 +Node: Function Caveats541043 +Node: Calling A Function541464 +Node: Variable Scope542579 +Node: Pass By Value/Reference545542 +Node: Return Statement549050 +Node: Dynamic Typing552031 +Node: Indirect Calls552962 +Node: Library Functions562647 +Ref: Library Functions-Footnote-1566160 +Ref: Library Functions-Footnote-2566303 +Node: Library Names566474 +Ref: Library Names-Footnote-1569945 +Ref: Library Names-Footnote-2570165 +Node: General Functions570251 +Node: Strtonum Function571279 +Node: Assert Function574209 +Node: Round Function577535 +Node: Cliff Random Function579078 +Node: Ordinal Functions580094 +Ref: Ordinal Functions-Footnote-1583164 +Ref: Ordinal Functions-Footnote-2583416 +Node: Join Function583625 +Ref: Join Function-Footnote-1585396 +Node: Getlocaltime Function585596 +Node: Readfile Function589337 +Node: Data File Management591176 +Node: Filetrans Function591808 +Node: Rewind Function595877 +Node: File Checking597264 +Node: Empty Files598358 +Node: Ignoring Assigns600588 +Node: Getopt Function602141 +Ref: Getopt Function-Footnote-1613445 +Node: Passwd Functions613648 +Ref: Passwd Functions-Footnote-1622623 +Node: Group Functions622711 +Node: Walking Arrays630795 +Node: Sample Programs632932 +Node: Running Examples633606 +Node: Clones634334 +Node: Cut Program635558 +Node: Egrep Program645403 +Ref: Egrep Program-Footnote-1653176 +Node: Id Program653286 +Node: Split Program656902 +Ref: Split Program-Footnote-1660421 +Node: Tee Program660549 +Node: Uniq Program663352 +Node: Wc Program670781 +Ref: Wc Program-Footnote-1675047 +Ref: Wc Program-Footnote-2675247 +Node: Miscellaneous Programs675339 +Node: Dupword Program676527 +Node: Alarm Program678558 +Node: Translate Program683307 +Ref: Translate Program-Footnote-1687694 +Ref: Translate Program-Footnote-2687922 +Node: Labels Program688056 +Ref: Labels Program-Footnote-1691427 +Node: Word Sorting691511 +Node: History Sorting695395 +Node: Extract Program697234 +Ref: Extract Program-Footnote-1704735 +Node: Simple Sed704863 +Node: Igawk Program707925 +Ref: Igawk Program-Footnote-1723082 +Ref: Igawk Program-Footnote-2723283 +Node: Anagram Program723421 +Node: Signature Program726489 +Node: Advanced Features727589 +Node: Nondecimal Data729471 +Node: Array Sorting731054 +Node: Controlling Array Traversal731751 +Node: Array Sorting Functions739989 +Ref: Array Sorting Functions-Footnote-1743663 +Ref: Array Sorting Functions-Footnote-2743756 +Node: Two-way I/O743950 +Ref: Two-way I/O-Footnote-1749382 +Node: TCP/IP Networking749452 +Node: Profiling752296 +Node: Internationalization759793 +Node: I18N and L10N761218 +Node: Explaining gettext761904 +Ref: Explaining gettext-Footnote-1766972 +Ref: Explaining gettext-Footnote-2767156 +Node: Programmer i18n767321 +Node: Translator i18n771523 +Node: String Extraction772316 +Ref: String Extraction-Footnote-1773277 +Node: Printf Ordering773363 +Ref: Printf Ordering-Footnote-1776147 +Node: I18N Portability776211 +Ref: I18N Portability-Footnote-1778660 +Node: I18N Example778723 +Ref: I18N Example-Footnote-1781361 +Node: Gawk I18N781433 +Node: Debugger782054 +Node: Debugging783025 +Node: Debugging Concepts783458 +Node: Debugging Terms785314 +Node: Awk Debugging787911 +Node: Sample Debugging Session788803 +Node: Debugger Invocation789323 +Node: Finding The Bug790655 +Node: List of Debugger Commands797143 +Node: Breakpoint Control798477 +Node: Debugger Execution Control802141 +Node: Viewing And Changing Data805501 +Node: Execution Stack808857 +Node: Debugger Info810324 +Node: Miscellaneous Debugger Commands814306 +Node: Readline Support819482 +Node: Limitations820313 +Node: Arbitrary Precision Arithmetic822565 +Ref: Arbitrary Precision Arithmetic-Footnote-1824216 +Node: General Arithmetic824364 +Node: Floating Point Issues826084 +Node: String Conversion Precision826965 Ref: String Conversion Precision-Footnote-1828670 Node: Unexpected Results828779 Node: POSIX Floating Point Problems830932 diff --git a/doc/gawk.texi b/doc/gawk.texi index 35e2169a..1c09a5bc 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -10025,7 +10025,7 @@ with @code{CONVFMT} as the format specifier (@pxref{String Functions}). -@code{CONVFMT}'s default value is @code{"%.6g"}, which prints a value with +@code{CONVFMT}'s default value is @code{"%.6g"}, which creates a value with at most six significant digits. For some applications, you might want to change it to specify more precision. On most modern machines, @@ -28211,7 +28211,7 @@ This makes it clear that the full numeric value is different from what the default string representations show. @code{CONVFMT}'s default value is @code{"%.6g"}, which yields a value with -at least six significant digits. For some applications, you might want to +at most six significant digits. For some applications, you might want to change it to specify more precision. On most modern machines, most of the time, 17 digits is enough to capture a floating-point number's diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 6fd9681a..1083d653 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -9522,7 +9522,7 @@ with @code{CONVFMT} as the format specifier (@pxref{String Functions}). -@code{CONVFMT}'s default value is @code{"%.6g"}, which prints a value with +@code{CONVFMT}'s default value is @code{"%.6g"}, which creates a value with at most six significant digits. For some applications, you might want to change it to specify more precision. On most modern machines, @@ -27360,7 +27360,7 @@ This makes it clear that the full numeric value is different from what the default string representations show. @code{CONVFMT}'s default value is @code{"%.6g"}, which yields a value with -at least six significant digits. For some applications, you might want to +at most six significant digits. For some applications, you might want to change it to specify more precision. On most modern machines, most of the time, 17 digits is enough to capture a floating-point number's |