diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 148 |
1 files changed, 135 insertions, 13 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 09f30433..2e542fd9 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -21829,16 +21829,14 @@ operations: in `gawkapi.h'. For correct use, you must therefore include the corresponding standard header file _before_ including `gawkapi.h': - C Entity Header File - ----------------------------- - `FILE' `<stdio.h>' - `NULL' `<stddef.h>' - `malloc()' `<stdlib.h>' - `memset()',`<string.h>' - `memcpy()' - `size_t' `<sys/types.h>' - `struct `<sys/stat.h>' - stat' + C Entity Header File + ------------------------------------------- + `FILE' `<stdio.h>' + `NULL' `<stddef.h>' + `malloc()' `<stdlib.h>' + `memset()', `memcpy()' `<string.h>' + `size_t' `<sys/types.h>' + `struct stat' `<sys/stat.h>' Due to portability concerns, especially to systems that are not fully standards-compliant, it is your responsibility to include @@ -22185,12 +22183,19 @@ Extension functions are described by the following record: The name of the new function. `awk' level code calls the function by this name. This is a regular C string. + Function names must obey the rules for `awk' identifiers. That is, + they must begin with either a letter or an underscore, which may + be followed by any number of letters, digits, and underscores. + `awk_value_t *(*function)(int num_actual_args, awk_value_t *result);' This is a pointer to the C function that provides the desired functionality. The function must fill in the result with either a number or a string. `awk' takes ownership of any string memory. As mentioned earlier, string memory *must* come from `malloc()'. + The `num_actual_args' argument tells the C function how many + actual parameters were passed from the calling `awk' code. + The function must return the value of `result'. This is for the convenience of the calling code inside `gawk'. @@ -25564,8 +25569,9 @@ Various `.c', `.y', and `.h' files does not. `doc/awkforai.txt' - A short article describing why `gawk' is a good language for - Artificial Intelligence (AI) programming. + Pointers to the original draft of a short article describing why + `gawk' is a good language for Artificial Intelligence (AI) + programming. `doc/bc_notes' A brief description of `gawk''s "byte code" internals. @@ -31579,7 +31585,7 @@ Index * testbits.awk program: Bitwise Functions. (line 70) * Texinfo <1>: Adding Code. (line 99) * Texinfo <2>: Distribution contents. - (line 79) + (line 80) * Texinfo <3>: Extract Program. (line 12) * Texinfo <4>: Dupword Program. (line 17) * Texinfo <5>: Library Functions. (line 22) @@ -32726,6 +32732,7 @@ Ref: call-new-function876677 Node: Extension Future Growth878671 Node: Extension API Description879489 Node: Extension API Functions Introduction880817 +<<<<<<< HEAD Node: General Data Types885517 Ref: General Data Types-Footnote-1891119 Node: Requesting Values891418 @@ -32840,5 +32847,120 @@ Node: Copying1120790 Node: GNU Free Documentation License1158347 Node: Index1183484 >>>>>>> master +======= +Node: General Data Types885595 +Ref: General Data Types-Footnote-1891197 +Node: Requesting Values891496 +Ref: table-value-types-returned892227 +Node: Constructor Functions893181 +Node: Registration Functions896177 +Node: Extension Functions896862 +Node: Exit Callback Functions899036 +Node: Extension Version String900279 +Node: Input Parsers900929 +Node: Output Wrappers909516 +Node: Two-way processors913932 +Node: Printing Messages916062 +Ref: Printing Messages-Footnote-1917139 +Node: Updating `ERRNO'917291 +Node: Accessing Parameters918030 +Node: Symbol Table Access919260 +Node: Symbol table by name919772 +Ref: Symbol table by name-Footnote-1921942 +Node: Symbol table by cookie922022 +Ref: Symbol table by cookie-Footnote-1926151 +Node: Cached values926214 +Ref: Cached values-Footnote-1929657 +Node: Array Manipulation929748 +Ref: Array Manipulation-Footnote-1930846 +Node: Array Data Types930885 +Ref: Array Data Types-Footnote-1933588 +Node: Array Functions933680 +Node: Flattening Arrays937446 +Node: Creating Arrays944279 +Node: Extension API Variables949074 +Node: Extension Versioning949710 +Node: Extension API Informational Variables951611 +Node: Extension API Boilerplate952697 +Node: Finding Extensions956528 +Node: Extension Example957075 +Node: Internal File Description957813 +Node: Internal File Ops961501 +Ref: Internal File Ops-Footnote-1972948 +Node: Using Internal File Ops973088 +Ref: Using Internal File Ops-Footnote-1975441 +Node: Extension Samples975707 +Node: Extension Sample File Functions977150 +Node: Extension Sample Fnmatch985623 +Node: Extension Sample Fork987349 +Node: Extension Sample Ord988563 +Node: Extension Sample Readdir989339 +Node: Extension Sample Revout990843 +Node: Extension Sample Rev2way991436 +Node: Extension Sample Read write array992126 +Node: Extension Sample Readfile994009 +Node: Extension Sample API Tests994764 +Node: Extension Sample Time995289 +Node: gawkextlib996596 +Node: Language History998977 +Node: V7/SVR3.11000499 +Node: SVR41002820 +Node: POSIX1004262 +Node: BTL1005270 +Node: POSIX/GNU1006075 +Node: Common Extensions1011610 +Node: Ranges and Locales1012669 +Ref: Ranges and Locales-Footnote-11017287 +Ref: Ranges and Locales-Footnote-21017314 +Ref: Ranges and Locales-Footnote-31017574 +Node: Contributors1017795 +Node: Installation1022091 +Node: Gawk Distribution1022985 +Node: Getting1023469 +Node: Extracting1024295 +Node: Distribution contents1025987 +Node: Unix Installation1031248 +Node: Quick Installation1031865 +Node: Additional Configuration Options1033827 +Node: Configuration Philosophy1035304 +Node: Non-Unix Installation1037646 +Node: PC Installation1038104 +Node: PC Binary Installation1039403 +Node: PC Compiling1041251 +Node: PC Testing1044195 +Node: PC Using1045371 +Node: Cygwin1049556 +Node: MSYS1050556 +Node: VMS Installation1051070 +Node: VMS Compilation1051673 +Ref: VMS Compilation-Footnote-11052680 +Node: VMS Installation Details1052738 +Node: VMS Running1054373 +Node: VMS Old Gawk1055980 +Node: Bugs1056454 +Node: Other Versions1060306 +Node: Notes1065621 +Node: Compatibility Mode1066280 +Node: Additions1067063 +Node: Accessing The Source1067990 +Node: Adding Code1069593 +Node: New Ports1075635 +Node: Derived Files1079770 +Ref: Derived Files-Footnote-11085078 +Ref: Derived Files-Footnote-21085112 +Ref: Derived Files-Footnote-31085712 +Node: Future Extensions1085810 +Node: Implementation Limitations1086391 +Node: Basic Concepts1087618 +Node: Basic High Level1088299 +Ref: figure-general-flow1088570 +Ref: figure-process-flow1089169 +Ref: Basic High Level-Footnote-11092398 +Node: Basic Data Typing1092583 +Node: Glossary1095938 +Node: Copying1121249 +Node: GNU Free Documentation License1158806 +Node: Index1183943 +>>>>>>> master End Tag Table |