diff options
Diffstat (limited to 'doc')
| -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 54ccdd6b..2ee94503 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 b5120148..5b3e4ac7 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 @@ -20571,7 +20571,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) @@ -32298,232 +32298,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-1425667 -Ref: Auto-set-Footnote-2425872 -Node: ARGC and ARGV425928 -Node: Arrays429779 -Node: Array Basics431284 -Node: Array Intro432110 -Node: Reference to Elements436428 -Node: Assigning Elements438698 -Node: Array Example439189 -Node: Scanning an Array440921 -Node: Controlling Scanning443235 -Ref: Controlling Scanning-Footnote-1448158 -Node: Delete448474 -Ref: Delete-Footnote-1451239 -Node: Numeric Array Subscripts451296 -Node: Uninitialized Subscripts453479 -Node: Multi-dimensional455107 -Node: Multi-scanning458201 -Node: Arrays of Arrays459792 -Node: Functions464433 -Node: Built-in465252 -Node: Calling Built-in466330 -Node: Numeric Functions468318 -Ref: Numeric Functions-Footnote-1472150 -Ref: Numeric Functions-Footnote-2472507 -Ref: Numeric Functions-Footnote-3472555 -Node: String Functions472824 -Ref: String Functions-Footnote-1496382 -Ref: String Functions-Footnote-2496511 -Ref: String Functions-Footnote-3496759 -Node: Gory Details496846 -Ref: table-sub-escapes498525 -Ref: table-sub-posix-92499879 -Ref: table-sub-proposed501230 -Ref: table-posix-sub502584 -Ref: table-gensub-escapes504129 -Ref: Gory Details-Footnote-1505305 -Ref: Gory Details-Footnote-2505356 -Node: I/O Functions505507 -Ref: I/O Functions-Footnote-1512492 -Node: Time Functions512639 -Ref: Time Functions-Footnote-1523572 -Ref: Time Functions-Footnote-2523640 -Ref: Time Functions-Footnote-3523798 -Ref: Time Functions-Footnote-4523909 -Ref: Time Functions-Footnote-5524021 -Ref: Time Functions-Footnote-6524248 -Node: Bitwise Functions524514 -Ref: table-bitwise-ops525072 -Ref: Bitwise Functions-Footnote-1529293 -Node: Type Functions529477 -Node: I18N Functions530628 -Node: User-defined532255 -Node: Definition Syntax533059 -Ref: Definition Syntax-Footnote-1537969 -Node: Function Example538038 -Node: Function Caveats540632 -Node: Calling A Function541053 -Node: Variable Scope542168 -Node: Pass By Value/Reference545131 -Node: Return Statement548639 -Node: Dynamic Typing551620 -Node: Indirect Calls552551 -Node: Library Functions562236 -Ref: Library Functions-Footnote-1565749 -Ref: Library Functions-Footnote-2565892 -Node: Library Names566063 -Ref: Library Names-Footnote-1569534 -Ref: Library Names-Footnote-2569754 -Node: General Functions569840 -Node: Strtonum Function570868 -Node: Assert Function573798 -Node: Round Function577124 -Node: Cliff Random Function578667 -Node: Ordinal Functions579683 -Ref: Ordinal Functions-Footnote-1582753 -Ref: Ordinal Functions-Footnote-2583005 -Node: Join Function583214 -Ref: Join Function-Footnote-1584985 -Node: Getlocaltime Function585185 -Node: Readfile Function588926 -Node: Data File Management590765 -Node: Filetrans Function591397 -Node: Rewind Function595466 -Node: File Checking596853 -Node: Empty Files597947 -Node: Ignoring Assigns600177 -Node: Getopt Function601730 -Ref: Getopt Function-Footnote-1613034 -Node: Passwd Functions613237 -Ref: Passwd Functions-Footnote-1622212 -Node: Group Functions622300 -Node: Walking Arrays630384 -Node: Sample Programs632521 -Node: Running Examples633195 -Node: Clones633923 -Node: Cut Program635147 -Node: Egrep Program644992 -Ref: Egrep Program-Footnote-1652765 -Node: Id Program652875 -Node: Split Program656491 -Ref: Split Program-Footnote-1660010 -Node: Tee Program660138 -Node: Uniq Program662941 -Node: Wc Program670370 -Ref: Wc Program-Footnote-1674636 -Ref: Wc Program-Footnote-2674836 -Node: Miscellaneous Programs674928 -Node: Dupword Program676116 -Node: Alarm Program678147 -Node: Translate Program682896 -Ref: Translate Program-Footnote-1687283 -Ref: Translate Program-Footnote-2687511 -Node: Labels Program687645 -Ref: Labels Program-Footnote-1691016 -Node: Word Sorting691100 -Node: History Sorting694984 -Node: Extract Program696823 -Ref: Extract Program-Footnote-1704324 -Node: Simple Sed704452 -Node: Igawk Program707514 -Ref: Igawk Program-Footnote-1722671 -Ref: Igawk Program-Footnote-2722872 -Node: Anagram Program723010 -Node: Signature Program726078 -Node: Advanced Features727178 -Node: Nondecimal Data729060 -Node: Array Sorting730643 -Node: Controlling Array Traversal731340 -Node: Array Sorting Functions739578 -Ref: Array Sorting Functions-Footnote-1743252 -Ref: Array Sorting Functions-Footnote-2743345 -Node: Two-way I/O743539 -Ref: Two-way I/O-Footnote-1748971 -Node: TCP/IP Networking749041 -Node: Profiling751885 -Node: Internationalization759382 -Node: I18N and L10N760807 -Node: Explaining gettext761493 -Ref: Explaining gettext-Footnote-1766561 -Ref: Explaining gettext-Footnote-2766745 -Node: Programmer i18n766910 -Node: Translator i18n771112 -Node: String Extraction771905 -Ref: String Extraction-Footnote-1772866 -Node: Printf Ordering772952 -Ref: Printf Ordering-Footnote-1775736 -Node: I18N Portability775800 -Ref: I18N Portability-Footnote-1778249 -Node: I18N Example778312 -Ref: I18N Example-Footnote-1780950 -Node: Gawk I18N781022 -Node: Debugger781643 -Node: Debugging782614 -Node: Debugging Concepts783047 -Node: Debugging Terms784903 -Node: Awk Debugging787500 -Node: Sample Debugging Session788392 -Node: Debugger Invocation788912 -Node: Finding The Bug790244 -Node: List of Debugger Commands796732 -Node: Breakpoint Control798066 -Node: Debugger Execution Control801730 -Node: Viewing And Changing Data805090 -Node: Execution Stack808446 -Node: Debugger Info809913 -Node: Miscellaneous Debugger Commands813895 -Node: Readline Support819071 -Node: Limitations819902 -Node: Arbitrary Precision Arithmetic822154 -Ref: Arbitrary Precision Arithmetic-Footnote-1823805 -Node: General Arithmetic823953 -Node: Floating Point Issues825673 -Node: String Conversion Precision826554 +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-1425668 +Ref: Auto-set-Footnote-2425873 +Node: ARGC and ARGV425929 +Node: Arrays429780 +Node: Array Basics431285 +Node: Array Intro432111 +Node: Reference to Elements436429 +Node: Assigning Elements438699 +Node: Array Example439190 +Node: Scanning an Array440922 +Node: Controlling Scanning443236 +Ref: Controlling Scanning-Footnote-1448159 +Node: Delete448475 +Ref: Delete-Footnote-1451240 +Node: Numeric Array Subscripts451297 +Node: Uninitialized Subscripts453480 +Node: Multi-dimensional455108 +Node: Multi-scanning458202 +Node: Arrays of Arrays459793 +Node: Functions464434 +Node: Built-in465253 +Node: Calling Built-in466331 +Node: Numeric Functions468319 +Ref: Numeric Functions-Footnote-1472151 +Ref: Numeric Functions-Footnote-2472508 +Ref: Numeric Functions-Footnote-3472556 +Node: String Functions472825 +Ref: String Functions-Footnote-1496383 +Ref: String Functions-Footnote-2496512 +Ref: String Functions-Footnote-3496760 +Node: Gory Details496847 +Ref: table-sub-escapes498526 +Ref: table-sub-posix-92499880 +Ref: table-sub-proposed501231 +Ref: table-posix-sub502585 +Ref: table-gensub-escapes504130 +Ref: Gory Details-Footnote-1505306 +Ref: Gory Details-Footnote-2505357 +Node: I/O Functions505508 +Ref: I/O Functions-Footnote-1512493 +Node: Time Functions512640 +Ref: Time Functions-Footnote-1523573 +Ref: Time Functions-Footnote-2523641 +Ref: Time Functions-Footnote-3523799 +Ref: Time Functions-Footnote-4523910 +Ref: Time Functions-Footnote-5524022 +Ref: Time Functions-Footnote-6524249 +Node: Bitwise Functions524515 +Ref: table-bitwise-ops525073 +Ref: Bitwise Functions-Footnote-1529294 +Node: Type Functions529478 +Node: I18N Functions530629 +Node: User-defined532256 +Node: Definition Syntax533060 +Ref: Definition Syntax-Footnote-1537970 +Node: Function Example538039 +Node: Function Caveats540633 +Node: Calling A Function541054 +Node: Variable Scope542169 +Node: Pass By Value/Reference545132 +Node: Return Statement548640 +Node: Dynamic Typing551621 +Node: Indirect Calls552552 +Node: Library Functions562237 +Ref: Library Functions-Footnote-1565750 +Ref: Library Functions-Footnote-2565893 +Node: Library Names566064 +Ref: Library Names-Footnote-1569535 +Ref: Library Names-Footnote-2569755 +Node: General Functions569841 +Node: Strtonum Function570869 +Node: Assert Function573799 +Node: Round Function577125 +Node: Cliff Random Function578668 +Node: Ordinal Functions579684 +Ref: Ordinal Functions-Footnote-1582754 +Ref: Ordinal Functions-Footnote-2583006 +Node: Join Function583215 +Ref: Join Function-Footnote-1584986 +Node: Getlocaltime Function585186 +Node: Readfile Function588927 +Node: Data File Management590766 +Node: Filetrans Function591398 +Node: Rewind Function595467 +Node: File Checking596854 +Node: Empty Files597948 +Node: Ignoring Assigns600178 +Node: Getopt Function601731 +Ref: Getopt Function-Footnote-1613035 +Node: Passwd Functions613238 +Ref: Passwd Functions-Footnote-1622213 +Node: Group Functions622301 +Node: Walking Arrays630385 +Node: Sample Programs632522 +Node: Running Examples633196 +Node: Clones633924 +Node: Cut Program635148 +Node: Egrep Program644993 +Ref: Egrep Program-Footnote-1652766 +Node: Id Program652876 +Node: Split Program656492 +Ref: Split Program-Footnote-1660011 +Node: Tee Program660139 +Node: Uniq Program662942 +Node: Wc Program670371 +Ref: Wc Program-Footnote-1674637 +Ref: Wc Program-Footnote-2674837 +Node: Miscellaneous Programs674929 +Node: Dupword Program676117 +Node: Alarm Program678148 +Node: Translate Program682897 +Ref: Translate Program-Footnote-1687284 +Ref: Translate Program-Footnote-2687512 +Node: Labels Program687646 +Ref: Labels Program-Footnote-1691017 +Node: Word Sorting691101 +Node: History Sorting694985 +Node: Extract Program696824 +Ref: Extract Program-Footnote-1704325 +Node: Simple Sed704453 +Node: Igawk Program707515 +Ref: Igawk Program-Footnote-1722672 +Ref: Igawk Program-Footnote-2722873 +Node: Anagram Program723011 +Node: Signature Program726079 +Node: Advanced Features727179 +Node: Nondecimal Data729061 +Node: Array Sorting730644 +Node: Controlling Array Traversal731341 +Node: Array Sorting Functions739579 +Ref: Array Sorting Functions-Footnote-1743253 +Ref: Array Sorting Functions-Footnote-2743346 +Node: Two-way I/O743540 +Ref: Two-way I/O-Footnote-1748972 +Node: TCP/IP Networking749042 +Node: Profiling751886 +Node: Internationalization759383 +Node: I18N and L10N760808 +Node: Explaining gettext761494 +Ref: Explaining gettext-Footnote-1766562 +Ref: Explaining gettext-Footnote-2766746 +Node: Programmer i18n766911 +Node: Translator i18n771113 +Node: String Extraction771906 +Ref: String Extraction-Footnote-1772867 +Node: Printf Ordering772953 +Ref: Printf Ordering-Footnote-1775737 +Node: I18N Portability775801 +Ref: I18N Portability-Footnote-1778250 +Node: I18N Example778313 +Ref: I18N Example-Footnote-1780951 +Node: Gawk I18N781023 +Node: Debugger781644 +Node: Debugging782615 +Node: Debugging Concepts783048 +Node: Debugging Terms784904 +Node: Awk Debugging787501 +Node: Sample Debugging Session788393 +Node: Debugger Invocation788913 +Node: Finding The Bug790245 +Node: List of Debugger Commands796733 +Node: Breakpoint Control798067 +Node: Debugger Execution Control801731 +Node: Viewing And Changing Data805091 +Node: Execution Stack808447 +Node: Debugger Info809914 +Node: Miscellaneous Debugger Commands813896 +Node: Readline Support819072 +Node: Limitations819903 +Node: Arbitrary Precision Arithmetic822155 +Ref: Arbitrary Precision Arithmetic-Footnote-1823806 +Node: General Arithmetic823954 +Node: Floating Point Issues825674 +Node: String Conversion Precision826555 Ref: String Conversion Precision-Footnote-1828260 Node: Unexpected Results828369 Node: POSIX Floating Point Problems830522 diff --git a/doc/gawk.texi b/doc/gawk.texi index b2c675fc..13a823b9 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, @@ -28203,7 +28203,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 8e1f3a97..e1b86c75 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, @@ -27352,7 +27352,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 |