diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/gawk.info | 622 | ||||
| -rw-r--r-- | doc/gawk.texi | 24 | ||||
| -rw-r--r-- | doc/gawktexi.in | 24 |
4 files changed, 340 insertions, 335 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 093b25bb..93441078 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2015-02-17 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: A few minor formatting fixes to sync with O'Reilly + version. + 2015-02-13 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: O'Reilly fixes. Through QC1 review. diff --git a/doc/gawk.info b/doc/gawk.info index afdc99b9..d299f965 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -6525,7 +6525,7 @@ which they may appear: messages at runtime. *Note Printf Ordering::, which describes how and why to use positional specifiers. For now, we ignore them. -`- (Minus)' +`-' (Minus) The minus sign, used before the width modifier (see later on in this list), says to left-justify the argument within its specified width. Normally, the argument is printed right-justified in the @@ -6535,7 +6535,7 @@ which they may appear: prints `foo*'. -`SPACE' +SPACE For numeric conversions, prefix positive values with a space and negative values with a minus sign. @@ -6580,7 +6580,7 @@ which they may appear: programs. For information on appropriate quoting tricks, see *note Quoting::. -`WIDTH' +WIDTH This is a number specifying the desired minimum width of a field. Inserting any number between the `%' sign and the format-control character forces the field to expand to this width. The default @@ -23272,14 +23272,14 @@ This node presents them all as function prototypes, in the way that extension code would use them: `static inline awk_value_t *' -`make_const_string(const char *string, size_t length, awk_value_t *result)' +`make_const_string(const char *string, size_t length, awk_value_t *result);' This function creates a string value in the `awk_value_t' variable pointed to by `result'. It expects `string' to be a C string constant (or other string data), and automatically creates a _copy_ of the data for storage in `result'. It returns `result'. `static inline awk_value_t *' -`make_malloced_string(const char *string, size_t length, awk_value_t *result)' +`make_malloced_string(const char *string, size_t length, awk_value_t *result);' This function creates a string value in the `awk_value_t' variable pointed to by `result'. It expects `string' to be a `char *' value pointing to data previously obtained from `gawk_malloc()', @@ -23288,13 +23288,13 @@ extension code would use them: for it. It returns `result'. `static inline awk_value_t *' -`make_null_string(awk_value_t *result)' +`make_null_string(awk_value_t *result);' This specialized function creates a null string (the "undefined" value) in the `awk_value_t' variable pointed to by `result'. It returns `result'. `static inline awk_value_t *' -`make_number(double num, awk_value_t *result)' +`make_number(double num, awk_value_t *result);' This function simply creates a numeric value in the `awk_value_t' variable pointed to by `result'. @@ -34789,310 +34789,310 @@ Node: Printf279722 Node: Basic Printf280507 Node: Control Letters282079 Node: Format Modifiers286064 -Node: Printf Examples292074 -Node: Redirection294560 -Node: Special FD301398 -Ref: Special FD-Footnote-1304564 -Node: Special Files304638 -Node: Other Inherited Files305255 -Node: Special Network306255 -Node: Special Caveats307117 -Node: Close Files And Pipes308066 -Ref: Close Files And Pipes-Footnote-1315257 -Ref: Close Files And Pipes-Footnote-2315405 -Node: Output Summary315555 -Node: Output Exercises316553 -Node: Expressions317233 -Node: Values318422 -Node: Constants319099 -Node: Scalar Constants319790 -Ref: Scalar Constants-Footnote-1320652 -Node: Nondecimal-numbers320902 -Node: Regexp Constants323912 -Node: Using Constant Regexps324438 -Node: Variables327601 -Node: Using Variables328258 -Node: Assignment Options330169 -Node: Conversion332044 -Node: Strings And Numbers332568 -Ref: Strings And Numbers-Footnote-1335633 -Node: Locale influences conversions335742 -Ref: table-locale-affects338488 -Node: All Operators339080 -Node: Arithmetic Ops339709 -Node: Concatenation342214 -Ref: Concatenation-Footnote-1345033 -Node: Assignment Ops345140 -Ref: table-assign-ops350119 -Node: Increment Ops351429 -Node: Truth Values and Conditions354860 -Node: Truth Values355943 -Node: Typing and Comparison356992 -Node: Variable Typing357808 -Node: Comparison Operators361475 -Ref: table-relational-ops361885 -Node: POSIX String Comparison365380 -Ref: POSIX String Comparison-Footnote-1366452 -Node: Boolean Ops366591 -Ref: Boolean Ops-Footnote-1371069 -Node: Conditional Exp371160 -Node: Function Calls372898 -Node: Precedence376778 -Node: Locales380438 -Node: Expressions Summary382070 -Node: Patterns and Actions384641 -Node: Pattern Overview385761 -Node: Regexp Patterns387440 -Node: Expression Patterns387983 -Node: Ranges391763 -Node: BEGIN/END394870 -Node: Using BEGIN/END395631 -Ref: Using BEGIN/END-Footnote-1398367 -Node: I/O And BEGIN/END398473 -Node: BEGINFILE/ENDFILE400788 -Node: Empty403685 -Node: Using Shell Variables404002 -Node: Action Overview406275 -Node: Statements408601 -Node: If Statement410449 -Node: While Statement411944 -Node: Do Statement413972 -Node: For Statement415120 -Node: Switch Statement418278 -Node: Break Statement420660 -Node: Continue Statement422701 -Node: Next Statement424528 -Node: Nextfile Statement426909 -Node: Exit Statement429537 -Node: Built-in Variables431948 -Node: User-modified433081 -Ref: User-modified-Footnote-1440784 -Node: Auto-set440846 -Ref: Auto-set-Footnote-1454555 -Ref: Auto-set-Footnote-2454760 -Node: ARGC and ARGV454816 -Node: Pattern Action Summary459034 -Node: Arrays461467 -Node: Array Basics462796 -Node: Array Intro463640 -Ref: figure-array-elements465574 -Ref: Array Intro-Footnote-1468194 -Node: Reference to Elements468322 -Node: Assigning Elements470784 -Node: Array Example471275 -Node: Scanning an Array473034 -Node: Controlling Scanning476054 -Ref: Controlling Scanning-Footnote-1481448 -Node: Numeric Array Subscripts481764 -Node: Uninitialized Subscripts483949 -Node: Delete485566 -Ref: Delete-Footnote-1488315 -Node: Multidimensional488372 -Node: Multiscanning491469 -Node: Arrays of Arrays493058 -Node: Arrays Summary497812 -Node: Functions499903 -Node: Built-in500942 -Node: Calling Built-in502020 -Node: Numeric Functions504015 -Ref: Numeric Functions-Footnote-1508833 -Ref: Numeric Functions-Footnote-2509190 -Ref: Numeric Functions-Footnote-3509238 -Node: String Functions509510 -Ref: String Functions-Footnote-1533011 -Ref: String Functions-Footnote-2533140 -Ref: String Functions-Footnote-3533388 -Node: Gory Details533475 -Ref: table-sub-escapes535256 -Ref: table-sub-proposed536771 -Ref: table-posix-sub538133 -Ref: table-gensub-escapes539670 -Ref: Gory Details-Footnote-1540503 -Node: I/O Functions540654 -Ref: I/O Functions-Footnote-1547890 -Node: Time Functions548037 -Ref: Time Functions-Footnote-1558546 -Ref: Time Functions-Footnote-2558614 -Ref: Time Functions-Footnote-3558772 -Ref: Time Functions-Footnote-4558883 -Ref: Time Functions-Footnote-5558995 -Ref: Time Functions-Footnote-6559222 -Node: Bitwise Functions559488 -Ref: table-bitwise-ops560050 -Ref: Bitwise Functions-Footnote-1564378 -Node: Type Functions564550 -Node: I18N Functions565702 -Node: User-defined567349 -Node: Definition Syntax568154 -Ref: Definition Syntax-Footnote-1573813 -Node: Function Example573884 -Ref: Function Example-Footnote-1576805 -Node: Function Caveats576827 -Node: Calling A Function577345 -Node: Variable Scope578303 -Node: Pass By Value/Reference581296 -Node: Return Statement584793 -Node: Dynamic Typing587772 -Node: Indirect Calls588701 -Ref: Indirect Calls-Footnote-1600007 -Node: Functions Summary600135 -Node: Library Functions602837 -Ref: Library Functions-Footnote-1606445 -Ref: Library Functions-Footnote-2606588 -Node: Library Names606759 -Ref: Library Names-Footnote-1610217 -Ref: Library Names-Footnote-2610440 -Node: General Functions610526 -Node: Strtonum Function611629 -Node: Assert Function614651 -Node: Round Function617975 -Node: Cliff Random Function619516 -Node: Ordinal Functions620532 -Ref: Ordinal Functions-Footnote-1623595 -Ref: Ordinal Functions-Footnote-2623847 -Node: Join Function624058 -Ref: Join Function-Footnote-1625828 -Node: Getlocaltime Function626028 -Node: Readfile Function629772 -Node: Shell Quoting631744 -Node: Data File Management633145 -Node: Filetrans Function633777 -Node: Rewind Function637873 -Node: File Checking639259 -Ref: File Checking-Footnote-1640592 -Node: Empty Files640793 -Node: Ignoring Assigns642772 -Node: Getopt Function644322 -Ref: Getopt Function-Footnote-1655786 -Node: Passwd Functions655986 -Ref: Passwd Functions-Footnote-1664826 -Node: Group Functions664914 -Ref: Group Functions-Footnote-1672811 -Node: Walking Arrays673016 -Node: Library Functions Summary674616 -Node: Library Exercises676020 -Node: Sample Programs677300 -Node: Running Examples678070 -Node: Clones678798 -Node: Cut Program680022 -Node: Egrep Program689742 -Ref: Egrep Program-Footnote-1697245 -Node: Id Program697355 -Node: Split Program701031 -Ref: Split Program-Footnote-1704485 -Node: Tee Program704613 -Node: Uniq Program707402 -Node: Wc Program714821 -Ref: Wc Program-Footnote-1719071 -Node: Miscellaneous Programs719165 -Node: Dupword Program720378 -Node: Alarm Program722409 -Node: Translate Program727214 -Ref: Translate Program-Footnote-1731777 -Node: Labels Program732047 -Ref: Labels Program-Footnote-1735398 -Node: Word Sorting735482 -Node: History Sorting739552 -Node: Extract Program741387 -Node: Simple Sed748911 -Node: Igawk Program751981 -Ref: Igawk Program-Footnote-1766307 -Ref: Igawk Program-Footnote-2766508 -Ref: Igawk Program-Footnote-3766630 -Node: Anagram Program766745 -Node: Signature Program769806 -Node: Programs Summary771053 -Node: Programs Exercises772274 -Ref: Programs Exercises-Footnote-1776405 -Node: Advanced Features776496 -Node: Nondecimal Data778478 -Node: Array Sorting780068 -Node: Controlling Array Traversal780768 -Ref: Controlling Array Traversal-Footnote-1789134 -Node: Array Sorting Functions789252 -Ref: Array Sorting Functions-Footnote-1793138 -Node: Two-way I/O793334 -Ref: Two-way I/O-Footnote-1798279 -Ref: Two-way I/O-Footnote-2798465 -Node: TCP/IP Networking798547 -Node: Profiling801419 -Node: Advanced Features Summary809690 -Node: Internationalization811623 -Node: I18N and L10N813103 -Node: Explaining gettext813789 -Ref: Explaining gettext-Footnote-1818814 -Ref: Explaining gettext-Footnote-2818998 -Node: Programmer i18n819163 -Ref: Programmer i18n-Footnote-1824039 -Node: Translator i18n824088 -Node: String Extraction824882 -Ref: String Extraction-Footnote-1826013 -Node: Printf Ordering826099 -Ref: Printf Ordering-Footnote-1828885 -Node: I18N Portability828949 -Ref: I18N Portability-Footnote-1831405 -Node: I18N Example831468 -Ref: I18N Example-Footnote-1834271 -Node: Gawk I18N834343 -Node: I18N Summary834987 -Node: Debugger836327 -Node: Debugging837349 -Node: Debugging Concepts837790 -Node: Debugging Terms839600 -Node: Awk Debugging842172 -Node: Sample Debugging Session843078 -Node: Debugger Invocation843612 -Node: Finding The Bug844997 -Node: List of Debugger Commands851476 -Node: Breakpoint Control852808 -Node: Debugger Execution Control856485 -Node: Viewing And Changing Data859844 -Node: Execution Stack863220 -Node: Debugger Info864855 -Node: Miscellaneous Debugger Commands868900 -Node: Readline Support873901 -Node: Limitations874795 -Node: Debugging Summary876910 -Node: Arbitrary Precision Arithmetic878084 -Node: Computer Arithmetic879500 -Ref: table-numeric-ranges883099 -Ref: Computer Arithmetic-Footnote-1883623 -Node: Math Definitions883680 -Ref: table-ieee-formats886975 -Ref: Math Definitions-Footnote-1887579 -Node: MPFR features887684 -Node: FP Math Caution889355 -Ref: FP Math Caution-Footnote-1890405 -Node: Inexactness of computations890774 -Node: Inexact representation891733 -Node: Comparing FP Values893091 -Node: Errors accumulate894173 -Node: Getting Accuracy895605 -Node: Try To Round898309 -Node: Setting precision899208 -Ref: table-predefined-precision-strings899892 -Node: Setting the rounding mode901721 -Ref: table-gawk-rounding-modes902085 -Ref: Setting the rounding mode-Footnote-1905537 -Node: Arbitrary Precision Integers905716 -Ref: Arbitrary Precision Integers-Footnote-1910614 -Node: POSIX Floating Point Problems910763 -Ref: POSIX Floating Point Problems-Footnote-1914642 -Node: Floating point summary914680 -Node: Dynamic Extensions916876 -Node: Extension Intro918428 -Node: Plugin License919693 -Node: Extension Mechanism Outline920490 -Ref: figure-load-extension920918 -Ref: figure-register-new-function922398 -Ref: figure-call-new-function923402 -Node: Extension API Description925389 -Node: Extension API Functions Introduction926839 -Node: General Data Types931660 -Ref: General Data Types-Footnote-1937560 -Node: Memory Allocation Functions937859 -Ref: Memory Allocation Functions-Footnote-1940698 -Node: Constructor Functions940797 +Node: Printf Examples292070 +Node: Redirection294556 +Node: Special FD301394 +Ref: Special FD-Footnote-1304560 +Node: Special Files304634 +Node: Other Inherited Files305251 +Node: Special Network306251 +Node: Special Caveats307113 +Node: Close Files And Pipes308062 +Ref: Close Files And Pipes-Footnote-1315253 +Ref: Close Files And Pipes-Footnote-2315401 +Node: Output Summary315551 +Node: Output Exercises316549 +Node: Expressions317229 +Node: Values318418 +Node: Constants319095 +Node: Scalar Constants319786 +Ref: Scalar Constants-Footnote-1320648 +Node: Nondecimal-numbers320898 +Node: Regexp Constants323908 +Node: Using Constant Regexps324434 +Node: Variables327597 +Node: Using Variables328254 +Node: Assignment Options330165 +Node: Conversion332040 +Node: Strings And Numbers332564 +Ref: Strings And Numbers-Footnote-1335629 +Node: Locale influences conversions335738 +Ref: table-locale-affects338484 +Node: All Operators339076 +Node: Arithmetic Ops339705 +Node: Concatenation342210 +Ref: Concatenation-Footnote-1345029 +Node: Assignment Ops345136 +Ref: table-assign-ops350115 +Node: Increment Ops351425 +Node: Truth Values and Conditions354856 +Node: Truth Values355939 +Node: Typing and Comparison356988 +Node: Variable Typing357804 +Node: Comparison Operators361471 +Ref: table-relational-ops361881 +Node: POSIX String Comparison365376 +Ref: POSIX String Comparison-Footnote-1366448 +Node: Boolean Ops366587 +Ref: Boolean Ops-Footnote-1371065 +Node: Conditional Exp371156 +Node: Function Calls372894 +Node: Precedence376774 +Node: Locales380434 +Node: Expressions Summary382066 +Node: Patterns and Actions384637 +Node: Pattern Overview385757 +Node: Regexp Patterns387436 +Node: Expression Patterns387979 +Node: Ranges391759 +Node: BEGIN/END394866 +Node: Using BEGIN/END395627 +Ref: Using BEGIN/END-Footnote-1398363 +Node: I/O And BEGIN/END398469 +Node: BEGINFILE/ENDFILE400784 +Node: Empty403681 +Node: Using Shell Variables403998 +Node: Action Overview406271 +Node: Statements408597 +Node: If Statement410445 +Node: While Statement411940 +Node: Do Statement413968 +Node: For Statement415116 +Node: Switch Statement418274 +Node: Break Statement420656 +Node: Continue Statement422697 +Node: Next Statement424524 +Node: Nextfile Statement426905 +Node: Exit Statement429533 +Node: Built-in Variables431944 +Node: User-modified433077 +Ref: User-modified-Footnote-1440780 +Node: Auto-set440842 +Ref: Auto-set-Footnote-1454551 +Ref: Auto-set-Footnote-2454756 +Node: ARGC and ARGV454812 +Node: Pattern Action Summary459030 +Node: Arrays461463 +Node: Array Basics462792 +Node: Array Intro463636 +Ref: figure-array-elements465570 +Ref: Array Intro-Footnote-1468190 +Node: Reference to Elements468318 +Node: Assigning Elements470780 +Node: Array Example471271 +Node: Scanning an Array473030 +Node: Controlling Scanning476050 +Ref: Controlling Scanning-Footnote-1481444 +Node: Numeric Array Subscripts481760 +Node: Uninitialized Subscripts483945 +Node: Delete485562 +Ref: Delete-Footnote-1488311 +Node: Multidimensional488368 +Node: Multiscanning491465 +Node: Arrays of Arrays493054 +Node: Arrays Summary497808 +Node: Functions499899 +Node: Built-in500938 +Node: Calling Built-in502016 +Node: Numeric Functions504011 +Ref: Numeric Functions-Footnote-1508829 +Ref: Numeric Functions-Footnote-2509186 +Ref: Numeric Functions-Footnote-3509234 +Node: String Functions509506 +Ref: String Functions-Footnote-1533007 +Ref: String Functions-Footnote-2533136 +Ref: String Functions-Footnote-3533384 +Node: Gory Details533471 +Ref: table-sub-escapes535252 +Ref: table-sub-proposed536767 +Ref: table-posix-sub538129 +Ref: table-gensub-escapes539666 +Ref: Gory Details-Footnote-1540499 +Node: I/O Functions540650 +Ref: I/O Functions-Footnote-1547886 +Node: Time Functions548033 +Ref: Time Functions-Footnote-1558542 +Ref: Time Functions-Footnote-2558610 +Ref: Time Functions-Footnote-3558768 +Ref: Time Functions-Footnote-4558879 +Ref: Time Functions-Footnote-5558991 +Ref: Time Functions-Footnote-6559218 +Node: Bitwise Functions559484 +Ref: table-bitwise-ops560046 +Ref: Bitwise Functions-Footnote-1564374 +Node: Type Functions564546 +Node: I18N Functions565698 +Node: User-defined567345 +Node: Definition Syntax568150 +Ref: Definition Syntax-Footnote-1573809 +Node: Function Example573880 +Ref: Function Example-Footnote-1576801 +Node: Function Caveats576823 +Node: Calling A Function577341 +Node: Variable Scope578299 +Node: Pass By Value/Reference581292 +Node: Return Statement584789 +Node: Dynamic Typing587768 +Node: Indirect Calls588697 +Ref: Indirect Calls-Footnote-1600003 +Node: Functions Summary600131 +Node: Library Functions602833 +Ref: Library Functions-Footnote-1606441 +Ref: Library Functions-Footnote-2606584 +Node: Library Names606755 +Ref: Library Names-Footnote-1610213 +Ref: Library Names-Footnote-2610436 +Node: General Functions610522 +Node: Strtonum Function611625 +Node: Assert Function614647 +Node: Round Function617971 +Node: Cliff Random Function619512 +Node: Ordinal Functions620528 +Ref: Ordinal Functions-Footnote-1623591 +Ref: Ordinal Functions-Footnote-2623843 +Node: Join Function624054 +Ref: Join Function-Footnote-1625824 +Node: Getlocaltime Function626024 +Node: Readfile Function629768 +Node: Shell Quoting631740 +Node: Data File Management633141 +Node: Filetrans Function633773 +Node: Rewind Function637869 +Node: File Checking639255 +Ref: File Checking-Footnote-1640588 +Node: Empty Files640789 +Node: Ignoring Assigns642768 +Node: Getopt Function644318 +Ref: Getopt Function-Footnote-1655782 +Node: Passwd Functions655982 +Ref: Passwd Functions-Footnote-1664822 +Node: Group Functions664910 +Ref: Group Functions-Footnote-1672807 +Node: Walking Arrays673012 +Node: Library Functions Summary674612 +Node: Library Exercises676016 +Node: Sample Programs677296 +Node: Running Examples678066 +Node: Clones678794 +Node: Cut Program680018 +Node: Egrep Program689738 +Ref: Egrep Program-Footnote-1697241 +Node: Id Program697351 +Node: Split Program701027 +Ref: Split Program-Footnote-1704481 +Node: Tee Program704609 +Node: Uniq Program707398 +Node: Wc Program714817 +Ref: Wc Program-Footnote-1719067 +Node: Miscellaneous Programs719161 +Node: Dupword Program720374 +Node: Alarm Program722405 +Node: Translate Program727210 +Ref: Translate Program-Footnote-1731773 +Node: Labels Program732043 +Ref: Labels Program-Footnote-1735394 +Node: Word Sorting735478 +Node: History Sorting739548 +Node: Extract Program741383 +Node: Simple Sed748907 +Node: Igawk Program751977 +Ref: Igawk Program-Footnote-1766303 +Ref: Igawk Program-Footnote-2766504 +Ref: Igawk Program-Footnote-3766626 +Node: Anagram Program766741 +Node: Signature Program769802 +Node: Programs Summary771049 +Node: Programs Exercises772270 +Ref: Programs Exercises-Footnote-1776401 +Node: Advanced Features776492 +Node: Nondecimal Data778474 +Node: Array Sorting780064 +Node: Controlling Array Traversal780764 +Ref: Controlling Array Traversal-Footnote-1789130 +Node: Array Sorting Functions789248 +Ref: Array Sorting Functions-Footnote-1793134 +Node: Two-way I/O793330 +Ref: Two-way I/O-Footnote-1798275 +Ref: Two-way I/O-Footnote-2798461 +Node: TCP/IP Networking798543 +Node: Profiling801415 +Node: Advanced Features Summary809686 +Node: Internationalization811619 +Node: I18N and L10N813099 +Node: Explaining gettext813785 +Ref: Explaining gettext-Footnote-1818810 +Ref: Explaining gettext-Footnote-2818994 +Node: Programmer i18n819159 +Ref: Programmer i18n-Footnote-1824035 +Node: Translator i18n824084 +Node: String Extraction824878 +Ref: String Extraction-Footnote-1826009 +Node: Printf Ordering826095 +Ref: Printf Ordering-Footnote-1828881 +Node: I18N Portability828945 +Ref: I18N Portability-Footnote-1831401 +Node: I18N Example831464 +Ref: I18N Example-Footnote-1834267 +Node: Gawk I18N834339 +Node: I18N Summary834983 +Node: Debugger836323 +Node: Debugging837345 +Node: Debugging Concepts837786 +Node: Debugging Terms839596 +Node: Awk Debugging842168 +Node: Sample Debugging Session843074 +Node: Debugger Invocation843608 +Node: Finding The Bug844993 +Node: List of Debugger Commands851472 +Node: Breakpoint Control852804 +Node: Debugger Execution Control856481 +Node: Viewing And Changing Data859840 +Node: Execution Stack863216 +Node: Debugger Info864851 +Node: Miscellaneous Debugger Commands868896 +Node: Readline Support873897 +Node: Limitations874791 +Node: Debugging Summary876906 +Node: Arbitrary Precision Arithmetic878080 +Node: Computer Arithmetic879496 +Ref: table-numeric-ranges883095 +Ref: Computer Arithmetic-Footnote-1883619 +Node: Math Definitions883676 +Ref: table-ieee-formats886971 +Ref: Math Definitions-Footnote-1887575 +Node: MPFR features887680 +Node: FP Math Caution889351 +Ref: FP Math Caution-Footnote-1890401 +Node: Inexactness of computations890770 +Node: Inexact representation891729 +Node: Comparing FP Values893087 +Node: Errors accumulate894169 +Node: Getting Accuracy895601 +Node: Try To Round898305 +Node: Setting precision899204 +Ref: table-predefined-precision-strings899888 +Node: Setting the rounding mode901717 +Ref: table-gawk-rounding-modes902081 +Ref: Setting the rounding mode-Footnote-1905533 +Node: Arbitrary Precision Integers905712 +Ref: Arbitrary Precision Integers-Footnote-1910610 +Node: POSIX Floating Point Problems910759 +Ref: POSIX Floating Point Problems-Footnote-1914638 +Node: Floating point summary914676 +Node: Dynamic Extensions916872 +Node: Extension Intro918424 +Node: Plugin License919689 +Node: Extension Mechanism Outline920486 +Ref: figure-load-extension920914 +Ref: figure-register-new-function922394 +Ref: figure-call-new-function923398 +Node: Extension API Description925385 +Node: Extension API Functions Introduction926835 +Node: General Data Types931656 +Ref: General Data Types-Footnote-1937556 +Node: Memory Allocation Functions937855 +Ref: Memory Allocation Functions-Footnote-1940694 +Node: Constructor Functions940793 Node: Registration Functions942532 Node: Extension Functions943217 Node: Exit Callback Functions945514 diff --git a/doc/gawk.texi b/doc/gawk.texi index 7136a7de..f603ca52 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -9407,12 +9407,12 @@ represent spaces in the output. Here are the possible modifiers, in the order in which they may appear: -@table @code +@table @asis @cindex differences in @command{awk} and @command{gawk}, @code{print}/@code{printf} statements @cindex @code{printf} statement, positional specifiers @c the code{} does NOT start a secondary @cindex positional specifiers, @code{printf} statement -@item @var{N}$ +@item @code{@var{N}$} An integer constant followed by a @samp{$} is a @dfn{positional specifier}. Normally, format specifications are applied to arguments in the order given in the format string. With a positional specifier, the format @@ -9435,7 +9435,7 @@ messages at runtime. which describes how and why to use positional specifiers. For now, we ignore them. -@item - @r{(Minus)} +@item @code{-} (Minus) The minus sign, used before the width modifier (see later on in this list), says to left-justify @@ -9453,13 +9453,13 @@ prints @samp{foo@bullet{}}. For numeric conversions, prefix positive values with a space and negative values with a minus sign. -@item + +@item @code{+} The plus sign, used before the width modifier (see later on in this list), says to always supply a sign for numeric conversions, even if the data to format is positive. The @samp{+} overrides the space modifier. -@item # +@item @code{#} Use an ``alternative form'' for certain control letters. For @samp{%o}, supply a leading zero. For @samp{%x} and @samp{%X}, supply a leading @samp{0x} or @samp{0X} for @@ -9468,14 +9468,14 @@ For @samp{%e}, @samp{%E}, @samp{%f}, and @samp{%F}, the result always contains a decimal point. For @samp{%g} and @samp{%G}, trailing zeros are not removed from the result. -@item 0 +@item @code{0} A leading @samp{0} (zero) acts as a flag indicating that output should be padded with zeros instead of spaces. This applies only to the numeric output formats. This flag only has an effect when the field width is wider than the value to print. -@item ' +@item @code{'} A single quote or apostrophe character is a POSIX extension to ISO C. It indicates that the integer part of a floating-point value, or the entire part of an integer decimal value, should have a thousands-separator @@ -9528,7 +9528,7 @@ prints @samp{foobar}. Preceding the @var{width} with a minus sign causes the output to be padded with spaces on the right, instead of on the left. -@item .@var{prec} +@item @code{.@var{prec}} A period followed by an integer constant specifies the precision to use when printing. The meaning of the precision varies by control letter: @@ -31893,14 +31893,14 @@ the way that extension code would use them: @table @code @item static inline awk_value_t * -@itemx make_const_string(const char *string, size_t length, awk_value_t *result) +@itemx make_const_string(const char *string, size_t length, awk_value_t *result); This function creates a string value in the @code{awk_value_t} variable pointed to by @code{result}. It expects @code{string} to be a C string constant (or other string data), and automatically creates a @emph{copy} of the data for storage in @code{result}. It returns @code{result}. @item static inline awk_value_t * -@itemx make_malloced_string(const char *string, size_t length, awk_value_t *result) +@itemx make_malloced_string(const char *string, size_t length, awk_value_t *result); This function creates a string value in the @code{awk_value_t} variable pointed to by @code{result}. It expects @code{string} to be a @samp{char *} value pointing to data previously obtained from @code{gawk_malloc()}, @code{gawk_calloc()}, or @code{gawk_realloc()}. The idea here @@ -31908,13 +31908,13 @@ is that the data is passed directly to @command{gawk}, which assumes responsibility for it. It returns @code{result}. @item static inline awk_value_t * -@itemx make_null_string(awk_value_t *result) +@itemx make_null_string(awk_value_t *result); This specialized function creates a null string (the ``undefined'' value) in the @code{awk_value_t} variable pointed to by @code{result}. It returns @code{result}. @item static inline awk_value_t * -@itemx make_number(double num, awk_value_t *result) +@itemx make_number(double num, awk_value_t *result); This function simply creates a numeric value in the @code{awk_value_t} variable pointed to by @code{result}. @end table diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 1e3a7c83..accb1a2a 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -9007,12 +9007,12 @@ represent spaces in the output. Here are the possible modifiers, in the order in which they may appear: -@table @code +@table @asis @cindex differences in @command{awk} and @command{gawk}, @code{print}/@code{printf} statements @cindex @code{printf} statement, positional specifiers @c the code{} does NOT start a secondary @cindex positional specifiers, @code{printf} statement -@item @var{N}$ +@item @code{@var{N}$} An integer constant followed by a @samp{$} is a @dfn{positional specifier}. Normally, format specifications are applied to arguments in the order given in the format string. With a positional specifier, the format @@ -9035,7 +9035,7 @@ messages at runtime. which describes how and why to use positional specifiers. For now, we ignore them. -@item - @r{(Minus)} +@item @code{-} (Minus) The minus sign, used before the width modifier (see later on in this list), says to left-justify @@ -9053,13 +9053,13 @@ prints @samp{foo@bullet{}}. For numeric conversions, prefix positive values with a space and negative values with a minus sign. -@item + +@item @code{+} The plus sign, used before the width modifier (see later on in this list), says to always supply a sign for numeric conversions, even if the data to format is positive. The @samp{+} overrides the space modifier. -@item # +@item @code{#} Use an ``alternative form'' for certain control letters. For @samp{%o}, supply a leading zero. For @samp{%x} and @samp{%X}, supply a leading @samp{0x} or @samp{0X} for @@ -9068,14 +9068,14 @@ For @samp{%e}, @samp{%E}, @samp{%f}, and @samp{%F}, the result always contains a decimal point. For @samp{%g} and @samp{%G}, trailing zeros are not removed from the result. -@item 0 +@item @code{0} A leading @samp{0} (zero) acts as a flag indicating that output should be padded with zeros instead of spaces. This applies only to the numeric output formats. This flag only has an effect when the field width is wider than the value to print. -@item ' +@item @code{'} A single quote or apostrophe character is a POSIX extension to ISO C. It indicates that the integer part of a floating-point value, or the entire part of an integer decimal value, should have a thousands-separator @@ -9128,7 +9128,7 @@ prints @samp{foobar}. Preceding the @var{width} with a minus sign causes the output to be padded with spaces on the right, instead of on the left. -@item .@var{prec} +@item @code{.@var{prec}} A period followed by an integer constant specifies the precision to use when printing. The meaning of the precision varies by control letter: @@ -30984,14 +30984,14 @@ the way that extension code would use them: @table @code @item static inline awk_value_t * -@itemx make_const_string(const char *string, size_t length, awk_value_t *result) +@itemx make_const_string(const char *string, size_t length, awk_value_t *result); This function creates a string value in the @code{awk_value_t} variable pointed to by @code{result}. It expects @code{string} to be a C string constant (or other string data), and automatically creates a @emph{copy} of the data for storage in @code{result}. It returns @code{result}. @item static inline awk_value_t * -@itemx make_malloced_string(const char *string, size_t length, awk_value_t *result) +@itemx make_malloced_string(const char *string, size_t length, awk_value_t *result); This function creates a string value in the @code{awk_value_t} variable pointed to by @code{result}. It expects @code{string} to be a @samp{char *} value pointing to data previously obtained from @code{gawk_malloc()}, @code{gawk_calloc()}, or @code{gawk_realloc()}. The idea here @@ -30999,13 +30999,13 @@ is that the data is passed directly to @command{gawk}, which assumes responsibility for it. It returns @code{result}. @item static inline awk_value_t * -@itemx make_null_string(awk_value_t *result) +@itemx make_null_string(awk_value_t *result); This specialized function creates a null string (the ``undefined'' value) in the @code{awk_value_t} variable pointed to by @code{result}. It returns @code{result}. @item static inline awk_value_t * -@itemx make_number(double num, awk_value_t *result) +@itemx make_number(double num, awk_value_t *result); This function simply creates a numeric value in the @code{awk_value_t} variable pointed to by @code{result}. @end table |